curl -X POST https://server.anyhunt.app/api/v1/scrape \
  -H "Authorization: Bearer ah_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "formats": ["markdown"]
  }'

Response Format

All API responses follow standard HTTP semantics:

Success Response (raw JSON)

{
  // Response data
}

Error Response (RFC7807)

{
  "type": "https://anyhunt.app/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable error message",
  "code": "ERROR_CODE",
  "requestId": "req_123"
}

Common Error Codes

Code	Status	Description
`UNAUTHORIZED`	401	Missing or invalid API key
`RATE_LIMITED`	429	Too many requests
`QUOTA_EXCEEDED`	429	Monthly quota exhausted
`INVALID_URL`	400	URL format is invalid
`URL_NOT_ALLOWED`	400	URL blocked by SSRF protection
`PAGE_TIMEOUT`	504	Page took too long to load
`BROWSER_ERROR`	500	Browser error occurred

Rate Limits

Rate limits are applied per API key:

Plan	Requests/minute	Concurrent
Free	10	2
Basic	30	5
Pro	60	10
Team	120	20

When rate limited, you'll receive a 429 response with rate limit headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705320600
Retry-After: 30

Webhooks

For long-running operations (Crawl, Batch Scrape), you can configure webhooks to receive notifications:

{
  "event": "crawl.completed",
  "data": {
    "id": "crawl_abc123",
    "status": "COMPLETED",
    "totalPages": 150,
    "completedPages": 150
  },
  "timestamp": "2024-01-15T10:30:00.000Z"
}

See individual API documentation for webhook configuration details.

API Reference

Scrape API

Crawl API

Map API

Batch Scrape API

Extract API

Search API

On this page