Dale a tu agente búsqueda web en una sola llamada: cada resultado llega con los pasajes de su página que responden a la consulta, por 0,5 créditos la búsqueda.
Qué obtienes
results: hasta 10 páginas para la consulta en orden de puntuación, cada una con url, title, snippet y una relevancia score de 0 a 1.
text: los pasajes de cada página que responden a la consulta, hasta 10.000 caracteres por resultado, listos para pasar a tu modelo.
publishedDate y siteName cuando la página los declara.
La herramienta web_search del servidor MCP de querying.ai, al mismo precio, para Claude Code, Codex, Cursor y otros clientes MCP.
Cómo funciona
Envía una consulta a POST /v1/search y la solicitud queda abierta hasta que los resultados llegan en la misma respuesta. Tu agente obtiene su contexto con una sola solicitud y se ahorra la segunda llamada para descargar cada página.
type elige la búsqueda. standard es la opción por defecto. pro cubre más de la web y elige los pasajes con más cuidado para preguntas que necesitan varias fuentes, y responde en unos cuatro segundos. Los operadores de consulta acotan ambas: site:, -site:, after: y before:. Una búsqueda que sigue en curso a los 30 segundos devuelve su tarea, y sus resultados se leen en GET /v1/async/task/{id}.
Con 200 preguntas de FRAMES el 15 de noviembre de 2026, un modelo que respondía solo con los resultados de Search acertó el 66,5% de las veces, y el 68,5% con Pro Search. El método y la comparación completa están en la página de Search: https://querying.ai/agent-search
Para qué sirve
Da a un agente de código o de investigación búsqueda web con el texto de las páginas en una sola llamada a una herramienta.
Basa las respuestas de un chatbot en páginas actuales y muestra la url de cada pasaje como su fuente.
Limita una investigación a sitios de confianza con includeDomains, o a páginas recientes con after:.
Envía la solicitud
Envía la solicitud con tu clave de API en la cabecera Authorization.
curl -X POST https://api.querying.ai/v1/search \
-H "Authorization: Bearer $QUERYING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "how do heat pumps work in cold climates",
"type": "pro",
"numResults": 3,
"contents": { "text": { "maxCharacters": 500 } }
}'
Campos de la solicitud
querystringObligatorio
La búsqueda, hasta 400 caracteres. Admite los operadores site:example.com, -site:example.com, after:YYYY-MM-DD y before:YYYY-MM-DD.
typestring
standard o pro. pro busca más a fondo para preguntas que necesitan varias fuentes. Por defecto standard.
numResultsinteger
Cuántos resultados devolver, de 1 a 10. Por defecto 5.
contents.text.maxCharactersinteger
Caracteres de texto de la página que lleva cada resultado en text, de 200 a 10.000. Por defecto 2.000.
userLocationstring
Código de país de dos letras, para resultados de un solo mercado. Déjalo fuera para la búsqueda más rápida, en el idioma de la consulta.
includeDomainsarray
Hasta 20 nombres de host. Los resultados llegan solo de estos sitios y sus subdominios.
excludeDomainsarray
Hasta 20 nombres de host cuyos resultados se dejan fuera.
idempotencyKeystring
Tu propio ID para la solicitud. Cada clave crea una sola tarea por cuenta, así que un reenvío sigue siendo una sola tarea.
Respuesta
La respuesta, recortada para que se lea mejor.
JSON
{
"success": true,
"task": {
"id": "…",
"taskType": "SEARCH",
"status": "COMPLETED",
"createdAt": "…",
"latencyMs": 4063
},
"credits": { "creditsToCharge": 2, "creditsCharged": 2 },
"response": {
"query": "how do heat pumps work in cold climates",
"source": "all",
"type": "pro",
"results": [
{
"url": "https://www.carrier.com/us/en/residential/hvac-resources/heat-pumps/cold-climate-heat-pump/",
"title": "Cold Climate Heat Pump Systems | Efficient Heating in Extreme …",
"snippet": "In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it …",
"text": "## Do cold climate heat pumps work?\n\nA heat pump is a versatile, year-round system that heats and cools your home by moving heat energy rather than generating it. In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it indoors.\n\n…",
"score": 1,
"publishedDate": "2026-09-15T11:03:00.000Z"
},
{
"url": "https://www.mitsubishicomfort.com/articles/mythbusters-heat-pumps-for-extreme-cold-climates",
"title": "Heat Pumps in Extreme Cold Climates | Mitsubishi Electric HVAC US",
"snippet": "In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational …",
"text": "## Myth: Heat Pumps Are Only for Mild and Warm Climates\n\nHow do they work? In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational capacity. …",
"score": 0.8333,
"publishedDate": "2026-10-19T12:06:06.108Z"
},
{
"url": "https://homes.rewiringamerica.org/articles/heating-and-cooling/heat-pumps-cold-weather",
"title": "Do heat pumps work in cold climates? - Rewiring America",
"snippet": "…",
"text": "In heating mode, heat pumps go into reverse and pump heat from the air outside your home to the inside. …",
"score": 0.6667
}
]
}
}
task.statusstring
QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.
credits.creditsChargedinteger
Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.
response.resultsarray
Páginas en orden de puntuación, cada una con url, title, snippet, text y score, más publishedDate y siteName cuando la página los declara.
response.results[].textstring
Los pasajes de la página que responden a la consulta, en el orden de la página, con los títulos como líneas # y los elementos de lista como líneas -.
response.results[].scorenumber
Relevancia de 0 a 1, comparable dentro de una misma respuesta.
Precio
Los créditos se cobran cuando la búsqueda termina: 0,5 por una búsqueda standard y 2 por una búsqueda pro. En el plan Max, 1.000 búsquedas standard cuestan $0,50. Una cuenta nueva empieza con 500 créditos gratis, suficientes para 1.000 búsquedas standard. Los planes están en https://querying.ai/pricing .
Sigue el modelo que responde, cada campo de la respuesta y los cambios de cada día en ChatGPT, Gemini, Google AI Overviews y Google AI Mode, en una página pública y una API gratuita.
Pregunta a Bing AI Mode, también llamado Bing Copilot Search, en 11 países y recibe su respuesta con las páginas que leyó, los lugares que nombra y los productos patrocinados que muestra encima.