Documentación y Guías

Cómo funciona

1. Tu servidor envía a IndexLaunch una lista de URL de páginas, firmada con tu clave de API.
2. IndexLaunch comprueba cada URL, descuenta un crédito por URL y la envía a los buscadores para su rastreo. Recibes un ID por cada URL.
3. Usa esos ID para consultar el estado de cada URL cuando quieras.

Configuración en 4 pasos

1. Inicia sesión y crea una clave en Ajustes → Acceso a la API. Solo se muestra una vez, así que cópiala de inmediato.
2. Guarda la clave como variable de entorno secreta en tu servidor o CI, por ejemplo INDEXLAUNCH_API_KEY. Nunca la incluyas en código del navegador ni en un repositorio público.
3. Verifica cada dominio cuyas URL vayas a enviar (Settings → Domain Verification). Los buscadores rechazan las URL de sitios no verificados.
4. Llama a la API desde tu backend, un script o tu pipeline de despliegue. Los ejemplos de abajo están listos para copiar.

Autenticación

Envía tu clave en el encabezado Authorization de cada solicitud como Bearer YOUR_KEY. Todas las solicitudes usan HTTPS y JSON.

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

Enviar URL

Envía hasta 500 URL completas (que empiecen por https://) por solicitud. Cada URL cuesta un crédito. La respuesta incluye un ID por URL, en el mismo orden en que las enviaste.

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..."] }

Consultar el estado de una URL

Indica un ID de la respuesta del envío. Solo puedes consultar URL enviadas desde tu propia cuenta.

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
}

Campos de la respuesta

id

El ID del envío.

url

La URL que enviaste.

status

Uno de los valores de estado que se indican abajo.

submittedAt

Cuándo se envió, en milisegundos desde la época Unix.

indexedAt

Cuándo la aceptaron los buscadores. No aparece hasta entonces.

Valores de estado

pending

Recibida y a la espera de envío. La mayoría de las URL avanzan en pocos minutos.

indexed

Aceptada por los buscadores y en cola para rastreo. El panel la muestra como “Submitted”. Aún no confirma que la página esté indexada.

failed

Los buscadores no aceptaron la URL, casi siempre porque el dominio no está verificado. El crédito se devuelve automáticamente.

refunded

La URL estuvo atascada más de 7 días, así que el crédito se devolvió automáticamente.

Ejemplos de código

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"]}'

Errores

Los errores devuelven JSON con un campo error que contiene un mensaje que puedes mostrar o registrar.

400

Solicitud incorrecta: el cuerpo no tiene una lista urls, alguna URL no es válida, se enviaron más de 500 URL, no hay créditos suficientes o las solicitudes llegan demasiado rápido.

401

Falta la clave, es incorrecta o fue revocada.

403

La cuenta está suspendida.

404

Ningún envío con ese ID pertenece a tu cuenta.

Buenas prácticas

• Envía solo páginas nuevas o modificadas, no todo tu sitio en cada despliegue.
• Agrupa las URL en una sola solicitud en lugar de enviar una solicitud por URL.
• Si recibes “Too many requests” o un mensaje de límite de frecuencia, espera un minuto y vuelve a intentarlo. Los límites exactos de tu cuenta aparecen en Ajustes → Acceso a la API.
• Si una clave se filtra, revócala en Ajustes y crea una nueva. Las claves revocadas dejan de funcionar de inmediato.