API de Búsqueda web

Q: ¿Cómo llamo a la API de Búsqueda web?

Envía POST /api/v1/social con `platform` igual a `web`, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

Q: ¿Qué devuelve la API de Búsqueda web?

Devuelve JSON estructurado. Por ejemplo, el esquema de `search` incluye `title`, `text`, `rank` y `published_at`. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.

Q: ¿Qué parámetros son obligatorios?

Depende de la acción. `search` requiere `keyword`.

Busca páginas web por término y devuelve un listado de títulos, URLs y fragmentos para localizar fuentes originales. No confunde el snippet con el texto completo de la página.

rank es la posición dentro de esta respuesta, no una puntuación fija de autoridad. published_at puede faltar o ser impreciso; para citar un hecho importante hay que abrir la URL y comprobar la fuente primaria.

Empieza gratis Ver documentación

Disponibilidad de la plataforma

Salud 24 h: Normal

Normal

Últimos 30 días

Funciones disponibles

Cada acción de Búsqueda web, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.

Capacidad	Qué hace	Por 1.000	Salud en 24 horas
Encontrar fuentes web a partir de una consulta`search`	Pasa la consulta en `keyword`.	$1.39 por 1.000 solicitudes	Normal

Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.

¿Qué acepta cada acción de Búsqueda web?

Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.

Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.

Acción Obligatorios Opcionales Entrega Límite Por 1.000 Campos de respuesta

Acción	Obligatorios	Opcionales	Entrega	Límite	Por 1.000	Campos de respuesta
`search` Encontrar fuentes web a partir de una consulta Pasa la consulta en `keyword`. La respuesta incluye `title`, `url`, `text`, `rank`, `published_at` e imagen cuando existe; `text` es un fragmento que puede variar con la búsqueda. El contrato no declara filtros de idioma o región ni extracción del artículo completo.	`keyword`	`country`, `language`	Entrega síncrona	—	$1.39 por 1.000 solicitudes	title · url · text · rank · published_at · image_url · sub_links

search

Encontrar fuentes web a partir de una consulta

Pasa la consulta en keyword. La respuesta incluye title, url, text, rank, published_at e imagen cuando existe; text es un fragmento que puede variar con la búsqueda. El contrato no declara filtros de idioma o región ni extracción del artículo completo.

keyword

country, language

Entrega síncrona

—

$1.39 por 1.000 solicitudes

title · url · text · rank · published_at · image_url · sub_links

¿Qué significan los parámetros de Búsqueda web `search`?

Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →

keywordObligatorio: Expresión de búsqueda web. Devuelve el título, el enlace y el resumen de los resultados, pero no extrae automáticamente el contenido completo de las páginas. No es un filtro por nombre de plataforma.
Google Search: un snippet no es la página completa — Google define el snippet como una descripción o fragmento del resultado que puede variar con la consulta. El campo `text` no debe presentarse como el texto íntegro de la página; cualquier afirmación debe comprobarse en la fuente original. · Consultada 2026-09-04
countryOpcional: Preferencia de país o región para los resultados, con un código como us. Influye en la relevancia geográfica, no en la ubicación del servidor, y no garantiza que todos los resultados estén en ese país.
languageOpcional: Preferencia de idioma de la interfaz y los resultados, como en o zh-cn. No traduce el contenido de las páginas devueltas.

Cómo usar la API de Búsqueda web

01Consulta el catálogo público y elige una acción de la plataforma.
02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

web_search.sh

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

Preguntas sobre la API de Búsqueda web

¿Cómo llamo a la API de Búsqueda web?

Envía POST /api/v1/social con platform igual a web, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de Búsqueda web?

Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, rank y published_at. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.

¿Qué matiz de la documentación oficial conviene conservar al usar datos de Búsqueda web?

Google define el snippet como una descripción o fragmento del resultado que puede variar con la consulta. El campo text no debe presentarse como el texto íntegro de la página; cualquier afirmación debe comprobarse en la fuente original.

¿Qué parámetros son obligatorios?

Depende de la acción. search requiere keyword.

¿Las acciones de Búsqueda web responden de inmediato?

Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.