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
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 .
Suivez le modèle qui répond, chaque champ de la réponse et les changements de chaque jour sur ChatGPT, Gemini, Google AI Overviews et Google AI Mode, sur une page publique et une API gratuite.
Interrogez Bing AI Mode, aussi appelé Bing Copilot Search, dans 11 pays et recevez sa réponse avec les pages lues, les lieux cités et les produits sponsorisés affichés au-dessus.