Desarrolladores

Documentación de la API y MCP de EveryInfra

Elige una tarea del catálogo público, crea una clave API y haz tu primera llamada. Esta guía explica los ejemplos de solicitud, la configuración de MCP, la autenticación, la facturación y el tratamiento de errores.

Una cuenta para datos, búsqueda, procesamiento de texto y CAPTCHA

EveryInfra ofrece 387 funciones de recopilación de datos en 87 plataformas, 17 herramientas de búsqueda, 53 tipos de CAPTCHA y una API de texto compatible con OpenAI. Cada producto tiene su propio endpoint y formato de solicitud. Todos usan la misma clave API y el mismo saldo.

Los catálogos públicos se pueden consultar sin clave API.
Los endpoints autenticados usan una clave API de tipo Bearer.
MCP y REST comparten los mismos contratos públicos de las funciones.

Inicio rápido

Envía una solicitud real

Crea una clave API en la consola, consulta el catálogo correspondiente y envía el identificador de plataforma o función exactamente como aparece. La respuesta incluye datos estructurados e información de facturación de la solicitud.

Configura Authorization: Bearer YOUR_API_KEY.
Configura Content-Type: application/json para cuerpos de solicitud JSON.
Usa los identificadores y nombres de parámetros exactamente como los devuelve el catálogo.

Solicitud

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tiktok","action":"search","params":{"keyword":"AI infrastructure","limit":10}}'

Respuesta

{
  "id": "…",
  "platform": "tiktok",
  "action": "search",
  "results": [
    {
      "id": "…",
      "text": "…",
      "author_username": "…"
    }
  ],
  "count": 10,
  "billing": {
    "charged": true
  }
}

Consulta las tareas admitidas en los catálogos públicos

Consulta las tareas, entradas, precios y disponibilidad en los catálogos. El catálogo compacto de EveryData muestra lo esencial de cada acción; el completo incluye parámetros opcionales, límites y campos de respuesta. Actualiza los precios y la disponibilidad cuando los necesites en lugar de fijarlos en el código.

Producto	Endpoint del catálogo	Contenido
EveryData	GET /api/v1/social/catalog?compact=1	Plataformas, acciones, parámetros obligatorios, modos de entrega, disponibilidad y precios
EverySearch	GET /api/v1/search/tools	Herramientas de búsqueda, contratos de solicitud, niveles y precios
EverySolve	GET /api/v1/captcha/types	Tipos de CAPTCHA, parámetros, formatos de solución, disponibilidad y precios
Modelos de texto	GET /api/v1/models	Identificadores públicos de modelos admitidos por el endpoint compatible con OpenAI

Autenticación

Envía la clave API como token Bearer. La autenticación se realiza antes de validar los parámetros: una solicitud sin clave válida recibe un 401, no detalles sobre los parámetros. No incluyas claves en código del navegador, registros ni repositorios públicos.

Crea claves distintas para cada entorno o carga de trabajo.
Rota una clave desde la consola si cambia su alcance o se ve expuesta.
Aplica las restricciones de la consola para limitar una clave a líneas de producto, funciones o rangos de IP concretos.

POST /api/v1/social

EveryData

Recopila datos de 87 plataformas con 387 acciones admitidas. Elige una plataforma y una acción, y proporciona las entradas que requiere.

GET /api/v1/social/catalog?compact=1

POST /api/v1/search

EverySearch

Elige entre 17 herramientas para buscar en la web y recuperar textos originales. Indica el identificador de la herramienta y sus entradas obligatorias.

GET /api/v1/search/tools

POST /api/v1/captcha

EverySolve

Resuelve 53 tipos de CAPTCHA mediante un endpoint. Indica el campo type y las entradas obligatorias. Solo se factura la entrega correcta; los intentos fallidos se reembolsan.

GET /api/v1/captcha/types

POST /api/v1/chat/completions

Procesamiento de texto con Gemini

Limpia, clasifica, resume o extrae información de textos. Usa el formato de solicitud compatible con OpenAI y un identificador de modelo del catálogo público.

GET /api/v1/models

Valida los parámetros de la solicitud

