> ## Documentation Index > Fetch the complete documentation index at: https://docs.perceptlayer.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Perceptlayer is a web data API: one key for structured JSON from about 250 websites. Base URL https://api.perceptlayer.com. > Send the key in the X-API-Key header. GET parameters go in the query string; POST parameters in a JSON body. > A successful call costs the credits on its endpoint (X-Credits-Used); failed calls cost nothing. Errors are {"error": {"code", "message", "request_id"}}. > AI agents can use every endpoint through the MCP server at https://api.perceptlayer.com/mcp (tools search_endpoints, get_endpoint, call_endpoint), with Authorization: Bearer . > Get a free key at https://perceptlayer.com/signup. # AutoScout24: Search > Search from AutoScout24. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [AutoScout24 API overview](https://perceptlayer.com/apis/autoscout24) for every AutoScout24 endpoint. ## OpenAPI ````yaml /openapi.json get /v1/autoscout24/search openapi: 3.1.0 info: title: Perceptlayer API version: 1.0.0 description: >- One API key for structured web data. Each successful call costs the credits shown on its endpoint; failed calls are free. servers: - url: https://api.perceptlayer.com security: - ApiKeyAuth: [] tags: - name: 99acres - name: Agoda - name: Airbnb - name: AliExpress - name: Apartments.com - name: Apple App Store - name: Aramisauto - name: Arbeitsagentur Jobs - name: Argenprop - name: Autohero - name: AutoScout24 - name: AutoTempest - name: AutoTrack.nl - name: Autotrader - name: AutoTrader.ca - name: AutoTrader UK - name: AutoUncle - name: Autovit - name: Baidu - name: Bandcamp - name: Bayut - name: Behance - name: Bien'ici - name: Bilbasen - name: Bilibili - name: Billiger.de - name: Bing - name: Blocket Bil - name: Bluesky - name: Boliga - name: Booking.com - name: Booli - name: Brave Search - name: Bring a Trailer - name: Capterra - name: CarDekho - name: CarGurus - name: CarMax - name: Cars & Bids - name: Cars.com - name: Cars24 - name: Carsales - name: Carvana - name: Carwow - name: Casa.it - name: Centris - name: Coches.net - name: Copart - name: Craigslist - name: Crexi - name: Daft.ie - name: Dailymotion - name: DBA - name: Depop - name: DeviantArt - name: Dice - name: Domain Availability - name: Domain.com.au - name: Dribbble - name: Dubizzle - name: DuckDuckGo - name: eBay - name: Economy Car Rentals - name: Edmunds - name: Eventbrite - name: Expedia - name: Facebook - name: Facebook Ad Library - name: Fincaraiz - name: FINN - name: FINN Bil - name: Flickr - name: FlixBus - name: Fotocasa - name: Geizhals - name: Genius - name: GetYourGuide - name: GitHub - name: Glassdoor - name: Goodreads - name: Google Ads Transparency - name: Google Events - name: Google Finance - name: Google Flights - name: Google Forums - name: Google Hotels - name: Google Images - name: Google Jobs - name: Google Lens - name: Google Local - name: Google Local Services - name: Google Maps - name: Google News - name: Google Patents - name: Google Play - name: Google Related Questions - name: Google Scholar - name: Google Search - name: Google Shopping - name: Google Short Videos - name: Google Translate - name: Google Travel Explore - name: Google Trends - name: Google Videos - name: Gumtree - name: Habitaclia - name: Hacker News - name: Hemnet - name: heycar - name: HolidayCheck - name: Holidu - name: Homegate - name: HomeToGo - name: Hostelworld - name: HotPads - name: IAAI - name: Idealista - name: Idealo - name: Imgur - name: ImmobilienScout24 - name: ImmobilienScout24 Austria - name: ImmoScout24 Switzerland - name: Immoweb - name: Immowelt - name: Imovirtual - name: Impressum Extraction - name: Indeed - name: InfoJobs - name: Inmuebles24 - name: Instagram - name: Jameda - name: Kavak - name: Kayak Flights - name: Kayak - name: Kelley Blue Book - name: Kick - name: Kijiji - name: Kiwi.com - name: Kleinanzeigen - name: kununu - name: Kwai - name: La Centrale - name: Leboncoin Autos - name: Leboncoin Immo - name: Lemmy - name: Letterboxd - name: Link in Bio - name: LinkedIn - name: Linktree - name: LLM Answers - name: LoopNet - name: Madlan - name: MagicBricks - name: Marktplaats - name: Marktplaats Autos - name: Mastodon - name: Medium - name: Mercado Libre - name: Metrocuadrado - name: Milanuncios - name: Mixcloud - name: mobile.de - name: Motors.co.uk - name: MyAnimeList - name: Naukri - name: Naver - name: North Data - name: Odysee - name: OfferUp - name: Ohne-Makler - name: OLX Poland - name: Omio - name: OnTheMarket - name: Otodom - name: Otomoto - name: Patreon - name: Pinterest - name: Private Property - name: Product Hunt - name: Property Finder - name: realestate.com.au - name: Realtor.ca - name: Redfin - name: Reed - name: Rentalcars.com - name: Rentalia - name: Ricardo - name: Rightmove - name: Rumble - name: SEEK - name: SeLoger - name: Semrush - name: Similarweb - name: Skyscanner - name: Snapchat - name: SoundCloud - name: SpareRoom - name: Spotahome - name: Spotify - name: Sreality - name: Standvirtual - name: Startpage - name: Steam - name: StepStone - name: Subito - name: Subito Motori - name: Substack - name: SuperCasa - name: Telegram - name: Threads - name: TikTok - name: Trade Me Property - name: Trainline - name: Tripadvisor - name: Trivago - name: TrueCar - name: Trulia - name: Trusted Shops - name: Trustpilot - name: Truth Social - name: Tumblr - name: tutti.ch - name: Twitch - name: Viator - name: Vimeo - name: Vinted - name: VivaReal - name: VK - name: Vrbo - name: Wallapop - name: Walmart - name: Web Scraper - name: Weibo - name: Welcome to the Jungle - name: WG-Gesucht - name: willhaben - name: wlw - name: X (Twitter) - name: XING Jobs - name: Yad2 - name: Yaencontre - name: Yahoo Search - name: Yelp - name: YouTube - name: Zillow - name: Zonaprop - name: Zoopla - name: Zumper paths: /v1/autoscout24/search: get: tags: - AutoScout24 summary: Search description: Search from AutoScout24. Costs 1 credit per successful call. operationId: autoscout24_search parameters: - name: market in: query required: false schema: type: string enum: - de - at - be - it - fr - nl - es - com - pl example: de - name: make_id in: query required: false schema: type: string maxLength: 12 example: '13' - name: model_id in: query required: false schema: type: string maxLength: 12 example: '1639' - name: price_min in: query required: false schema: type: integer example: 5000 - name: price_max in: query required: false schema: type: integer example: 20000 - name: mileage_min in: query required: false schema: type: integer - name: mileage_max in: query required: false schema: type: integer - name: registration_year_min in: query required: false schema: type: integer - name: registration_year_max in: query required: false schema: type: integer - name: power_min in: query required: false schema: type: integer - name: power_max in: query required: false schema: type: integer - name: power_unit in: query required: false schema: type: string enum: - kw - ps - name: fuel[] in: query required: false schema: type: array items: type: string enum: - '2' - '3' - B - C - D - E - H - L - M - O - name: transmission[] in: query required: false schema: type: array items: type: string enum: - A - M - S - name: body_type[] in: query required: false schema: type: array items: type: integer enum: - '1' - '2' - '3' - '4' - '5' - '6' - '7' - '12' - '13' - name: equipment[] in: query required: false schema: type: array items: type: integer - name: seller_type in: query required: false schema: type: string enum: - dealer - private - name: offer in: query required: false schema: type: string enum: - new - used - annual - 'N' - U - J - name: usage_state[] in: query required: false schema: type: array items: type: string enum: - 'N' - U - name: zip in: query required: false schema: type: string maxLength: 12 - name: radius in: query required: false schema: type: integer - name: sort in: query required: false schema: type: string enum: - standard - price - age - mileage - year - power - make - distance - financerate - leasing_rate example: price - name: order in: query required: false schema: type: string enum: - asc - desc - name: page in: query required: false schema: type: integer example: 2 - name: limit in: query required: false schema: type: integer example: 20 responses: '200': description: Success headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-Credits-Used: $ref: '#/components/headers/CreditsUsed' X-Credits-Remaining: $ref: '#/components/headers/CreditsRemaining' RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' content: application/json: schema: type: object properties: endpoint: type: string params: type: object properties: market: type: string make_id: type: string model_id: type: string price_min: type: string price_max: type: string sort: type: string page: type: string limit: type: string response: type: object properties: success: type: boolean data: type: object properties: listings: type: array items: type: object properties: listing_id: type: string url: type: string title: type: string price: type: object properties: amount: type: integer currency: type: string formatted: type: string evaluation: type: integer is_evaluation_enabled: type: boolean mileage: type: object properties: value_km: type: integer unit: type: string raw: type: string first_registration: type: object properties: raw: type: string year: type: integer month: type: integer power: type: object properties: kw: type: integer ps: type: integer fuel: type: string transmission: type: string make: type: string model: type: string model_group: type: string variant: type: string motor_type: type: string co2: type: object properties: value: type: integer unit: type: string raw: type: string consumption: type: object properties: value: type: number unit: type: string raw: type: string location: type: object properties: country_code: type: string zip: type: string city: type: string seller: type: object properties: id: type: string type: type: string name: type: string contact_name: type: string dealer_slug: type: string images: type: array items: type: string is_ocs: type: boolean super_deal: type: boolean availability: type: object properties: available_now: type: boolean pagination: type: object properties: page: type: integer limit: type: integer total: type: integer total_pages: type: integer has_more: type: boolean next_page: type: integer meta: type: object properties: duration_ms: type: integer endpoint_family: type: string description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: endpoint: autoscout24.search params: market: de make_id: '13' model_id: '1639' price_min: '5000' price_max: '20000' sort: price page: '2' limit: '20' response: success: true data: listings: - listing_id: f81b29b2-19e3-4418-8801-03578ed51631 url: >- https://www.autoscout24.de/angebote/bmw-3er-316-d-tuev-neu-diesel-weiss-cat_ma13gr100038ge25va106mt123tr189-f81b29b2-19e3-4418-8801-03578ed51631 title: BMW 316 Touring 316d price: amount: 5700 currency: EUR formatted: € 5.700 evaluation: 2 is_evaluation_enabled: true mileage: value_km: 215000 unit: km raw: 215.000 km first_registration: raw: 06/2013 year: 2013 month: 6 power: kw: 85 ps: 116 fuel: Diesel transmission: Schaltgetriebe make: BMW model: '316' model_group: 3er variant: Touring motor_type: 316d co2: value: 119 unit: g/km raw: 119 g/km (komb.) consumption: value: 4.5 unit: l/100 km raw: 4,50 l/100 km (komb.) location: country_code: DE zip: '55252' city: Mainz-Kastel seller: id: '32515898' type: Dealer name: Rheinkastelautomobile contact_name: Jamil Daoud dealer_slug: rheinkastelautomobile images: - >- https://prod.pictures.autoscout24.net/listing-images/f81b29b2-19e3-4418-8801-03578ed51631_7ad97c85-7385-4c32-9ef0-66246530ef0d.jpg/250x188.webp - >- https://prod.pictures.autoscout24.net/listing-images/f81b29b2-19e3-4418-8801-03578ed51631_5a482bfc-94a6-4ecd-b359-5f0f339db1b8.jpg/250x188.webp - >- https://prod.pictures.autoscout24.net/listing-images/f81b29b2-19e3-4418-8801-03578ed51631_f8ec93db-0243-4422-883f-b6838edbc2cb.jpg/250x188.webp is_ocs: false super_deal: false availability: available_now: true - listing_id: 2a852a90-b665-4e36-80cc-743214bd2ad3 url: >- https://www.autoscout24.de/angebote/bmw-3er-316d-bmw-neu-tuev-diesel-cat_ma13gr100038ge25va105mt123tr479990-2a852a90-b665-4e36-80cc-743214bd2ad3 title: BMW 316 Limousine 316d price: amount: 5800 currency: EUR formatted: € 5.800 evaluation: 1 is_evaluation_enabled: true mileage: value_km: 177000 unit: km raw: 177.000 km first_registration: raw: 01/2012 year: 2012 month: 1 power: kw: 85 ps: 116 fuel: Diesel transmission: Schaltgetriebe make: BMW model: '316' model_group: 3er variant: Limousine motor_type: 316d co2: value: 118 unit: g/km raw: 118 g/km (komb.) consumption: value: 4.5 unit: l/100 km raw: 4,50 l/100 km (komb.) location: country_code: DE zip: '13347' city: Berlin seller: id: '42804904' type: PrivateSeller images: - >- https://prod.pictures.autoscout24.net/listing-images/2a852a90-b665-4e36-80cc-743214bd2ad3_56a95e03-a638-4ba0-a673-fe48d9ae3807.jpg/250x188.webp - >- https://prod.pictures.autoscout24.net/listing-images/2a852a90-b665-4e36-80cc-743214bd2ad3_a51a7692-c3de-495c-83b8-ed6ca58f87d9.jpg/250x188.webp - >- https://prod.pictures.autoscout24.net/listing-images/2a852a90-b665-4e36-80cc-743214bd2ad3_6f97d55a-d623-4312-b6df-6049c0be4203.jpg/250x188.webp is_ocs: false super_deal: false availability: available_now: true - listing_id: c92fadf8-5ee3-4350-adaf-909150ad9fff url: >- https://www.autoscout24.de/angebote/bmw-3er-tia-compact-klimaaut-sitzheiz-automatik-benzin-schwarz-cat_ma13gr100038ge24va102mt116tr479990-c92fadf8-5ee3-4350-adaf-909150ad9fff title: BMW 316 Compact 316ti price: amount: 5900 currency: EUR formatted: € 5.900 evaluation: 1 is_evaluation_enabled: true mileage: value_km: 90000 unit: km raw: 90.000 km first_registration: raw: 10/2004 year: 2004 month: 10 power: kw: 85 ps: 116 fuel: Benzin transmission: Automatik make: BMW model: '316' model_group: 3er variant: Compact motor_type: 316ti co2: value: 190 unit: g/km raw: 190 g/km (komb.) consumption: value: 7.8 unit: l/100 km raw: 7,8 l/100 km (komb.) location: country_code: DE zip: '30938' city: Fuhrberg seller: id: '26170' type: Dealer name: Bartels-Automobile.de GmbH & Co.KG contact_name: Ihr Verkaufsteam dealer_slug: bartels-automobile-de-gmbh-und-co-kg images: - >- https://prod.pictures.autoscout24.net/listing-images/c92fadf8-5ee3-4350-adaf-909150ad9fff_40dd9e85-72d1-42f6-91ae-03cc33b1752c.jpg/250x188.webp - >- https://prod.pictures.autoscout24.net/listing-images/c92fadf8-5ee3-4350-adaf-909150ad9fff_c2d0e469-4e62-41dc-8e41-a6dd94ba24e1.jpg/250x188.webp - >- https://prod.pictures.autoscout24.net/listing-images/c92fadf8-5ee3-4350-adaf-909150ad9fff_6eefe90e-bc9d-4f35-ad48-a8080c183c4c.jpg/250x188.webp is_ocs: false super_deal: false availability: available_now: true pagination: page: 2 limit: 20 total: 193 total_pages: 10 has_more: true next_page: 3 meta: duration_ms: 2183 endpoint_family: search '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '410': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '502': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' '504': $ref: '#/components/responses/Error' components: headers: RequestId: description: Unique ID for this request; quote it in support requests. schema: type: string CreditsUsed: description: Credits charged for this call (0 when it failed). schema: type: integer CreditsRemaining: description: Your balance after this call. schema: type: integer RateLimitLimit: description: >- Requests a minute your account may make: its rate in requests per second times 60. schema: type: integer RateLimitRemaining: description: Requests left in the current minute, shared by every key on the account. schema: type: integer RateLimitReset: description: Seconds until the current minute's count starts over. schema: type: integer RateLimitPolicy: description: The limit and its window in seconds, for example "300;w=60". schema: type: string responses: Error: description: Error content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.