API REST

Vos données ont leur place dans le tableau de bord que votre équipe utilise déjà. 7 endpoints de lecture, du JSON simple, aucun SDK requis.

Accueil /
Plateforme /
API REST

Trente secondes jusqu'à votre première réponse

Créez une clé dans le tableau de bord sous API Keys, puis envoyez-la comme jeton Bearer. C'est toute la configuration.

# Lister tous les mots-clés que vous suivez
curl -H "Authorization: Bearer sk_your_key_here" \
     "https://seo.newinterval.com/api/v1/keywords?project_id=3"

{
  "data": [
    {
      "id": 812,
      "keyword": "seo platform lebanon",
      "project_id": 3,
      "country": "LB",
      "location": "Beirut",
      "current_position": 4,
      "last_checked": "2026-07-30 06:12:03"
    }
  ],
  "meta": { "count": 1, "project_id": 3 }
}

Chaque réponse utilise la même enveloppe : les résultats sous data, le contexte sous meta. Les erreurs reviennent sous la forme {error, code, message} avec le statut HTTP correspondant. Il n'y a rien d'autre à apprendre.

Les endpoints

Tous en GET. Tous limités à ce que l'utilisateur de la clé est autorisé à voir — une clé émise pour quelqu'un ayant accès à un projet ne peut pas en lire un autre.

Endpoint	Renvoie	Filtres
`/api/v1/`	L'index des endpoints — utile comme test de connectivité.	—
`/api/v1/projects`	Les projets accessibles à l'utilisateur de la clé.	—
`/api/v1/keywords`	Les mots-clés suivis avec leurs positions actuelles.	project_id, status, search
`/api/v1/positions`	L'historique complet des positions d'un mot-clé.	keyword_id, from, to
`/api/v1/gsc`	Clics, impressions et positions Search Console.	project_id, period_days
`/api/v1/alerts`	Les alertes récentes.	unread
`/api/v1/credits`	Le solde actuel plus les dix dernières lignes du registre.	—

En lecture seule, délibérément. L'API lit vos données ; elle ne crée pas de projets, n'ajoute pas de mots-clés et ne déclenche pas de vérifications. Tout ce qui dépense des crédits se passe dans le tableau de bord, où vous voyez ce que cela coûtera. Les endpoints d'écriture sont sur la feuille de route, pas dans le produit — ne construisez donc pas encore dessus.

Clés, limites et bonnes pratiques

Affichée une fois, puis hachée

La clé complète n'apparaît qu'une seule fois, à sa création. Ensuite, seuls ses premiers caractères sont affichés. Nous stockons un hachage à clé, jamais la clé elle-même — une fuite de base de données ne livre donc votre accès API à personne.

1 000 requêtes par heure

Par clé, comptées côté serveur. Chaque réponse contient X-RateLimit-Limit et X-RateLimit-Remaining, pour que vous puissiez ralentir avant d'atteindre la limite plutôt qu'après.

Expiration et révocation

Donnez une date d'expiration à une clé lors de sa création, ou révoquez-la instantanément. Émettez une clé par intégration et vous pourrez couper exactement une chose quand il le faudra.

Les lectures API ne coûtent rien

Lire des données déjà collectées ne dépense aucun crédit. Interrogez l'API aussi souvent que la limite de requêtes le permet.

Authentification

Envoyez la clé comme jeton Bearer :

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

Si votre client ne peut pas définir d'en-têtes, un paramètre de requête ?token= fonctionne en secours — mais préférez l'en-tête, car les chaînes de requête finissent dans les journaux serveur et l'historique du navigateur.

Disponibilité

L'accès API est inclus dans les plans Agency et Network. Voir le comparatif.

Construisez dessus

Démarrez sur Agency, créez une clé et retrouvez vos positions dans votre propre tableau de bord l'après-midi même.

Démarrer Agency Voir tous les plans

Espace client

Contact