Research

POSThttps://api.clawifi.dev/research30 credits per call

• Send your key as Authorization: Bearer $CLAWIFI_API_KEY; see Authentication.
• Add "dry_run": true (or ?dry_run=true) to see what the call would cost; nothing runs and nothing is charged.
• Credits: 30 per call (5 per source searched + 10 per page read, at least 30, at most 300). Every price is on Pricing and credits.

Request#

curl -X POST https://api.clawifi.dev/research \
  -H "Authorization: Bearer $CLAWIFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"what is the Model Context Protocol"}'

from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY
result = client.post("/research", json={"query":"what is the Model Context Protocol"})

Body

Response#

200 with a ResearchResponse object: browser_fallback_allowed, errors, lanes, providers_planned, query, result_count, results, searched_count, sources, success, web_provider.

Errors use the shared shape; see Errors. Try public operations without a key in the playground.