Schnellstart für die KI-Suchdaten-API

Erstelle einen Schlüssel, sende eine Frage und empfange die Antwort per Abruf oder Webhook.

Task absenden

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer vt_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026" },
    "webhook": { "url": "https://yours.app/hooks/querying" }
  }'

Webhook empfängt

{
  "task": {
    "id": "8f2c1e40-…",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-07-17T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "The best wireless earbuds in 2026 are …",
    "sources": [
      { "position": 1,
        "url": "https://example.com/review",
        "label": "Best earbuds, reviewed" }
    ],
    "timing": { "totalMs": 7400 }
  }
}

1. API-Schlüssel vorbereiten

Erstelle ein kostenloses Konto und erzeuge im Dashboard einen Schlüssel. Speichere ihn in der Server-Umgebungsvariable QUERYING_API_KEY und verwende ihn auf dem Server. Neue Konten erhalten 500 Credits vor dem Hinterlegen eines Zahlungsmittels.

2. Eine Frage senden

Der Befehl sendet eine Frage mit der Ländereinstellung DE an Gemini. Die Frage wird in deiner gewählten Sprache übermittelt. Verwende die task.id aus der Annahmebestätigung im nächsten Schritt.

cURL

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "beste kabellose Ohrhörer für den Arbeitsweg",
    "country": "DE"
  }
}'

3. Das fertige Ergebnis abrufen

Ersetze TASK_ID durch die erhaltene ID. Bei QUEUED oder PROCESSING frage nach einer Pause erneut ab. Bei COMPLETED lies response, bei FAILED behandle den Fehler. Rufe das Ergebnis innerhalb von 24 Stunden nach Abschluss ab und speichere es.

cURL

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

4. Ergebnisse per Webhook empfangen

Ergänze webhook.url im JSON und richte einen HTTPS-Empfänger mit der dokumentierten Signaturprüfung ein. Es gibt bis zu 5 Zustellversuche: den ersten Aufruf und 4 Wiederholungen mit wachsender Wartezeit. Verarbeite doppelte Zustellungen anhand von task.id nur einmal.

JSON

{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "beste kabellose Ohrhörer für den Arbeitsweg",
    "country": "DE"
  },
  "webhook": {
    "url": "https://your-server.example.com/querying-webhook"
  }
}

5. Weitere Engines und regelmäßige Messungen

Prüfe taskType, prompt oder query, unterstützte Länder und Antwortstruktur jeder Engine. Behebe Guthaben- oder Parallelitätsprobleme vor einem erneuten Versuch. Speichere einen festen Fragensatz in Monitors, um Markensichtbarkeit über Zeit zu verfolgen.