Credits und Limits: Preise, Reservierungen, Parallelität und Ratenlimits

curl https://api.querying.ai/v1/capabilities

​

Credits pro Task

​

Abrechnung von Citation Analysis

​

Reservieren, abbuchen, freigeben

​

Guthaben abfragen

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

{
  "success": true,
  "remaining": 1879939,
  "perCycle": 1000000,
  "cycleResetsAt": "2026-11-14T07:37:57.000Z",
  "reserved": 61,
  "plan": "max",
  "topUpBalance": { "credits": 1000000, "nextExpiresAt": "2027-01-19T10:01:57.000Z", "nextCredits": 1000000 }
}

• remaining ist, was Sie jetzt ausgeben können. Bereits eingereichte Tasks reservieren ihren Preis in reserved; ziehen Sie ihn nicht noch einmal ab.
• perCycle ist, was Ihr Tarif pro Zyklus gutschreibt, und cycleResetsAt, wann der aktuelle Zyklus endet. Ohne aktiven Tarif sind beide null.
• topUpBalance nennt die aufgeladenen Credits in remaining, das Datum, an dem die nächsten davon verfallen, und wie viele es sind. Ohne aufgeladene Credits ist es null. Aufgeladene Credits gelten drei Monate ab Kauf, bleiben bei Verlängerungen erhalten und werden nach den Credits Ihres Tarifs verbraucht.

​

Verbrauch abfragen

curl "https://api.querying.ai/v1/usage?from=2026-10-01&to=2026-10-20&groupBy=engine" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "from": "2026-10-01",
    "to": "2026-10-20",
    "groupBy": ["engine"],
    "credits": 66.25,
    "tasks": 65,
    "rows": [
      { "taskType": "CHATGPT", "credits": 49, "tasks": 49 },
      { "taskType": "GEMINI", "credits": 6.25, "tasks": 5 },
      { "taskType": "PERPLEXITY", "credits": 11, "tasks": 11 }
    ]
  }
}

• from und to sind UTC-Datumsangaben, beide Tage sind eingeschlossen. Standard sind der erste Tag des laufenden UTC-Monats und heute. Ein Zeitraum umfasst höchstens 366 Tage.
• groupBy nimmt day, engine und key, durch Kommas getrennt, und steht standardmäßig auf day,engine. Eine Zeile enthält die Felder der gewählten Aufteilungen, und eine Kombination ohne Berechnung hat keine Zeile. credits und tasks oben addieren alle Zeilen.
• groupBy=key zeigt, wer die Credits verbraucht hat. Ein mit einem API-Schlüssel gesendeter Task hat "source": "api" und ein apiKey mit id, keyPrefix, name und subAccountId. Verbrauch ohne API-Schlüssel hat source als monitor (die Läufe eines Monitors), playground oder dashboard, und apiKey ist null.
• Der Verbrauch addiert, was Tasks berechnet wurde, und ein fehlgeschlagener Task kostet 0. Die Wettbewerberauswertung eines Monitors wird ohne Task berechnet, senkt also Ihr Guthaben, erscheint aber nicht im Verbrauch.
• Die Tasks Ihrer Unterkonten sind in Ihrem Verbrauch enthalten, und apiKey.subAccountId nennt das Unterkonto, dem ein Schlüssel gehört. GET /v1/sub-accounts/{id}/usage liest ein einzelnes Unterkonto. Der Schlüssel eines Unterkontos erhält 403 SUB_ACCOUNT_FORBIDDEN.

​

Warteschlange abfragen

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

{
  "success": true,
  "queuedTasks": 19,
  "processingTasks": 6,
  "priorityBreakdown": [{ "priority": 8, "count": 3 }, { "priority": 1, "count": 16 }],
  "concurrency": { "used": 25, "max": 200 }
}

• concurrency.used ist queuedTasks plus processingTasks, die beiden Zahlen, die das Parallelitätslimit Ihres Tarifs addiert. max ist dieses Limit, also ist max - used der verbleibende Platz für neue Tasks.
• priorityBreakdown listet die wartenden Tasks nach der beim Einreichen angegebenen priority, höchste zuerst.
• Die Zähler enthalten die Tasks Ihrer Unterkonten, die Ihr Limit teilen. Der Schlüssel eines Unterkontos erhält 403 SUB_ACCOUNT_FORBIDDEN und liest seine eigenen Zähler unter GET /stats.

​

Tarife

​

Parallelität des Tarifs

​

Limits pro Schlüssel und Unterkonto

​

Anfragerate und Gegendruck

​

Große Einreichungen takten