API SEO : intégrer les audits SEO et GEO dans vos applications
Une API SEO est une interface REST qui permet de lancer des audits de référencement depuis un programme plutôt qu’une interface web. L’API SEO de Crawlers.fr expose 18 modules d’analyse en REST asynchrone, avec 100 jobs gratuits par mois.
Authentification par clé Bearer, réponse JSON structurée, modèle asynchrone par polling : vous créez un job, vous interrogez son statut, vous récupérez le résultat. Aucun timeout sur les jobs longs (crawl complet, audit multi-pages).
Endpoints principaux
Base : https://api.crawlers.fr
| Méthode | Endpoint | Rôle |
|---|---|---|
GET | /v1/features | Liste les 18 modules disponibles (audit SEO, GEO, analyse sémantique, visibilité IA…). Aucune clé requise. |
POST | /v1/jobs | Crée un job d’analyse : { "feature": "geo_score", "input": { "url": "…" } }. Répond 202 avec un job_id et un poll_url. |
GET | /v1/jobs/{id} | Récupère le statut et le résultat JSON du job. À interroger toutes les 2 à 10 secondes. |
POST | /v1/jobs/{id}/cancel | Annule un job en cours, tant qu’il n’est pas terminé. |
GET | /marina/v1/audits | API Marina : audit de prospection multi-pages (identité, digital, stratégie) sur un domaine. |
GET | /parmenion-api/v1/tasks/pending | API Parménion : récupère les tâches de prescription d’optimisations à appliquer. |
Exemple de requête et de réponse
Créer un job de score GEO :
curl -X POST https://api.crawlers.fr/v1/jobs \
-H "Authorization: Bearer crw_live_..." \
-d '{"feature":"geo_score","input":{"url":"https://exemple.fr"}}'
# 202 Accepted
{ "job_id": "5d6e7f12-...", "status": "queued",
"poll_url": "/v1/jobs/5d6e7f12-..." }Récupérer le résultat :
curl https://api.crawlers.fr/v1/jobs/5d6e7f12-... \
-H "Authorization: Bearer crw_live_..."
# 200 OK
{ "status": "succeeded",
"result": { "geo_score": 68, "checks": [ /* … */ ] } }Quotas et tarifs
100 jobs gratuits / mois
Sans carte bancaire, renouvelés chaque mois.
Pay-as-you-go
~0,05 € par job en moyenne, facturé au volume réel via Stripe.
Sans engagement
Auth par clé Bearer, clé révocable à tout moment depuis le dashboard.
FAQ — API SEO
Prêt à intégrer l’API SEO ?
Créez votre clé, testez les 18 modules avec 100 jobs gratuits.