API de plataforma de EveryData
API de Búsqueda web
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 1
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Búsqueda web por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchEncontrar fuentes web a partir de una consulta Pasa la consulta en | keyword | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | title · url · text · rank · published_at · image_url |
¿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.
¿Qué significan los parámetros de Búsqueda web search?
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.
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 completaGoogle 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
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 devuelto si la acción es asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
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 de origen contengan 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.