Search car listings on AutoScout24 from a search URL. One credit per successful call. The ad endpoint uses the same domains.
Supported hosts: autoscout24.de, autoscout24.be, autoscout24.es, autoscout24.fr, autoscout24.it, autoscout24.lu, autoscout24.nl, autoscout24.at, autoscout24.bg, autoscout24.cz, autoscout24.com, autoscout24.hr, autoscout24.pl, autoscout24.ro, autoscout24.ru, autoscout24.se, autoscout24.com.tr, autoscout24.com.ua, autoscout24.hu.
GET https://api.piloterr.com/v2/autoscout24/search?query=https://www.autoscout24.fr/lst/volkswagen/golf?atype=C
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full AutoScout24 search URL. page in that URL selects the page, starting at 1. |
| Field |
Type |
Description |
results |
array |
One card per listing on this page |
results[].id |
string |
Listing id |
results[].url |
string |
Absolute listing URL, for /v2/autoscout24/ad |
results[].title |
string |
Listing title |
results[].make |
string |
Make |
results[].model |
string |
Model |
results[].price |
number |
Asking price. Same amount as prices.public.price_raw on the ad |
results[].image |
string |
Thumbnail URL |
results[].mileage |
string |
Mileage label, such as 166 900 km |
results[].year |
string |
Registration year |
results[].first_registration |
string |
First registration, such as 12/2010 |
pagination.page |
integer |
Current page |
pagination.per_page |
integer |
Number of cards on this page |
pagination.total_results |
integer |
Matching listings |
pagination.total_pages |
integer |
Number of pages |
pagination.next |
string or null |
Next search URL, or null on the last page |
The playground example keeps the first card of a live page. per_page on that page is 20.
The card stops at those fields. Seller, photos beyond the thumbnail, and the full vehicle object are on the ad.
| Code |
Meaning |
| 400 |
Empty query, a host other than AutoScout24, or page below 1 |
| 401 |
Missing API key |
| 404 |
The page has no listing cards |
| 500 |
The page could not be fetched or parsed |