> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /autoscout24/listings/search

> Search AutoScout24 car listings with the full filter set: make/model, article type, seller countries, postal code and radius, condition (new/used/demo/...), body type, fuel type, transmission, drivetrain, price range and price type, registration year range, mileage range, power range, seller type, seats and doors, cylinders, equipment, condition requirements, exterior and interior colors, paint and upholstery, emission class, online-since, previous owners and free-text keyword. Sort by best match, price, registration, mileage or power. Returns listing cards with price, vehicle summary, location and seller.

**Price:** 20 credits per 20 results

**💡 AI Hint:** Search AutoScout24 car listings. make/model are slugs (e.g. make='bmw', model='x5'). Filter by countries (DE/AT/IT/BE/NL/ES/FR/LU), zip+radius_km, conditions, body_types, fuel_types, transmissions, drivetrains, price_from/price_to (EUR), registration_year_from/to, mileage_from/to (km), power_from/to (with power_unit kw or hp), seller_type, seats/doors, cylinders, equipment, exterior/interior colors, paint/upholstery, emission_class_from, online_since_days, previous_owners_to, keyword. Sort by best/price/first_registration/mileage/power with descending flag. count is required.



## OpenAPI

````yaml /openapi-filtered.json post /api/autoscout24/listings/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/autoscout24/listings/search:
    post:
      tags:
        - /autoscout24
      summary: /autoscout24/listings/search
      description: >-
        Search AutoScout24 car listings with the full filter set: make/model,
        article type, seller countries, postal code and radius, condition
        (new/used/demo/...), body type, fuel type, transmission, drivetrain,
        price range and price type, registration year range, mileage range,
        power range, seller type, seats and doors, cylinders, equipment,
        condition requirements, exterior and interior colors, paint and
        upholstery, emission class, online-since, previous owners and free-text
        keyword. Sort by best match, price, registration, mileage or power.
        Returns listing cards with price, vehicle summary, location and seller.


        **Price:** 20 credits per 20 results


        **💡 AI Hint:** Search AutoScout24 car listings. make/model are slugs
        (e.g. make='bmw', model='x5'). Filter by countries
        (DE/AT/IT/BE/NL/ES/FR/LU), zip+radius_km, conditions, body_types,
        fuel_types, transmissions, drivetrains, price_from/price_to (EUR),
        registration_year_from/to, mileage_from/to (km), power_from/to (with
        power_unit kw or hp), seller_type, seats/doors, cylinders, equipment,
        exterior/interior colors, paint/upholstery, emission_class_from,
        online_since_days, previous_owners_to, keyword. Sort by
        best/price/first_registration/mileage/power with descending flag. count
        is required.
      operationId: __api_autoscout24_listings_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AutoScout24ListingsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AutoScout24Listing'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AutoScout24ListingsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          description: Max scrapping execution timeout (in seconds)
          default: 300
        make:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          description: Make slug (e.g. 'bmw', 'audi', 'mercedes-benz')
        model:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          description: Model slug (e.g. 'a4', 'x5'); requires make to be set
        article_type:
          $ref: '#/components/schemas/AutoScout24ArticleType'
          description: Vehicle article type
          default: C
        countries:
          items:
            $ref: '#/components/schemas/AutoScout24Country'
          type: array
          description: Seller countries (empty = all of Europe)
          default: []
        zip:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          description: Postal code to search around
        radius_km:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          description: Search radius around the postal code, in km
        conditions:
          items:
            $ref: '#/components/schemas/AutoScout24OfferCondition'
          type: array
          description: Vehicle conditions (new, used, demo, ...)
          default: []
        body_types:
          items:
            $ref: '#/components/schemas/AutoScout24BodyType'
          type: array
          description: Body types to include
          default: []
        fuel_types:
          items:
            $ref: '#/components/schemas/AutoScout24FuelType'
          type: array
          description: Fuel types to include
          default: []
        transmissions:
          items:
            $ref: '#/components/schemas/AutoScout24Transmission'
          type: array
          description: Transmission types to include
          default: []
        drivetrains:
          items:
            $ref: '#/components/schemas/AutoScout24Drivetrain'
          type: array
          description: Drivetrain types to include
          default: []
        price_from:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Minimum price (EUR)
        price_to:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Maximum price (EUR)
        price_type:
          anyOf:
            - $ref: '#/components/schemas/AutoScout24PriceType'
            - type: 'null'
          description: Whether price is private or dealer price
        registration_year_from:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
          description: Minimum first registration year
        registration_year_to:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
          description: Maximum first registration year
        mileage_from:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Minimum mileage (km)
        mileage_to:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Maximum mileage (km)
        power_unit:
          $ref: '#/components/schemas/AutoScout24PowerUnit'
          description: Unit for power_from/power_to
          default: kw
        power_from:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Minimum engine power (in power_unit)
        power_to:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Maximum engine power (in power_unit)
        seller_type:
          anyOf:
            - $ref: '#/components/schemas/AutoScout24SellerType'
            - type: 'null'
          description: Seller type (dealer or private)
        seats_from:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          description: Minimum number of seats
        seats_to:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          description: Maximum number of seats
        doors_from:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          description: Minimum number of doors
        doors_to:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          description: Maximum number of doors
        cylinders:
          anyOf:
            - $ref: '#/components/schemas/AutoScout24Cylinders'
            - type: 'null'
          description: Number of cylinders
        equipment:
          items:
            $ref: '#/components/schemas/AutoScout24Equipment'
          type: array
          description: Required equipment/options
          default: []
        conditions_equipment:
          items:
            $ref: '#/components/schemas/AutoScout24Condition'
          type: array
          description: Condition requirements (guarantee, full service history, ...)
          default: []
        exterior_colors:
          items:
            $ref: '#/components/schemas/AutoScout24BodyColor'
          type: array
          description: Exterior colors to include
          default: []
        interior_colors:
          items:
            $ref: '#/components/schemas/AutoScout24InteriorColor'
          type: array
          description: Interior colors to include
          default: []
        paint_types:
          items:
            $ref: '#/components/schemas/AutoScout24BodyPainting'
          type: array
          description: Paint types to include
          default: []
        upholstery_types:
          items:
            $ref: '#/components/schemas/AutoScout24Upholstery'
          type: array
          description: Upholstery types to include
          default: []
        emission_class_from:
          anyOf:
            - type: integer
              maximum: 6
              minimum: 1
            - type: 'null'
          description: Minimum Euro emission class (1-6)
        emission_sticker_min:
          anyOf:
            - $ref: '#/components/schemas/AutoScout24EmissionSticker'
            - type: 'null'
          description: Minimum environmental (emission) sticker
        online_since_days:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          description: Only listings online within the last N days
        previous_owners_to:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          description: Maximum number of previous owners
        keyword:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          description: Free-text keyword search in the listing
        sort:
          $ref: '#/components/schemas/AutoScout24Sort'
          description: Sort order
          default: standard
        descending:
          type: boolean
          description: Sort descending instead of ascending
          default: false
        count:
          type: integer
          minimum: 1
          description: Max number of results to return
      type: object
      required:
        - count
    AutoScout24Listing:
      properties:
        '@type':
          type: string
          default: AutoScout24Listing
        id:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
        make:
          anyOf:
            - type: string
            - type: 'null'
        model:
          anyOf:
            - type: string
            - type: 'null'
        model_group:
          anyOf:
            - type: string
            - type: 'null'
        variant:
          anyOf:
            - type: string
            - type: 'null'
        model_version:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: number
            - type: 'null'
        mileage_km:
          anyOf:
            - type: integer
            - type: 'null'
        first_registration:
          anyOf:
            - type: string
            - type: 'null'
        power_kw:
          anyOf:
            - type: integer
            - type: 'null'
        power_hp:
          anyOf:
            - type: integer
            - type: 'null'
        fuel:
          anyOf:
            - type: string
            - type: 'null'
        transmission:
          anyOf:
            - type: string
            - type: 'null'
        body_type:
          anyOf:
            - type: string
            - type: 'null'
        displacement_cc:
          anyOf:
            - type: integer
            - type: 'null'
        offer_type:
          anyOf:
            - type: string
            - type: 'null'
        is_new:
          type: boolean
          default: false
        is_damaged:
          type: boolean
          default: false
        image:
          anyOf:
            - type: string
            - type: 'null'
        images:
          items:
            type: string
          type: array
          default: []
        location:
          anyOf:
            - $ref: '#/components/schemas/AutoScout24Location'
            - type: 'null'
        seller:
          anyOf:
            - $ref: '#/components/schemas/AutoScout24Seller'
            - type: 'null'
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    AutoScout24ArticleType:
      type: string
      enum:
        - C
        - B
        - 'N'
        - X
        - L
    AutoScout24Country:
      type: string
      enum:
        - A
        - B
        - D
        - E
        - F
        - I
        - L
        - NL
    AutoScout24OfferCondition:
      type: string
      enum:
        - 'N'
        - U
        - J
        - O
        - D
        - S
    AutoScout24BodyType:
      type: integer
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 12
        - 13
    AutoScout24FuelType:
      type: string
      enum:
        - '2'
        - '3'
        - B
        - C
        - D
        - E
        - H
        - L
        - M
        - O
    AutoScout24Transmission:
      type: string
      enum:
        - A
        - M
        - S
    AutoScout24Drivetrain:
      type: string
      enum:
        - '4'
        - F
        - R
    AutoScout24PriceType:
      type: string
      enum:
        - private
        - dealer
    AutoScout24PowerUnit:
      type: string
      enum:
        - hp
        - kw
    AutoScout24SellerType:
      type: string
      enum:
        - D
        - P
    AutoScout24Cylinders:
      type: string
      enum:
        - '3'
        - '4'
        - '6'
        - '8'
        - 10plus
    AutoScout24Equipment:
      type: integer
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 10
        - 11
        - 12
        - 13
        - 15
        - 16
        - 17
        - 18
        - 19
        - 20
        - 21
        - 23
        - 25
        - 26
        - 27
        - 28
        - 29
        - 30
        - 31
        - 32
        - 34
        - 36
        - 38
        - 39
        - 40
        - 41
        - 42
        - 43
        - 44
        - 45
        - 46
        - 47
        - 48
        - 50
        - 52
        - 54
        - 111
        - 112
        - 113
        - 114
        - 115
        - 116
        - 117
        - 118
        - 119
        - 121
        - 122
        - 123
        - 124
        - 125
        - 126
        - 127
        - 128
        - 129
        - 130
        - 131
        - 132
        - 133
        - 134
        - 135
        - 136
        - 137
        - 138
        - 139
        - 140
        - 141
        - 142
        - 143
        - 144
        - 145
        - 146
        - 147
        - 148
        - 149
        - 150
        - 151
        - 152
        - 153
        - 154
        - 155
        - 156
        - 157
        - 158
        - 159
        - 160
        - 161
        - 162
        - 170
        - 173
        - 174
        - 187
        - 189
        - 190
        - 210
        - 211
        - 212
        - 213
        - 214
        - 215
        - 216
        - 217
        - 218
        - 219
        - 220
        - 221
        - 222
        - 223
        - 224
        - 225
        - 226
        - 227
        - 228
        - 229
        - 230
        - 231
        - 232
        - 233
        - 237
        - 238
        - 239
        - 240
        - 241
        - 242
        - 243
        - 244
        - 245
        - 248
        - 249
        - 250
        - 251
    AutoScout24Condition:
      type: integer
      enum:
        - 37
        - 49
        - 53
        - 110
        - 120
    AutoScout24BodyColor:
      type: integer
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 10
        - 11
        - 12
        - 13
        - 14
        - 15
        - 16
    AutoScout24InteriorColor:
      type: integer
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
        - 10
        - 11
    AutoScout24BodyPainting:
      type: string
      enum:
        - M
        - O
        - P
        - S
        - U
    AutoScout24Upholstery:
      type: string
      enum:
        - AL
        - CL
        - FL
        - OT
        - PL
        - VL
    AutoScout24EmissionSticker:
      type: integer
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
    AutoScout24Sort:
      type: string
      enum:
        - standard
        - price
        - financerate
        - leasing_rate
        - make
        - year
        - mileage
        - power
        - age
        - distance
    AutoScout24Location:
      properties:
        '@type':
          type: string
          default: AutoScout24Location
        country_code:
          anyOf:
            - type: string
            - type: 'null'
        zip:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        street:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
      type: object
    AutoScout24Seller:
      properties:
        '@type':
          type: string
          default: AutoScout24Seller
        id:
          anyOf:
            - type: string
            - type: 'null'
        type:
          anyOf:
            - type: string
            - type: 'null'
        is_dealer:
          type: boolean
          default: false
        company_name:
          anyOf:
            - type: string
            - type: 'null'
        contact_name:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        alias:
          anyOf:
            - type: string
            - type: 'null'
        info_url:
          anyOf:
            - type: string
            - type: 'null'
        culture:
          anyOf:
            - type: string
            - type: 'null'
        phones:
          items:
            type: string
          type: array
          default: []
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````