Zum Inhalt springen
NeuigkeitenNeu

Neu: Search

Search
Eine Suche zur Funktionsweise von Wärmepumpen in kaltem Klima über POST /v1/search: drei Seiten mit dem Logo der Website und ihrem Score, die Passage der ersten Seite mit hervorgehobener Antwort und die Genauigkeit auf FRAMES: 68,5 % mit Pro Search und 66,5 % mit Search

Geben Sie Ihrem Agenten Websuche mit einem Aufruf: Jedes Ergebnis kommt mit den Passagen seiner Seite, die die Anfrage beantworten, für 0,5 Credits pro Suche.

Was Sie erhalten

  • results: bis zu 10 Seiten zur Anfrage, nach Score sortiert, jede mit url, title, snippet und einer Relevanz score von 0 bis 1.
  • text: die Passagen jeder Seite, die die Anfrage beantworten, bis zu 10.000 Zeichen pro Ergebnis, bereit für Ihr Modell.
  • publishedDate und siteName, wenn die Seite sie angibt.
  • Das Tool web_search auf dem MCP-Server von querying.ai, zum selben Preis, für Claude Code, Codex, Cursor und andere MCP-Clients.

So funktioniert es

Senden Sie eine Anfrage an POST /v1/search, und die Anfrage bleibt offen, bis die Ergebnisse in derselben Antwort ankommen. Ihr Agent bekommt seinen Kontext mit einer Anfrage und spart sich den zweiten Aufruf, um jede Seite zu laden.

type wählt die Suche. standard ist der Standard. pro deckt mehr vom Web ab, wählt die Passagen für Fragen mit mehreren Quellen sorgfältiger aus und antwortet in etwa vier Sekunden. Suchoperatoren grenzen beide ein: site:, -site:, after: und before:. Eine Suche, die nach 30 Sekunden noch läuft, liefert ihre Aufgabe, und die Ergebnisse lesen Sie über GET /v1/async/task/{id}.

Bei 200 FRAMES-Fragen am 15. November 2026 lag ein Modell, das nur aus den Search-Ergebnissen antwortete, in 66,5 % der Fälle richtig, mit Pro Search in 68,5 %. Methode und vollständiger Vergleich stehen auf der Agent-Search-Seite: https://querying.ai/agent-search

Antwortgenauigkeit auf FRAMES im Verhältnis zum Preis pro 1.000 Suchen: querying.ai Search 66,5 % für $0,50, Pro Search 68,5 % für $2,00, Parallel fast 63,5 % für $1,00, Parallel advanced 70,0 % für $5,00, Exa 68,0 % für $7,00, Tavily basic 48,5 % für $5,00, Tavily advanced 53,5 % für $10,00, Firecrawl 43,5 % für $1,20
Kosten für 1.000 richtige Antworten bei 100 Fragen zu Unternehmensnachrichten: 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

Einsatzbereiche

  • Geben Sie einem Coding- oder Research-Agenten Websuche mit dem Seitentext in einem Tool-Aufruf.
  • Stützen Sie die Antworten eines Chatbots auf aktuelle Seiten und zeigen Sie die url jeder Passage als Quelle.
  • Halten Sie eine Recherche mit includeDomains auf vertrauenswürdigen Websites oder mit after: auf aktuellen Seiten.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header 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 } }
  }'

Felder der Anfrage

querystringPflicht
Die Suche, bis zu 400 Zeichen. Nimmt die Operatoren site:example.com, -site:example.com, after:YYYY-MM-DD und before:YYYY-MM-DD.
typestring
standard oder pro. pro sucht gründlicher für Fragen, die mehrere Quellen brauchen. Standard standard.
numResultsinteger
Wie viele Ergebnisse zurückkommen, 1 bis 10. Standard 5.
contents.text.maxCharactersinteger
Zeichen Seitentext, die jedes Ergebnis in text mitbringt, 200 bis 10.000. Standard 2.000.
userLocationstring
Zweistelliger Ländercode für Ergebnisse aus einem Markt. Lassen Sie ihn weg, sucht die API am schnellsten, in der Sprache der Anfrage.
includeDomainsarray
Bis zu 20 Hostnamen. Ergebnisse kommen nur von diesen Websites und ihren Subdomains.
excludeDomainsarray
Bis zu 20 Hostnamen, deren Ergebnisse herausfallen.
idempotencyKeystring
Ihre eigene ID für die Anfrage. Jeder Schlüssel erzeugt pro Konto genau eine Aufgabe, ein wiederholter Versand bleibt also eine Aufgabe.

Antwort

Die Antwort, für die Lesbarkeit gekürzt.

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, dann COMPLETED mit der Antwort oder FAILED mit error.
credits.creditsChargedinteger
Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.
response.resultsarray
Seiten nach Score sortiert, jede mit url, title, snippet, text und score, dazu publishedDate und siteName, wenn die Seite sie angibt.
response.results[].textstring
Die Passagen der Seite, die die Anfrage beantworten, in Seitenreihenfolge, Überschriften als #-Zeilen und Listenpunkte als --Zeilen.
response.results[].scorenumber
Relevanz von 0 bis 1, vergleichbar innerhalb einer Antwort.

Preis

Credits werden abgebucht, wenn die Suche abgeschlossen ist: 0,5 für eine standard-Suche und 2 für eine pro-Suche. Im Max-Plan kosten 1.000 standard-Suchen 0,50 $. Ein neues Konto startet mit 500 kostenlosen Credits, genug für 1.000 standard-Suchen. Die Pläne stehen unter https://querying.ai/pricing .

Weitere Updates

Auf dem Laufenden bleiben

Erhalte Produktneuigkeiten per E-Mail.

RSS-Feed