Piloterr

AutoScout24 Ad

Extract full details from an AutoScout24 car listing, including price, vehicle specifications, seller info, and equipment.

Credit cost: 1 credit per call

GET
/v2/autoscout24/ad

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 car listing URL from any supported domain.

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/offres/peugeot-208-puretech-82ch-s-s-bvm5-allure-1-ere-main-distribut-essence-blanc-51a0c24c-84e6-4ed8-af6b-1b8ef193ae84

Note: The UUID at the end of the URL identifies the specific listing. Expired ads will return an error.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/autoscout24/ad?query=string"
{
  "id": "51a0c24c-84e6-4ed8-af6b-1b8ef193ae84",
  "image": "https://prod.pictures.autoscout24.net/listing-images/51a0c24c-84e6-4ed8-af6b-1b8ef193ae84_8629ad36-57f4-4dc1-8df0-87ce4e18a34b.jpg/1280x960.webp",
  "price": {
    "price_formatted": "€ 6 490",
    "price_evaluation": 1
  },
  "images": [
    "https://prod.pictures.autoscout24.net/listing-images/51a0c24c-84e6-4ed8-af6b-1b8ef193ae84_8629ad36-57f4-4dc1-8df0-87ce4e18a34b.jpg/1280x960.webp",
    "https://prod.pictures.autoscout24.net/listing-images/51a0c24c-84e6-4ed8-af6b-1b8ef193ae84_2d74a74a-7f43-441e-8e1f-a3a4d3ff4ff8.jpg/1280x960.webp"
  ],
  "prices": {
    "dealer": {
      "price": "€ 6 490",
      "category": 1,
      "price_raw": 6490,
      "negotiable": false,
      "evaluation_ranges": [
        {
          "maximum": 5400,
          "minimum": null,
          "category": 0
        },
        {
          "maximum": 6700,
          "minimum": 5401,
          "category": 1
        },
        {
          "maximum": 7400,
          "minimum": 6701,
          "category": 2
        }
      ]
    }
  },
  "seller": {
    "type": "private",
    "name": "Seller Name",
    "phone": "+33600000000",
    "location": {
      "city": "Paris",
      "country": "FR",
      "zip": "75001"
    }
  },
  "vehicle": {
    "make": "Peugeot",
    "model": "208",
    "fuel": "Essence",
    "transmission": "Manuel",
    "mileage": 85000,
    "year": 2018,
    "engine_displacement": "1199 cm³",
    "power_kw": 60,
    "color": "Blanc"
  },
  "description": "Peugeot 208 PureTech 82ch S&S BVM5 Allure - 1ère main, distribution effectuée, carnet d'entretien complet.",
  "equipment": [
    "Air conditioning",
    "Bluetooth",
    "Parking sensors"
  ]
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}