Autenticazione

Ogni richiesta a POST /v1/search è autenticata con una chiave API inviata nell’header x-api-key.

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "coffee makers" }'

Ottenere una chiave

Crea e gestisci le chiavi nella dashboard. Puoi avere più chiavi per account (ad esempio una per ambiente) e disattivarne una qualsiasi in qualsiasi momento. Ogni chiave porta il proprio rate limit, derivato dal tuo piano.

Errori di autenticazione

HTTP	`error`	Significato
401	`missing_api_key`	Nessun header `x-api-key` è stato inviato.
401	`unknown_api_key`	La chiave non esiste.
403	`inactive_api_key`	La chiave è stata disattivata.
403	`account_blocked`	L’account è sospeso.

Vedi Errori e ritentativi per il modello completo degli errori e i codici che dovresti ritentare.