Neu: Web Scrape

Web Scrape extrahiert den Hauptinhalt einer URL als Markdown für 1 Credit pro abgeschlossener Anfrage.

Was Sie erhalten

• markdown: der Hauptinhalt der Seite mit Überschriften, Absätzen, Listen, Tabellen, Links und Bildern, bereinigt um Kopfzeile, Fußzeile und Navigation der Website.
• title, description, author, publishedAt, siteName, language und image, sobald die Seite sie angibt.
• finalUrl und statusCode: die Adresse nach Weiterleitungen und der Status, mit dem die Website geantwortet hat.
• images: jedes Bild aus markdown in der Reihenfolge seines Auftretens, mit Alternativtext.

So funktioniert es

Senden Sie eine öffentliche http- oder https-URL mit bis zu 2.048 Zeichen. Web Scrape öffnet die Seite, rendert per Skript gezeichnete Seiten wie Produktseiten von Shops vor dem Lesen und behält den Inhalt, für den Leser kommen: Text, Tabellen und Bilder. Das Ergebnis ist sauberes Markdown, bereit zum Speichern, Durchsuchen oder Auswerten.

maxChars legt die Länge fest, von 1.000 bis 200.000 Zeichen (Standard 100.000). Eine lange Seite endet an einem Absatzumbruch und setzt truncated: true. country (Standard US) bestimmt Sprache und Region, für die die Seite angefragt wird. Ein PDF, eine Seite mit 404 oder 410 oder eine Website, die die Anfrage ablehnt, beendet die Aufgabe mit PAGE_UNAVAILABLE, und die Meldung enthält die Antwort der Website.

Einsatzbereiche

• Lesen Sie die Seiten, die KI-Antworten zitieren, und erkennen Sie, welche Inhalte Zitate gewinnen.
• Übergeben Sie einen link aus den GOOGLE_SERP-Ergebnissen, um die rankenden Seiten einer Suche zu lesen.
• Verfolgen Sie Produkt- und Preisseiten von Wettbewerbern als Text, den Sie über die Zeit vergleichen.
• Lesen Sie eine Seite direkt aus Ihrem KI-Assistenten über das MCP-Werkzeug scrape_page.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "WEB_SCRAPE",
    "payload": {
      "url": "https://docs.querying.ai/quickstart",
      "country": "US"
    }
  }'

Felder der Anfrage

taskTypestringPflicht

Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.

payload.urlstringPflicht

Die zu lesende Seite: eine öffentliche http- oder https-Adresse, bis zu 2.048 Zeichen.

payload.maxCharsinteger

Längenlimit für markdown, 1.000 bis 200.000. Standard 100.000. Eine längere Seite endet an einem Absatzende und trägt truncated.

payload.countrystring

Land, aus dem die Seite angefragt wird; es bestimmt Sprache und Region. Standard US.

webhook.urlstring

Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.

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

So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.

{
  "success": true,
  "task": {
    "id": "910017b1-4fd5-4bc7-8895-bbe6b1b0d1df",
    "taskType": "WEB_SCRAPE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:48:34.088Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "url": "https://docs.querying.ai/quickstart",
    "finalUrl": "https://docs.querying.ai/quickstart",
    "statusCode": 200,
    "title": "AI Search Data API Quickstart",
    "description": "Submit a task, receive a result — with webhooks or by polling.",
    "siteName": "querying.ai",
    "language": "en",
    "markdown": "# AI Search Data API Quickstart\n\n[한국어 시작 가이드](https://querying.ai/ko/guides/quickstart) · [API plans and credits](https://querying.ai/en/pricing)\n\n## 1\\. Set your credentials\n\n```shellscript\nexport BASE=\"https://api.querying.ai\"\nexport API_KEY=\"<your-key>\"\n```\n\n…",
    "images": [],
    "truncated": false
  }
}

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.markdownstring

Der Hauptinhalt der Seite als Markdown: Überschriften, Absätze, Listen, Tabellen, Links und Bilder.

response.titlestring

Der Seitentitel, dazu description, author, siteName und language, wenn die Seite sie angibt.

response.publishedAtstring

Das Veröffentlichungsdatum laut Seite, im Format ISO 8601.

response.finalUrlstring

Die Adresse nach Weiterleitungen, mit statusCode.

response.imagesarray

Die Bilder in markdown in Lesereihenfolge, jeweils mit url und alt.

response.truncatedboolean

true, wenn markdown maxChars erreicht hat und an einem Absatzende endet.

Ergebnis abholen

Die Anfrage liefert sofort die Aufgabe mit status QUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis status COMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Preis

Jede abgeschlossene Seite kostet 1 Credit.