Aller au contenu
NouveautésNouveau

Voici Search

Search
Une recherche sur le fonctionnement des pompes à chaleur par grand froid sur POST /v1/search : trois pages avec le logo du site et leur score, le passage de la première avec la partie qui répond surlignée, et la précision sur FRAMES : 68,5 % avec Pro Search et 66,5 % avec Search

Donnez la recherche web à votre agent en un seul appel : chaque résultat arrive avec les passages de sa page qui répondent à la requête, pour 0,5 crédit la recherche.

Ce que vous obtenez

  • results : jusqu’à 10 pages pour la requête, classées par score, chacune avec url, title, snippet et une pertinence score de 0 à 1.
  • text : les passages de chaque page qui répondent à la requête, jusqu’à 10 000 caractères par résultat, prêts à passer à votre modèle.
  • publishedDate et siteName quand la page les déclare.
  • L’outil web_search du serveur MCP de querying.ai, au même prix, pour Claude Code, Codex, Cursor et les autres clients MCP.

Fonctionnement

Envoyez une requête à POST /v1/search : la requête reste ouverte jusqu’à ce que les résultats arrivent dans la même réponse. Votre agent obtient son contexte en une seule requête et se passe du second appel pour récupérer chaque page.

type choisit la recherche. standard est la valeur par défaut. pro couvre une plus grande part du web et choisit les passages avec plus de soin pour les questions qui demandent plusieurs sources, et répond en quatre secondes environ. Les opérateurs de requête affinent les deux : site:, -site:, after: et before:. Une recherche encore en cours après 30 secondes renvoie sa tâche, et ses résultats se lisent sur GET /v1/async/task/{id}.

Sur 200 questions FRAMES le 15 novembre 2026, un modèle qui répondait à partir des seuls résultats de Search avait juste dans 66,5 % des cas, et dans 68,5 % avec Pro Search. La méthode et la comparaison complète sont sur la page Search : https://querying.ai/agent-search

Précision des réponses sur FRAMES selon le prix pour 1 000 recherches : querying.ai Search 66,5 % à 0,50 $, Pro Search 68,5 % à 2,00 $, Parallel fast 63,5 % à 1,00 $, Parallel advanced 70,0 % à 5,00 $, Exa 68,0 % à 7,00 $, Tavily basic 48,5 % à 5,00 $, Tavily advanced 53,5 % à 10,00 $, Firecrawl 43,5 % à 1,20 $
Coût de 1 000 réponses correctes sur 100 questions d’actualité d’entreprise : 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 $

Cas d’usage

  • Donnez à un agent de code ou de recherche la recherche web avec le texte des pages, en un seul appel d’outil.
  • Appuyez les réponses d’un chatbot sur des pages à jour et affichez l’url de chaque passage comme source.
  • Limitez une recherche à des sites de confiance avec includeDomains, ou aux pages récentes avec after:.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête 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 } }
  }'

Champs de la requête

querystringObligatoire
La recherche, jusqu’à 400 caractères. Accepte les opérateurs site:example.com, -site:example.com, after:YYYY-MM-DD et before:YYYY-MM-DD.
typestring
standard ou pro. pro cherche plus loin pour les questions qui demandent plusieurs sources. Par défaut standard.
numResultsinteger
Le nombre de résultats renvoyés, de 1 à 10. Par défaut 5.
contents.text.maxCharactersinteger
Le nombre de caractères du texte de la page que porte chaque résultat dans text, de 200 à 10 000. Par défaut 2 000.
userLocationstring
Code pays à deux lettres, pour des résultats d’un seul marché. Laissez-le vide pour la recherche la plus rapide, dans la langue de la requête.
includeDomainsarray
Jusqu’à 20 noms d’hôte. Les résultats viennent uniquement de ces sites et de leurs sous-domaines.
excludeDomainsarray
Jusqu’à 20 noms d’hôte dont les résultats sont écartés.
idempotencyKeystring
Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

La réponse, raccourcie pour la lecture.

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, puis COMPLETED avec la réponse ou FAILED avec error.
credits.creditsChargedinteger
Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.
response.resultsarray
Les pages par score, chacune avec url, title, snippet, text et score, plus publishedDate et siteName quand la page les déclare.
response.results[].textstring
Les passages de la page qui répondent à la requête, dans l’ordre de la page, avec les titres en lignes # et les éléments de liste en lignes -.
response.results[].scorenumber
Pertinence de 0 à 1, comparable au sein d’une même réponse.

Tarif

Les crédits sont décomptés quand la recherche se termine : 0,5 pour une recherche standard et 2 pour une recherche pro. Sur le plan Max, 1 000 recherches standard coûtent 0,50 $. Un nouveau compte démarre avec 500 crédits gratuits, soit 1 000 recherches standard. Les plans sont sur https://querying.ai/pricing .

Autres nouveautés

Recevez les nouveautés

Recevez les mises à jour par e-mail.

Flux RSS