Docs et Guides

Fonctionnement

1. Votre serveur envoie une liste d'URL de pages à IndexLaunch, signée avec votre clé API.
2. IndexLaunch vérifie chaque URL, déduit un crédit par URL et l'envoie aux moteurs de recherche pour exploration. Vous recevez un ID par URL.
3. Utilisez ces ID pour consulter le statut de chaque URL quand vous le souhaitez.

Configuration en 4 étapes

1. Connectez-vous et créez une clé dans Paramètres → Accès API. Elle n'est affichée qu'une seule fois : copiez-la immédiatement.
2. Stockez la clé comme variable d'environnement secrète sur votre serveur ou votre CI, par exemple INDEXLAUNCH_API_KEY. Ne la placez jamais dans du code exécuté dans le navigateur ni dans un dépôt public.
3. Vérifiez chaque domaine dont vous soumettrez des URL (Settings → Domain Verification). Les moteurs de recherche rejettent les URL des sites non vérifiés.
4. Appelez l'API depuis votre backend, un script ou votre pipeline de déploiement. Les exemples ci-dessous sont prêts à copier.

Authentification

Envoyez votre clé dans l'en-tête Authorization de chaque requête sous la forme Bearer YOUR_KEY. Toutes les requêtes utilisent HTTPS et JSON.

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

Soumettre des URL

Envoyez jusqu'à 500 URL complètes (commençant par https://) par requête. Chaque URL coûte un crédit. La réponse contient un ID par URL, dans le même ordre que celui de l'envoi.

POST https://www.indexlaunch.site/api/v1/submit
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{ "urls": ["https://example.com/page-1", "https://example.com/page-2"] }

200 OK
{ "submitted": 2, "ids": ["j57...", "j58..."] }

Consulter le statut d'une URL

Transmettez un ID issu de la réponse de soumission. Vous ne pouvez consulter que les URL soumises par votre propre compte.

GET https://www.indexlaunch.site/api/v1/urls/j57...
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

200 OK
{
  "id": "j57...",
  "url": "https://example.com/page-1",
  "status": "indexed",
  "submittedAt": 1757740800000,
  "indexedAt": 1757741100000
}

Champs de la réponse

id

L'ID de la soumission.

url

L'URL que vous avez soumise.

status

L'une des valeurs de statut ci-dessous.

submittedAt

Date de soumission, en millisecondes depuis l'epoch Unix.

indexedAt

Date d'acceptation par les moteurs de recherche. Absent tant que ce n'est pas le cas.

Valeurs de statut

pending

Reçue et en attente d'envoi. La plupart des URL passent à l'étape suivante en quelques minutes.

indexed

Acceptée par les moteurs de recherche et mise en file d'exploration. Le tableau de bord l'affiche comme « Submitted ». Cela ne confirme pas encore que la page est indexée.

failed

Les moteurs de recherche n'ont pas accepté l'URL, le plus souvent parce que le domaine n'est pas vérifié. Le crédit est restitué automatiquement.

refunded

L'URL est restée bloquée plus de 7 jours, le crédit a donc été restitué automatiquement.

Exemples de code

curl -X POST https://www.indexlaunch.site/api/v1/submit \
  -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/new-post"]}'

const res = await fetch("https://www.indexlaunch.site/api/v1/submit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INDEXLAUNCH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    urls: ["https://example.com/new-post", "https://example.com/pricing"],
  }),
});

const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(`Submitted ${data.submitted} URLs`, data.ids);

import os
import requests

res = requests.post(
    "https://www.indexlaunch.site/api/v1/submit",
    headers={"Authorization": f"Bearer {os.environ['INDEXLAUNCH_API_KEY']}"},
    json={"urls": ["https://example.com/new-post"]},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"])
print(data["submitted"], data["ids"])

# .github/workflows/indexlaunch.yml
name: Submit new pages
on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - name: Send changed URLs to IndexLaunch
        env:
          INDEXLAUNCH_API_KEY: ${{ secrets.INDEXLAUNCH_API_KEY }}
        run: |
          curl --fail-with-body -X POST https://www.indexlaunch.site/api/v1/submit \
            -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"urls": ["https://example.com/new-post"]}'

Erreurs

Les erreurs renvoient du JSON avec un champ error contenant un message que vous pouvez afficher ou journaliser.

400

Requête invalide : le corps ne contient pas de liste urls, une URL n'est pas valide, plus de 500 URL ont été envoyées, les crédits sont insuffisants ou les requêtes arrivent trop vite.

401

La clé est manquante, incorrecte ou révoquée.

403

Le compte est suspendu.

404

Aucune soumission avec cet ID n'appartient à votre compte.

Bonnes pratiques

• Ne soumettez que les pages nouvelles ou modifiées, pas tout votre site à chaque déploiement.
• Regroupez les URL dans une seule requête au lieu d'envoyer une requête par URL.
• Si vous recevez « Too many requests » ou un message de limite de débit, attendez une minute et réessayez. Les limites exactes de votre compte sont indiquées dans Paramètres → Accès API.
• Si une clé fuite, révoquez-la dans les Paramètres et créez-en une nouvelle. Les clés révoquées cessent de fonctionner immédiatement.