Retour à l’accueil

Documentation de l’API

API REST Index Instantané — version 1

Démarrage rapide

1. Obtenez une clé

Disponible sur toutes les offres, dans Tableau de bord → Profil → Accès API.

2. Envoyez vos URL

Un POST vers l’endpoint de soumission. Jusqu’à 500 URL par requête, traitées par lots de 3.

3. Suivez l’exploration

L’historique indique où en est chaque URL. Il est conservé 48 heures.

Authentification

Les endpoints authentifiés attendent votre clé dans l’en-tête Authorization: Bearer. Les clés commencent par ixfr_ et se génèrent depuis Tableau de bord → Profil → Accès API.

# Votre clé d’API authentifie chaque requête
curl https://indexinstantane.com/api/user/credits \
  -H "Authorization: Bearer ixfr_VOTRE_CLE_API"

Votre clé vaut votre mot de passe : ne la placez jamais dans du code envoyé au navigateur, dans un dépôt public ou dans une URL. Si elle fuit, régénérez-la depuis le tableau de bord — l’ancienne cesse immédiatement de fonctionner.

Limites

500

URL par requête

3 URL

Taille de lot

48 heures

Historique conservé

10 req/s

Débit

Endpoints

POST/api/indexing/submitClé requise

Soumettre des URL

Envoie jusqu’à 500 URL à Google. Elles sont mises en file et traitées par lots de 3.

Corps de la requête

{
  "urls": [
    "https://votresite.fr/page-1",
    "https://votresite.fr/page-2",
    "https://votresite.fr/page-3"
  ]
}

Réponse

{
  "success": true,
  "submitted": 3,
  "failed": 0,
  "creditsUsed": 3,
  "remainingCredits": 61,
  "results": [
    { "url": "https://votresite.fr/page-1", "status": "submitted" },
    { "url": "https://votresite.fr/page-2", "status": "submitted" },
    { "url": "https://votresite.fr/page-3", "status": "submitted" }
  ]
}

Erreurs

  • 400Aucune URL valide fournie
  • 402Crédits insuffisants
  • 429Trop de requêtes — ralentissez
  • 503Service d’indexation indisponible
GET/api/indexing/history?page=1&limit=20Clé requise

Consulter l’historique

Récupère vos soumissions, paginées. Les URL sont conservées 48 heures.

Réponse

{
  "submissions": [
    {
      "_id": "abc123",
      "url": "https://votresite.fr/page-1",
      "status": "submitted",
      "searchEngine": "google",
      "creditsUsed": 1,
      "createdAt": "2026-09-07T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

Erreurs

  • 401Clé d’API absente ou invalide
GET/api/user/creditsClé requise

Consulter votre solde

Renvoie votre solde de crédits, votre offre et le coût d’une soumission.

Réponse

{
  "credits": 80,
  "planName": "Découverte",
  "planExpiresAt": "2099-12-31T00:00:00Z",
  "creditCosts": { "credit_cost_url_indexing": 1 }
}

Erreurs

  • 401Clé d’API absente ou invalide
GET/api/plansPublic

Lister les offres

Renvoie toutes les offres actives. Aucune authentification requise.

Réponse

{
  "plans": [
    {
      "name": "Découverte",
      "price": 5,
      "credits": 80,
      "currency": "USD",
      "billingPeriod": "lifetime",
      "features": ["80 crédits d’indexation", "…"]
    }
  ]
}

Une question sur l’API ? Écrivez-nous, nous répondons sous 24 heures.