Documentation de l'API IndexPro

Envoyez vos URLs en indexation standard ou instantanée depuis votre propre code. Une clé d'API, un en-tête, quatre endpoints.

Démarrez en trois étapes

Vous pouvez envoyer votre première requête en quelques minutes.

Copiez votre clé d'API

Connectez-vous, ouvrez votre page de compte et copiez la clé dans la section Clé d'API. Vous pouvez la régénérer à tout moment.

Demandez-nous l'URL de base

Nous partageons l'URL de base de l'API en privé avec les personnes qui vont réellement l'utiliser, elle n'est donc pas publiée sur cette page. Écrivez-nous et nous vous l'envoyons.

Envoyez votre premier lot

Choisissez un endpoint, collez votre clé et votre URL de base, puis envoyez vos URLs. Les crédits ne sont débités que si le lot est accepté.

À propos de l'URL de base

Nous ne publions pas l'URL de base de l'API ici. Contactez-nous et nous vous la transmettons directement, afin qu'elle reste entre les mains de ceux qui en ont vraiment besoin.

Tous les exemples de cette page l'écrivent BASE_URL. Remplacez ce marqueur par l'adresse que nous vous envoyons et laissez le reste du chemin tel quel.

Nous contacter pour l'URL de base

Quelle API choisir ?

Les deux endpoints acceptent le même corps de requête. Ils diffèrent par la rapidité de traitement et par le coût.

Indexation standard

L'option du quotidien. Idéale pour une publication régulière, de gros lots et la couverture habituelle d'un site entier.

Généralement traitée en quelques jours
Idéale pour les envois en masse et le contenu régulier
Disponible sur tout compte disposant de crédits

20 crédits par URL

Indexation instantanée

La voie rapide. À utiliser pour les pages qui doivent passer tout de suite : un lancement, un correctif ou un contenu urgent.

Souvent traitée en quelques minutes
Idéale pour les lancements, les correctifs urgents et les pages prioritaires
Nécessite une offre payante, les comptes gratuits reçoivent un 403

70 crédits par URL

Authentification

Chaque requête transporte votre clé d'API dans un en-tête. Il n'y a aucun autre identifiant à gérer.

X-API-Key: YOUR_API_KEY

Envoyez la clé dans l'en-tête X-API-Key à chaque requête.
Authorization: Bearer VOTRE_CLE_API fonctionne également, si cela convient mieux à votre client HTTP.
Gardez la clé côté serveur. Ne la mettez jamais dans une chaîne de requête, une application navigateur ou un dépôt public, car quiconque la détient peut dépenser vos crédits.
Si une clé est exposée, régénérez-la depuis votre page de compte. L'ancienne cesse de fonctionner immédiatement.

Référence des endpoints

Ajoutez chaque chemin à l'URL de base que nous vous envoyons. Tous les endpoints renvoient du JSON.

Méthode	Chemin	Rôle
POST	/api/v1/indexing/submit	Envoie des URLs dans la file d'indexation standard
POST	/api/v1/indexing/status	Vérifie si les URLs sont actuellement présentes dans Google
POST	/api/v1/instant-indexing/submit	Envoie des URLs dans la file d'indexation instantanée
POST	/api/v1/instant-indexing/status	Consulte le statut en direct de vos envois instantanés
GET	/api/v1/instant-indexing/batches	Liste vos lots d'indexation instantanée, du plus récent au plus ancien
GET	/api/v1/account/credits	Consulte votre solde de crédits, le tarif par URL et les limites

Envoyer des URLs

Choisissez un produit pour voir son chemin et un exemple prêt à l'emploi dans votre langage.

POST /api/v1/indexing/submit

Corps de la requête

Champ	Type	Obligatoire	Description
name	string	Oui	Un libellé pour le lot afin de le reconnaître plus tard. Jusqu'à 120 caractères.
urls	string[]	Oui	URLs absolues en http:// ou https://, jusqu'à 500 par requête. Les doublons sont retirés avant la facturation.
dripfeed	number	Non	Nombre de jours sur lesquels étaler l'envoi. Omettez-le pour tout envoyer d'un coup.

