Piloterr

AutoScout24 Search

Search for car listings on AutoScout24 by URL, returning paginated results with vehicle details, pricing, and seller info.

Credit cost: 1 credit per call

GET
/v2/autoscout24/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full AutoScout24 search URL from any supported domain. Filter parameters, make/model, and pagination in the URL are all respected.

Supported domains: .de, .be, .es, .fr, .it, .lu, .nl, .at, .bg, .cz, .com, .hr, .pl, .ro, .ru, .se, .com.tr, .com.ua, .hu

Example:

https://www.autoscout24.fr/lst/volkswagen/golf?atype=C

Notes:

  • Pagination is embedded in the URL (e.g. append &page=2 for the next page)
  • Filters like fuel type, price range, mileage, and year can be included in the URL

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/autoscout24/search?query=string"
{
  "results": [
    {
      "ad_tier": "T30",
      "vehicle": {
        "fuel": "Essence",
        "make": "Volkswagen",
        "type": "Car",
        "model": "Golf",
        "variant": "R",
        "transmission": "Boîte automatique",
        "mileage_in_km": "199 000 km",
        "model_version_input": "2.0 TSI 310CH BLUEMOTION TECHNOLOGY R 4MOTION DSG7 5P",
        "engine_displacement_in_c_c_m": "1 984 cm³"
      },
      "seller": {
        "id": "60012384",
        "type": "Dealer",
        "company_name": "PROVENCE CAR LA GARDE",
        "contact_name": "Mathias",
        "phones": [
          {
            "call_to": "+33787186962",
            "phone_type": "Office"
          }
        ]
      },
      "location": {
        "zip": "83130",
        "city": "La Garde",
        "country_code": "FR"
      },
      "tracking": {
        "price": "17990",
        "mileage": "199000",
        "fuel_type": "b",
        "price_label": "good-price",
        "first_registration": "04-2017"
      },
      "vehicle_details": {
        "gearbox": "Boîte automatique",
        "calendar": "04/2017",
        "speedometer": "231 kW (314 Ch)",
        "mileage_odometer": "199 000 km"
      },
      "available_now": true,
      "images": [
        "https://prod.pictures.autoscout24.net/listing-images/1ec155ad-ab25-46ba-aaa4-ae4831e3bfd7_be770320-3477-4b32-b7df-7b4f1533e9c4.png/250x188.webp"
      ]
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "total_pages": 70,
    "has_next_page": true,
    "total_results": 1382
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}