Docs menuSearch Free

API reference

Search Free

POST /search/free · Search

View .md

POSThttps://api.clawifi.dev/search/free1 credit 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.
  • Hosted MCP tool: search_free on https://api.clawifi.dev/mcp.
  • Credits: 1 per call (search, plain fetch/scrape, article extract, package/dataset/code/archive/academic lookup, single OSINT lookup, social reads). Every price is on Pricing and credits.

Request#

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

Body

FieldTypeDefaultRequired
allow_browser_fallbackbooleanfalseno
countrystring (optional)no
exclude_domainsarray of stringno
include_domainsarray of stringno
languagestring (optional)no
max_resultsinteger10no
providerstring (one of 15 values; see Sources)"free_auto"no
querystringyes
time_range"day" | "week" | "month" | "year" (optional)no

Response#

200 with a SearchFreeResponse object: browser_fallback_allowed, errors, filters_applied, paid_providers_used, provider, providers_tried, query, rate_limited, result_count, results, retry_after, success.

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

Was this page helpful? Tell us · Last updated 2026-10-22