curl -X POST "BASE_URL/api/v1/indexing/submit" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "name": "My first batch",
    "urls": [
      "https://example.com/page-1",
      "https://example.com/page-2"
    ]
  }'

Vérifier le statut

Les deux produits exposent un endpoint de statut. Ils répondent à des questions différentes, lisez donc la note sous chacun.

POST /api/v1/indexing/status

Demande à Google si chaque URL est actuellement indexée. Utile pour confirmer le résultat d'un lot envoyé plus tôt.

curl -X POST "BASE_URL/api/v1/indexing/status" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{ "urls": ["https://example.com/page-1"] }'

Coûte 5 crédits par URL et accepte jusqu'à 100 URLs par requête.

Réponses

Toutes les réponses ont la même structure : un indicateur de succès, un message et un objet data.

Réponse d'envoi

{
  "success": true,
  "message": "URLs submitted for indexing.",
  "data": {
    "batchId": "68c7dad9265f988545ebc774",
    "batchName": "My first batch",
    "urlsSubmitted": 2,
    "submissionStatus": "Submitted",
    "creditsCharged": 40,
    "remainingCredits": 824,
    "createdAt": "2026-09-15T09:22:33.229Z"
  }
}

Réponse de statut

{
  "success": true,
  "message": "Checked 2 URLs.",
  "data": {
    "results": [
      { "url": "https://example.com/page-1", "indexed": true, "checked": true },
      { "url": "https://example.com/page-2", "indexed": false, "checked": true }
    ],
    "urlsChecked": 2,
    "creditsCharged": 10,
    "remainingCredits": 814
  }
}

Réponse d'erreur

Les erreurs mettent success à false et expliquent ce qu'il faut changer. Le code HTTP en indique la catégorie.

{
  "success": false,
  "message": "Insufficient credits. This request needs 40 credits but the account has 10.",
  "creditsRequired": 40,
  "creditsAvailable": 10
}

Limites et comportement

Bon à savoir avant de construire une boucle autour de ces endpoints.

30 / min

Envois par clé d'API

120 / min

Lectures de statut et de compte par clé d'API

500

URLs par envoi

100

URLs par vérification de statut

Les URLs en double dans une même requête sont fusionnées, le même lien n'est donc jamais facturé deux fois.
Les URLs qui enfreignent notre politique de contenu sont écartées et listées dans blockedUrls. Elles ne vous sont pas facturées.
Les crédits sont réservés à l'arrivée de la requête et intégralement restitués si l'envoi ne peut pas aboutir.
En cas de 429 ou de 502, patientez un instant puis réessayez. Un backoff exponentiel démarrant vers une seconde suffit largement.

Codes d'erreur

Ce que signifie chaque code de statut et comment réagir.

Statut	Signification	Que faire
400	Un champ manque dans le corps ou une valeur est hors limites	Lisez le message, il nomme le champ. Vérifiez que name est présent et que urls est un tableau non vide.
401	La clé d'API est absente, mal formée ou inconnue	Vérifiez que l'en-tête X-API-Key est défini et correspond à la clé de votre page de compte.
402	Crédits insuffisants pour cette requête	La réponse indique combien il en fallait et combien vous en avez. Rechargez, ou envoyez moins d'URLs.
403	Le compte ne peut pas utiliser cet endpoint	L'indexation instantanée exige une offre payante. Si le compte est inactif, contactez le support.
404	Rien sur votre compte ne correspond à la requête	Vérifiez les identifiants de suivi ou les URLs. Les consultations de statut ne couvrent que les envois de ce compte.
422	Toutes les URLs ont été bloquées par notre politique de contenu	Consultez blockedUrls dans la réponse pour connaître le motif de chaque URL. Aucun crédit n'a été débité.
429	Trop de requêtes sur une courte période	Ralentissez et réessayez dans une minute. Regroupez vos URLs en requêtes moins nombreuses et plus grandes.
502	Le fournisseur d'indexation était indisponible	Réessayez sous peu. Rien n'a été débité, vous pouvez renvoyer le même lot sans risque.

Prêt à vous lancer ?

Écrivez-nous pour obtenir l'URL de base de l'API, ou dites-nous ce que vous construisez et nous vous aiderons à le brancher.

Demander l'URL de base Contacter le support