API de indexación

01 Acceso bajo petición

Casi todo lo que hace el servicio pasa por el panel: pegas una lista, lanzas el pedido, ves cómo termina. Eso cubre la mayor parte de los casos. Por eso la puerta legible por máquina se mantiene estrecha y la abrimos para las cuentas que de verdad la necesitan.

Lo que sigue es toda la superficie tal como está diseñada. Es corta, y si te falta algo que necesitas, dínoslo. Un endpoint que la gente llama de verdad vale más que diez que no llama nadie.

02 Cómo está hecha

REST sobre HTTPS, JSON de entrada y JSON de salida, una clave en una cabecera y ningún SDK que instalar. Cualquier cosa capaz de hacer una petición HTTP puede manejarla.

• Una clave por cuenta. Se te emite a ti; se rota o se revoca bajo petición.
• Una cabecera. Sin firmas, sin baile de OAuth, sin token que refrescar.
• Los mismos objetos que ya ves. Un pedido creado por la API es el pedido de tu panel – mismos estados, mismo detalle por URL, mismo historial.
• Sin precios aparte. La misma tarifa, del mismo saldo, sea cual sea la vía por la que se creó el pedido.

Aquí no hay un segundo producto. Son las operaciones del propio panel con una puerta legible por máquina.

03 Tu clave

Envías la clave en cada llamada. La autenticación entera es esto:

La clave identifica la cuenta y gasta el saldo de esa cuenta. Se puede rotar o revocar en cualquier momento sin tocar tu contraseña ni tus sesiones abiertas. Trátala como una credencial: su sitio es tu servidor, no un navegador, ni un repositorio público, ni un ticket de soporte.

Una petición sin una clave válida se rechaza, no se le dice por qué, y no se distingue de una petición a una ruta que no existe. Aplicamos ese mismo principio en todo lo demás.

04 Qué puedes llamar

Seis operaciones, que se corresponden una a una con lo que hace el panel:

• Crear un pedido – envías una lista de URLs y recibes un pedido en forma de borrador. No se cobra nada y todavía no se encola nada.
• Lanzarlo – la llamada aparte que arranca la campaña y descuenta el crédito de tu saldo. Va aparte por un motivo: el borrador es el único sitio seguro para revisar la lista.
• Listar tus pedidos – los más recientes primero, paginados, con el estado de cada uno.
• Leer un pedido – su estado, sus contadores y el detalle por URL a medida que avanza la campaña.
• Consultar tu saldo – lo que queda, la misma cifra que muestra el panel.
• Borrar un borrador – mientras siga siendo un borrador. Una vez lanzado no hay nada que cancelar; consulta la Política de reembolsos.

Sin webhooks en la primera versión, sin exportación masiva, sin endpoints de informes – consultas un pedido y obtienes su estado. Si el sondeo no basta para lo que estás construyendo, dínoslo también.

05 Límites y reglas

Nada de esto es propio de la API. Es el mismo servicio con otra puerta:

• El mismo mínimo y máximo de URLs por pedido que en el panel, y tantos pedidos como quieras – consulta los precios.
• El mismo precio por URL, descontado de tu saldo en el momento en que se lanza el pedido.
• Límites de frecuencia por clave, altos para que quepa una automatización real y bajos para sobrevivir a un bucle con un fallo dentro.
• La política de uso aceptable se aplica exactamente igual que en el panel. Una clave no amplía lo que puedes enviar.

Los errores vuelven como JSON con un código de estado que significa lo que dice. Una URL rechazada se informa por URL y no como una petición fallida – una entrada mal formada no tira a la basura el resto de la lista.

06 Lo que no es

Las páginas de API suelen dar a entender más de lo que entregan, así que conviene ser claros:

• No es una forma de comprar el método. Crea pedidos. Lo que le ocurre a una URL después es el mismo pipeline cerrado que se describe en los Términos de uso, y ningún endpoint lo expondrá jamás.
• No es una garantía de indexación. Un pedido aceptado significa que el trabajo está encolado – exactamente lo que significa pulsar el botón en el panel, ni más ni menos.
• No es una interfaz para revendedores. Revender o trabajar en marca blanca requiere antes un acuerdo por escrito: sales@index-pages.com.
• No son los endpoints que usa nuestra propia flota. Existen, son internos, no están de cara al cliente y no son lo que describe esta página.

07 Pide una clave

Escribe a support@index-pages.com desde la dirección de tu cuenta, con dos líneas sobre qué automatizarías. Esa segunda parte es la que lo sube en la lista, porque construimos contra uso real y no contra un formulario de solicitud de funcionalidades.

Aquí el calendario lo marca la demanda. No hay lista de espera, ni programa beta, ni filtro: si lo necesitas, dilo. Todo lo demás está en la página de contacto.