> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapio.dev/llms.txt > Use this file to discover all available pages before exploring further. # Search AutoTrader > Search AutoTrader UK car listings near a postcode, with optional make, model, and year filters. ## OpenAPI ````yaml get /v1/autotrader/search openapi: 3.1.0 info: title: Scrapio version: 1.0.0 description: >- Turn any URL into structured data. Fetch raw HTML, crawl sites, extract structured content, interact with dynamic pages, and search the web through one API. contact: name: Scrapio Support url: https://scrapio.dev license: name: Proprietary servers: - url: https://api.scrapio.dev description: Production security: - bearerAuth: [] tags: - name: System - name: Fetch - name: Crawl - name: Map - name: Interact - name: Search - name: Google - name: Fast Search - name: Jobs - name: YouTube - name: Amazon - name: Walmart - name: Booking - name: Agoda - name: Airbnb - name: AutoTrader - name: ChatGPT - name: Perplexity - name: Gemini - name: Bing - name: Reddit - name: TikTok - name: Apple App Store - name: Target - name: Monitors paths: /v1/autotrader/search: get: tags: - AutoTrader summary: Search AutoTrader UK car listings description: >- Searches AutoTrader UK (autotrader.co.uk) car listings near a postcode, returning structured results (title, price, mileage, year, location, and more). Backed by a maintained third-party `autotrader` Web Scraping API target. Requires a Starter plan or higher. operationId: searchAutotrader parameters: - name: postcode in: query required: true schema: type: string minLength: 1 description: UK postcode to anchor the search, e.g. 'SW1A 1AA' - name: radius in: query required: false schema: description: Search radius in miles type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - name: make in: query required: false schema: description: Vehicle make, e.g. 'BMW' type: string minLength: 1 - name: model in: query required: false schema: description: Vehicle model, e.g. '3 Series' type: string minLength: 1 - name: year_from in: query required: false schema: description: Minimum registration year type: integer minimum: 1900 maximum: 9007199254740991 - name: year_to in: query required: false schema: description: Maximum registration year type: integer minimum: 1900 maximum: 9007199254740991 - name: exclude_writeoffs in: query required: false schema: description: Exclude write-off category vehicles type: boolean - name: page in: query required: false schema: description: Result page number type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - name: geo in: query required: false schema: description: Country to use when submitting the request, e.g. 'gb', 'us', 'de' type: string minLength: 2 maxLength: 64 responses: '200': description: Structured AutoTrader search results. content: application/json: schema: $ref: '#/components/schemas/AutotraderSearchResponse' '400': description: Invalid search parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: AutoTrader dedicated endpoints require a Starter plan or higher. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Daily credit cap exceeded. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '502': description: AutoTrader upstream failed or returned an unusable page. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: AutoTrader execution backend unavailable or unconfigured. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' x-codeSamples: - lang: cURL label: cURL source: >- curl "https://api.scrapio.dev/v1/autotrader/search?postcode=SW1A%201AA&make=BMW&model=3%20Series&year_from=2018" \ -H "Authorization: Bearer $SCRAPIO_API_KEY" components: schemas: AutotraderSearchResponse: type: object properties: provider: type: string enum: - autotrader page_type: type: string enum: - search snapshot_at: type: string query_context: type: object properties: postcode: type: string radius: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 make: type: string model: type: string year_from: type: integer minimum: -9007199254740991 maximum: 9007199254740991 year_to: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclude_writeoffs: type: boolean page: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 geo: type: string required: - postcode additionalProperties: false meta_data: type: object properties: url: type: string format: uri number_of_results: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' required: - url - number_of_results additionalProperties: false results: type: array items: type: object properties: id: type: string url: type: string format: uri title: anyOf: - type: string - type: 'null' subtitle: anyOf: - type: string - type: 'null' attention_grabber: anyOf: - type: string - type: 'null' price: anyOf: - type: number - type: 'null' price_indicator: anyOf: - type: string - type: 'null' mileage: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' year: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' location: anyOf: - type: string - type: 'null' distance_miles: anyOf: - type: number - type: 'null' seller_type: anyOf: - type: string enum: - private - type: 'null' listing_type: anyOf: - type: string enum: - featured - you_may_also_like - sponsored - type: 'null' required: - id - url - title - subtitle - attention_grabber - price - price_indicator - mileage - year - location - distance_miles - seller_type - listing_type additionalProperties: false required: - provider - page_type - snapshot_at - query_context - meta_data - results additionalProperties: false ErrorResponse: type: object properties: request_id: type: string error: type: object properties: code: type: string message: type: string required: - code - message diagnostics: type: object properties: outcome: type: string enum: - failed retryable: type: boolean blocked: type: boolean timed_out: type: boolean required: - outcome - retryable additionalProperties: false required: - request_id - error additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key ````