Referencia de la API

Documentación de la API de indexación de URLs

La API de indexación de URLs de IndexBolt te permite enviar URLs a Google para que las indexe, hacer seguimiento del progreso de los envíos y gestionar los créditos de forma programática. Integra la indexación masiva de URLs en tus flujos SEO, plugins de WordPress o herramientas personalizadas.

URL base: https://indexbolt.com/api/v1•Petición y respuesta JSON•Autenticación con Bearer token

Autenticación#

Todas las peticiones a la API requieren un Bearer token en la cabecera Authorization. Genera claves de API desde los ajustes del panel.

Cabecera de petición de ejemplo

Authorization: Bearer ib_your_api_key_here

Importante: Las claves de API empiezan por el prefijo ib_. Mantén tus claves en secreto: no las expongas en código del lado del cliente. Puedes crear hasta 5 claves de API por cuenta.

Límites de tasa#

Los límites de tasa se aplican por clave de API usando una ventana deslizante. Cuando se aplica el límite, recibirás un código de estado 429.

Endpoint	Límite	Ventana
`POST /submit`	10 peticiones	60 segundos
`GET /balance`	30 peticiones	60 segundos
`GET /submissions, /submissions/:id`	60 peticiones	60 segundos

Las cabeceras de respuesta X-RateLimit-Remaining y X-RateLimit-Reset indican tu uso actual.

Gestión de errores#

Todos los errores devuelven una estructura JSON coherente:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

Estado HTTP	Código	Descripción
`400`	`INVALID_INPUT`	Cuerpo o parámetros de la petición no válidos
`401`	`UNAUTHORIZED`	Clave de API ausente o no válida
`402`	`INSUFFICIENT_CREDITS`	Créditos insuficientes para la operación
`403`	`FORBIDDEN`	Email sin verificar
`404`	`NOT_FOUND`	Recurso no encontrado
`429`	`RATE_LIMITED`	Demasiadas peticiones
`500`	`INTERNAL_ERROR`	Error inesperado del servidor

Créditos y precios#

Indexación normal

1 crédito / URL

Procesamiento estándar. Las URLs se envían a Google para indexarse.

Indexación instantánea

10 créditos / URL

Procesamiento prioritario para resultados de indexación más rápidos.

Los créditos no caducan. Cada envío puede contener entre 1 y 1.000 URLs. Las URLs no válidas se filtran y no consumen créditos.

Enviar URLs#

POST/api/v1/submit10 pet / 60s

Envía un lote de URLs para que Google las indexe.

Cuerpo de la petición

Parámetro	Tipo	Obligatorio	Descripción
`urls`	string[]	Obligatorio	Array de URLs a indexar (1–1.000)
`indexingType`	string	Obligatorio	«normal» o «instant»
`projectId`	string	Opcional	Asociar a un proyecto
`submissionName`	string	Opcional	Nombre personalizado para el envío

Petición de ejemplo

cURL

curl -X POST https://indexbolt.com/api/v1/submit \
  -H "Authorization: Bearer ib_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com/page-1",
      "https://example.com/page-2"
    ],
    "indexingType": "normal"
  }'

Respuesta — 201 Created

{
  "success": true,
  "data": {
    "submissionId": "sub_abc123",
    "totalUrls": 2,
    "creditsUsed": 2,
    "balanceAfter": 98,
    "invalidUrls": []
  }
}

Validación de URLs: Las URLs deben usar HTTP/HTTPS, tener menos de 2.048 caracteres y apuntar a direcciones públicas. Las IPs privadas o internas (localhost, 10.x.x.x, 192.168.x.x, etc.) se rechazan. Las URLs duplicadas se eliminan automáticamente.

Listar envíos#

GET/api/v1/submissions60 pet / 60s

Recupera una lista paginada de tus envíos.

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
`page`	integer	Opcional	Número de página (por defecto: 1)
`pageSize`	integer	Opcional	Resultados por página, máx. 100 (por defecto: 20)
`status`	string	Opcional	«queued», «processing», «completed», «partial_failure» o «failed»

Petición de ejemplo

cURL

curl https://indexbolt.com/api/v1/submissions?page=1&pageSize=10 \
  -H "Authorization: Bearer ib_your_api_key"

Respuesta — 200 OK

{
  "success": true,
  "data": {
    "submissions": [
      {
        "id": "sub_abc123",
        "name": "Submission #1",
        "status": "completed",
        "indexingType": "normal",
        "totalUrls": 5,
        "creditsUsed": 5,
        "createdAt": "2025-01-15T10:30:00Z",
        "completedAt": "2025-01-15T11:45:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 45,
      "totalPages": 5
    }
  }
}

Obtener envío#

GET/api/v1/submissions/:id60 pet / 60s

Obtén los detalles completos de un envío, incluido el estado por URL.

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Obligatorio	El ID del envío

Petición de ejemplo

cURL

curl https://indexbolt.com/api/v1/submissions/sub_abc123 \
  -H "Authorization: Bearer ib_your_api_key"

Respuesta — 200 OK

{
  "success": true,
  "data": {
    "id": "sub_abc123",
    "name": "Submission #1",
    "status": "completed",
    "indexingType": "normal",
    "totalUrls": 5,
    "creditsUsed": 5,
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T11:45:00Z",
    "urls": [
      { "url": "https://example.com/page-1", "status": "completed" },
      { "url": "https://example.com/page-2", "status": "completed" }
    ]
  }
}

Consultar saldo#

GET/api/v1/balance30 pet / 60s

Consulta tu saldo actual de créditos.

Petición de ejemplo

cURL

curl https://indexbolt.com/api/v1/balance \
  -H "Authorization: Bearer ib_your_api_key"

Respuesta — 200 OK

{
  "success": true,
  "data": {
    "balance": 98,
    "unit": "credits"
  }
}

¿Listo para empezar?

Crea una cuenta, consigue tu clave de API y empieza a indexar URLs en minutos.

Empieza gratis Gestionar claves de API