SERP API

Résultats de recherche Google, structurés.

Service en ligne

Authentification

Chaque requête porte votre clé, au choix dans l'en-tête X-API-Key ou en Authorization: Bearer.

curl -H "X-API-Key: VOTRE_CLE" \
  "https://serp.benchr.ai/serp?q=chaussures+running&gl=fr&hl=fr"

`q`	la requête — seul paramètre obligatoire
`gl`	pays du ciblage (`fr`, `us`, `tn`…)
`hl`	langue de l'interface
`start`	pagination : 0, 10, 20… Google rend 10 résultats par page
`resolve`	résoudre les liens en URLs réelles (défaut : oui)

`401`	clé absente ou inconnue
`403`	clé révoquée
`429`	débit dépassé — ralentissez, voir `Retry-After`
`402`	quota mensuel épuisé
`503`	capacité momentanément saturée — réessayez