API Reference

Authentication

Pass your API key as a bearer token on every request. Create keys in your dashboard.

Authorization: Bearer ac_live_xxxxxxxxxxxxxxxx

POST /v1/scrape

Turn a single URL into markdown and/or schema-guided JSON.

curl -X POST https://api.arrowcrawl.com/v1/scrape \
  -H "Authorization: Bearer $AC_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.amazon.in/dp/B09V3KXJPB",
    "formats": ["markdown", "json"],
    "schema": { "title": "string", "price": "number", "rating": "number" }
  }'

200 OK · 1 credit
{
  "status": "ok",
  "markdown": "# boAt Airdopes 141 ...",
  "json": { "title": "boAt Airdopes 141", "price": 1299, "rating": 4.2 }
}

POST /v1/crawl

Crawl a whole site, following links up to a depth or page limit.

curl -X POST https://api.arrowcrawl.com/v1/crawl \
  -H "Authorization: Bearer $AC_KEY" \
  -d '{ "url": "https://example.com", "max_depth": 3, "limit": 200 }'

POST /v1/search

Search the live web and get ranked, cited results ready for an agent.

curl -X POST https://api.arrowcrawl.com/v1/search \
  -H "Authorization: Bearer $AC_KEY" \
  -d '{ "query": "best wireless earbuds under 2000", "limit": 10 }'

POST /v1/extract

Schema-guided extraction from one or many URLs. Describe the shape, get validated JSON.

curl -X POST https://api.arrowcrawl.com/v1/extract \
  -H "Authorization: Bearer $AC_KEY" \
  -d '{
    "urls": ["https://site.com/a", "https://site.com/b"],
    "schema": { "name": "string", "price": "number", "in_stock": "boolean" }
  }'

POST /v1/marketplace

Rich product extraction for Amazon, Flipkart, Myntra, Nykaa, Meesho and Ajio.

curl -X POST https://api.arrowcrawl.com/v1/marketplace \
  -H "Authorization: Bearer $AC_KEY" \
  -d '{ "marketplace": "amazon_in", "url": "https://amazon.in/dp/B0...", "mode": "rich" }'

POST /v1/meta-ads

Pull the live Facebook & Instagram ad set for any advertiser.

curl -X POST https://api.arrowcrawl.com/v1/meta-ads \
  -H "Authorization: Bearer $AC_KEY" \
  -d '{ "advertiser": "superbottoms", "country": "IN", "active_status": "active" }'

Errors & credits

Failed requests never consume credits. Errors return a standard shape with an HTTP status and a machine-readable code.

402  { "error": "insufficient_credits" }
422  { "error": "invalid_schema", "detail": "..." }
429  { "error": "rate_limited", "retry_after": 12 }