Recherche d'annonces AutoScout24 à partir d'une URL de recherche. Un crédit par appel réussi. L'endpoint ad couvre les mêmes domaines.
Domaines : 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
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
URL de recherche AutoScout24. page dans cette URL choisit la page, à partir de 1. |
| Champ |
Type |
Description |
results |
array |
Une carte par annonce de la page |
results[].id |
string |
Identifiant de l'annonce |
results[].url |
string |
URL absolue, à passer à /v2/autoscout24/ad |
results[].title |
string |
Titre |
results[].make |
string |
Marque |
results[].model |
string |
Modèle |
results[].price |
number |
Prix demandé. Même montant que prices.public.price_raw sur l'annonce |
results[].image |
string |
Vignette |
results[].mileage |
string |
Kilométrage affiché, par exemple 166 900 km |
results[].year |
string |
Année d'immatriculation |
results[].first_registration |
string |
Première immatriculation, par exemple 12/2010 |
pagination.page |
integer |
Page courante |
pagination.per_page |
integer |
Nombre de cartes sur cette page |
pagination.total_results |
integer |
Annonces correspondantes |
pagination.total_pages |
integer |
Nombre de pages |
pagination.next |
string ou null |
URL de la page suivante, ou null sur la dernière page |
L'exemple du playground garde la première carte d'une page réelle. per_page sur cette page vaut 20.
La carte s'arrête à ces champs. Le vendeur, les autres photos et le véhicule complet sont sur l'annonce.
| Code |
Signification |
| 400 |
Requête vide, hôte autre qu'AutoScout24, ou page inférieure à 1 |
| 401 |
Clé API absente |
| 404 |
La page ne contient aucune carte |
| 500 |
Page impossible à récupérer ou à parser |