Référence API

Documentation de l'API d'indexation d'URL

L'API d'indexation d'URL d'IndexBolt te permet de soumettre des URLs à Google pour indexation, de suivre la progression des soumissions et de gérer tes crédits de manière programmatique. Intègre l'indexation d'URL en masse dans tes workflows SEO, tes plugins WordPress ou tes outils personnalisés.

URL de base : https://indexbolt.com/api/v1•Requête et réponse JSON•Authentification par Bearer token

Authentification#

Toutes les requêtes API exigent un Bearer token dans l'en-tête Authorization. Génère tes clés API depuis les paramètres de ton tableau de bord.

Exemple d'en-tête de requête

Authorization: Bearer ib_your_api_key_here

Important : Les clés API commencent par le préfixe ib_. Garde tes clés secrètes — ne les expose pas dans du code côté client. Tu peux créer jusqu'à 5 clés API par compte.

Limites de requêtes#

Les limites de requêtes sont appliquées par clé API en utilisant une fenêtre glissante. En cas de limite atteinte, tu recevras un code de statut 429.

Endpoint	Limite	Fenêtre
`POST /submit`	10 requêtes	60 secondes
`GET /balance`	30 requêtes	60 secondes
`GET /submissions, /submissions/:id`	60 requêtes	60 secondes

Les en-têtes de réponse X-RateLimit-Remaining et X-RateLimit-Reset indiquent ton utilisation actuelle.

Gestion des erreurs#

Toutes les erreurs renvoient une structure JSON cohérente :

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

Statut HTTP	Code	Description
`400`	`INVALID_INPUT`	Corps de requête ou paramètres invalides
`401`	`UNAUTHORIZED`	Clé API manquante ou invalide
`402`	`INSUFFICIENT_CREDITS`	Crédits insuffisants pour l'opération
`403`	`FORBIDDEN`	Email non vérifié
`404`	`NOT_FOUND`	Ressource introuvable
`429`	`RATE_LIMITED`	Trop de requêtes
`500`	`INTERNAL_ERROR`	Erreur serveur inattendue

Crédits et tarifs#

Indexation normale

1 crédit / URL

Traitement standard. Les URLs sont soumises à Google pour indexation.

Indexation instantanée

10 crédits / URL

Traitement prioritaire pour des résultats d'indexation plus rapides.

Les crédits n'expirent jamais. Chaque soumission peut contenir entre 1 et 1 000 URLs. Les URLs invalides sont filtrées et ne consomment pas de crédits.

Soumettre des URLs#

POST/api/v1/submit10 req / 60s

Soumets un lot d'URLs pour indexation Google.

Corps de la requête

Paramètre	Type	Requis	Description
`urls`	string[]	Requis	Tableau d'URLs à indexer (1 à 1 000)
`indexingType`	string	Requis	« normal » ou « instant »
`projectId`	string	Optionnel	Associer à un projet
`submissionName`	string	Optionnel	Nom personnalisé pour la soumission

Exemple de requête

cURL

curl -X POST https://indexbolt.com/api/v1/submit \
  -H "Authorization: Bearer ib_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com/page-1",
      "https://example.com/page-2"
    ],
    "indexingType": "normal"
  }'

Réponse — 201 Created

{
  "success": true,
  "data": {
    "submissionId": "sub_abc123",
    "totalUrls": 2,
    "creditsUsed": 2,
    "balanceAfter": 98,
    "invalidUrls": []
  }
}

Validation des URLs : Les URLs doivent utiliser HTTP/HTTPS, faire moins de 2 048 caractères et pointer vers des adresses publiques. Les IPs privées/internes (localhost, 10.x.x.x, 192.168.x.x, etc.) sont rejetées. Les URLs en doublon sont automatiquement supprimées.

Lister les soumissions#

GET/api/v1/submissions60 req / 60s

Récupère une liste paginée de tes soumissions.

Paramètres de requête

Paramètre	Type	Requis	Description
`page`	integer	Optionnel	Numéro de page (par défaut : 1)
`pageSize`	integer	Optionnel	Résultats par page, max 100 (par défaut : 20)
`status`	string	Optionnel	« queued », « processing », « completed », « partial_failure » ou « failed »

Exemple de requête

cURL

curl https://indexbolt.com/api/v1/submissions?page=1&pageSize=10 \
  -H "Authorization: Bearer ib_your_api_key"

Réponse — 200 OK

{
  "success": true,
  "data": {
    "submissions": [
      {
        "id": "sub_abc123",
        "name": "Submission #1",
        "status": "completed",
        "indexingType": "normal",
        "totalUrls": 5,
        "creditsUsed": 5,
        "createdAt": "2025-01-15T10:30:00Z",
        "completedAt": "2025-01-15T11:45:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 45,
      "totalPages": 5
    }
  }
}

Récupérer une soumission#

GET/api/v1/submissions/:id60 req / 60s

Récupère tous les détails d'une soumission, y compris le statut par URL.

Paramètres de chemin

Paramètre	Type	Requis	Description
`id`	string	Requis	L'identifiant de la soumission

Exemple de requête

cURL

curl https://indexbolt.com/api/v1/submissions/sub_abc123 \
  -H "Authorization: Bearer ib_your_api_key"

Réponse — 200 OK

{
  "success": true,
  "data": {
    "id": "sub_abc123",
    "name": "Submission #1",
    "status": "completed",
    "indexingType": "normal",
    "totalUrls": 5,
    "creditsUsed": 5,
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T11:45:00Z",
    "urls": [
      { "url": "https://example.com/page-1", "status": "completed" },
      { "url": "https://example.com/page-2", "status": "completed" }
    ]
  }
}

Vérifier le solde#

GET/api/v1/balance30 req / 60s

Vérifie ton solde de crédits actuel.

Exemple de requête

cURL

curl https://indexbolt.com/api/v1/balance \
  -H "Authorization: Bearer ib_your_api_key"

Réponse — 200 OK

{
  "success": true,
  "data": {
    "balance": 98,
    "unit": "credits"
  }
}

Prêt à commencer ?

Crée un compte, récupère ta clé API et commence à indexer des URLs en quelques minutes.

Commencer gratuitement Gérer mes clés API