Saltar al contenido
NovedadesNuevo

Presentamos Search

Search
Una búsqueda sobre cómo funcionan las bombas de calor en climas fríos en POST /v1/search: tres páginas con el logotipo del sitio y su puntuación, el pasaje de la primera con la parte que responde resaltada y la precisión en FRAMES: 68,5 % con Pro Search y 66,5 % con Search

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

Precisión de las respuestas en FRAMES frente al precio por 1.000 búsquedas: querying.ai Search 66,5 % a $0,50, Pro Search 68,5 % a $2,00, Parallel fast 63,5 % a $1,00, Parallel advanced 70,0 % a $5,00, Exa 68,0 % a $7,00, Tavily basic 48,5 % a $5,00, Tavily advanced 53,5 % a $10,00, Firecrawl 43,5 % a $1,20
Coste de 1.000 respuestas correctas en 100 preguntas de noticias de empresas: querying.ai Search $0,51, Parallel fast $1,00, Firecrawl $1,26, querying.ai Pro Search $2,02, Parallel advanced $5,00, Tavily basic $5,10, Exa $7,07, Tavily advanced $10,20

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 .

Más novedades

Recibe las novedades

Recibe las actualizaciones por correo.

Feed RSS