Volver al inicio

Documentación de la API

API REST de Indexación Instantánea — versión 1

Empezar rápido

1. Consigue una clave

Disponible en todos los planes, en Panel → Perfil → Acceso a la API.

2. Envía tus URL

Un POST al endpoint de envío. Hasta 500 URL por petición, procesadas en lotes de 3.

3. Sigue el rastreo

El historial indica en qué punto está cada URL. Se conserva 48 horas.

Autenticación

Los endpoints autenticados esperan tu clave en la cabecera Authorization: Bearer. Las claves empiezan por ixes_ y se generan desde Panel → Perfil → Acceso a la API.

# Tu clave de API autentica cada petición
curl https://indexacioninstantanea.com/api/user/credits \
  -H "Authorization: Bearer ixes_TU_CLAVE_API"

Tu clave vale tanto como tu contraseña: no la pongas nunca en código que llegue al navegador, en un repositorio público ni en una URL. Si se filtra, regenérala desde el panel: la anterior deja de funcionar al instante.

Límites

500

URL por petición

3 URL

Tamaño del lote

48 horas

Historial conservado

10 req/s

Ritmo máximo

Endpoints

POST/api/indexing/submitClave obligatoria

Enviar URL

Envía hasta 500 URL a Google. Se ponen en cola y se procesan en lotes de 3.

Cuerpo de la petición

{
  "urls": [
    "https://tusitio.com/pagina-1",
    "https://tusitio.com/pagina-2",
    "https://tusitio.com/pagina-3"
  ]
}

Respuesta

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

Errores

  • 400No se ha facilitado ninguna URL válida
  • 402Créditos insuficientes
  • 429Demasiadas peticiones: baja el ritmo
  • 503Servicio de indexación no disponible
GET/api/indexing/history?page=1&limit=20Clave obligatoria

Consultar el historial

Devuelve tus envíos, paginados. Las URL se conservan 48 horas.

Respuesta

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

Errores

  • 401Clave de API ausente o no válida
GET/api/user/creditsClave obligatoria

Consultar tu saldo

Devuelve tu saldo de créditos, tu plan y el coste de un envío.

Respuesta

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

Errores

  • 401Clave de API ausente o no válida
GET/api/plansPúblico

Listar los planes

Devuelve todos los planes activos. No requiere autenticación.

Respuesta

{
  "plans": [
    {
      "name": "Inicio",
      "price": 5,
      "credits": 80,
      "currency": "USD",
      "billingPeriod": "lifetime",
      "features": ["80 créditos de indexación", "…"]
    }
  ]
}

¿Alguna duda sobre la API? Escríbenos. Respondemos en menos de 24 horas.