Los parámetros desconocidos devuelven un 422 con la lista de parámetros admitidos y, cuando es posible, una sugerencia de nombre similar. Los valores enumerados no válidos devuelven los valores permitidos. Los parámetros no se ignoran ni se sustituyen por valores predeterminados sin avisar.

Usa los nombres de parámetros en snake_case del catálogo.
Trata did_you_mean como una ayuda para corregir la solicitud, no como una sustitución ya realizada.
Antes de enviar una lista de objetivos, revisa las reglas de facturación y los límites del catálogo.

Identificadores de modelos de texto compatibles con OpenAI

El catálogo público incluye 7 identificadores: gemini-3.6-flash, gemini-3.5-flash, gemini-3.5-flash-thinking, gemini-3.5-flash-thinking-lite, gemini-auto, gemini-flash-lite y gemini-3.1-pro. Envía uno de estos valores en el campo model. Consulta GET /api/v1/models antes de fijar un identificador en un cliente de larga duración.

El endpoint público devuelve respuestas de texto sin streaming.
Vuelve a enviar los mensajes anteriores cuando tu aplicación necesite contexto conversacional.
Divide los documentos en el cliente si superan los límites del modelo indicados en el catálogo o la documentación.

gemini-3.6-flashgemini-3.5-flashgemini-3.5-flash-thinkinggemini-3.5-flash-thinking-litegemini-autogemini-flash-litegemini-3.1-pro

MCP para agentes de IA

Usa MCP para que un cliente compatible descubra y llame directamente a las herramientas de EveryInfra. El servidor MCP cubre datos, búsqueda, CAPTCHA y modelos de texto, con las mismas reglas de autenticación, facturación, límites, validación y reembolsos que REST.

Configura la URL del servidor remoto y una clave API de EveryInfra en el cliente.
Consulta las funciones disponibles antes de una llamada de datos, búsqueda, CAPTCHA o texto.
Guarda la clave API en la configuración de secretos o del entorno del cliente.

Endpoint: POST /mcp
Transporte: Streamable HTTP, sin estado
Herramientas: Los nombres de herramientas del espacio everyinfra_* forman parte del contrato público de los clientes.

Entiende los cobros y los reembolsos

Consulta en el catálogo público el precio y la unidad de facturación de cada función. Cada respuesta registra el importe cobrado. En los productos facturados por entrega correcta, cualquier importe descontado por un resultado fallido o vacío se devuelve automáticamente.

No conviertas unidades internas del saldo a moneda en tu cliente.
Muestra la moneda y los importes devueltos por la API y úsalos para conciliar los cobros.
Los reembolsos por una entrega fallida vuelven automáticamente al saldo de la cuenta.

Tratamiento de errores

Lee el estado HTTP y el cuerpo del error juntos. Los errores de validación indican qué entradas corregir. Antes de reintentar, comprueba qué falló y si repetir la solicitud podría duplicar una acción.

Estado	Significado	Qué hacer
401	Clave API ausente, no válida o desactivada	Comprueba el token Bearer y el estado de la clave.
402	Saldo insuficiente	Añade saldo o reduce el alcance de la solicitud.
404	Ruta o recurso desconocido	Comprueba el endpoint y el identificador del recurso.
422	Parámetro, valor, plataforma, acción o tipo no válido	Consulta los valores admitidos y `did_you_mean` en la respuesta.
429	Límite de frecuencia alcanzado	Espera antes de reintentar y respeta el límite de la clave.
5xx	No se pudo completar la solicitud	Registra el identificador de la solicitud y reintenta solo cuando corresponda.

¿Necesito una clave API para consultar los catálogos?

No. Puedes consultar los catálogos públicos antes de registrarte. Las llamadas autenticadas sí necesitan una clave API Bearer válida.

¿MCP y REST son productos distintos?

No. MCP es otra forma de acceder a las funciones de datos, búsqueda, CAPTCHA y procesamiento de texto de EveryInfra. Comparte con REST sus reglas de autenticación, facturación, validación, límites y reembolsos.

¿Se puede ignorar un parámetro no admitido?

No. Los parámetros desconocidos devuelven un 422 con los valores admitidos y, cuando se puede determinar, una sugerencia de nombre similar.