Docs menuScrape Url

API reference

Scrape Url

POST /scrape · Read

View .md

POSThttps://api.clawifi.dev/scrape1 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: scrape_url 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/scrape \
  -H "Authorization: Bearer $CLAWIFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Body

FieldTypeDefaultRequired
artifact_policystring"metadata_only"no
browser_profilestring (optional)no
exclude_tagsarray of stringno
formatsarray of string (one of 10 values; see Sources) or ScrapeFormatOptionno
mode"auto" | "http" | "browser""auto"no
proxy_configstring or object (optional)no
querystring (optional)no
requires_authbooleanfalseno
skip_archivebooleanfalseno
sourceSourceId (optional)no
target_selectorstring (optional)no
timeout_secondsinteger (optional)no
top_kinteger5no
urlstringyes
wait_for_selectorstring (optional)no
wait_until"commit" | "domcontentloaded" | "load" | "networkidle""domcontentloaded"no

Response#

200 with a ScrapeResponse object: artifacts, cache_hit, date_source, diagnostics, errors, fetched_at, final_url, format_results, formats, metadata, mode_used, modified_at, published_at, query_selection, ….

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