GridarGridar

Référence API v1

API REST publique

Intègre Gridar à n8n, Zapier, Make ou tes propres scripts. Authentification par Bearer token, réponses JSON, versionnée par préfixe.

~ / gridar / api
$

Démarrage rapide

  1. Crée un token sur /account/api-keys. Copie-le immédiatement (il ne sera plus jamais affiché).
  2. Envoie-le dans l'en-tête Authorization: Bearer btb_xxx.
  3. Toutes les réponses sont en JSON. Erreurs : code HTTP standard + {"error": "..."}.
curl -H "Authorization: Bearer btb_xxx" https://api.gridar.app/api/v1/me/

Limites par plan

Essai (gratuit)
Pas d'accès API.
Pro
60 requêtes / heure / utilisateur
Agence
600 requêtes / heure / utilisateur

Au-delà de la limite : réponse 429 avec un en-tête Retry-After.

Endpoints

GET/me/

Identité du compte

Vérifie ton token et récupère ton plan + ta limite horaire.

Exemple curl
curl -H "Authorization: Bearer btb_xxx" \
  https://api.gridar.app/api/v1/me/
Réponse exemple
{
  "username": "darius",
  "email": "tu@exemple.ca",
  "plan": "pro",
  "rate_limit_per_hour": 60
}
GET/sites/

Liste de tes sites

Retourne tous les sites actifs liés à ton compte.

Exemple curl
curl -H "Authorization: Bearer btb_xxx" \
  https://api.gridar.app/api/v1/sites/
GET/sites/{id}/articles/

Articles d'un site

Filtres : ?status=published&language=fr&limit=50

Exemple curl
curl -H "Authorization: Bearer btb_xxx" \
  "https://api.gridar.app/api/v1/sites/12/articles/?status=published&language=fr&limit=20"
POST/sites/{id}/generate/

Générer un article complet

Le générateur IA produit un article SEO-ready et le publie. Coûte du temps GPU. Utilise avec parcimonie.

Exemple curl
curl -X POST -H "Authorization: Bearer btb_xxx" \
  -H "Content-Type: application/json" \
  -d '{"topic":"Comment choisir un CRM PME au Québec","article_type":"guide","length":"long","language":"fr"}' \
  https://api.gridar.app/api/v1/sites/12/generate/
POST/audit/

Audit SEO d'un contenu

Audit IA d'un article (existant ou brouillon). Pas besoin d'un site_id.

Exemple curl
curl -X POST -H "Authorization: Bearer btb_xxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Mon titre","excerpt":"...","content":"<p>...</p>","keyword":"crm pme","language":"fr"}' \
  https://api.gridar.app/api/v1/audit/
POST/brief/

Brief de contenu

Brief structuré (intent, sous-sujets, entités, FAQ) à partir d'un mot-clé cible.

Exemple curl
curl -X POST -H "Authorization: Bearer btb_xxx" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"meilleur crm pme quebec","language":"fr"}' \
  https://api.gridar.app/api/v1/brief/
GET/sites/{id}/keywords/

Mots-clés suivis

Liste des mots-clés trackés + dernière position connue.

Exemple curl
curl -H "Authorization: Bearer btb_xxx" \
  https://api.gridar.app/api/v1/sites/12/keywords/
POST/sites/{id}/keywords/snapshot/

Lancer un snapshot de positions

Crawl SERP immédiat pour mettre à jour les positions. Compte dans ta limite horaire.

Exemple curl
curl -X POST -H "Authorization: Bearer btb_xxx" \
  https://api.gridar.app/api/v1/sites/12/keywords/snapshot/
GET/sites/{id}/digest/weekly/

Digest hebdomadaire

Snapshot hebdomadaire (publications, audit, mots-clés). Pratique en cron pour Slack/email.

Exemple curl
curl -H "Authorization: Bearer btb_xxx" \
  https://api.gridar.app/api/v1/sites/12/digest/weekly/

Stabilité et versioning

Cette API est versionnée par préfixe (/api/v1/). Les endpoints existants ne changeront pas de signature sans version majeure ; les ajouts (nouveaux champs, nouveaux endpoints) peuvent arriver sans préavis.

Bug, demande d'endpoint, ou question : écris à tokamdarius@gmail.com.