AdRevila for developers.

The same pipeline behind the web app, exposed as four REST endpoints. Bearer auth, JSON by default, Markdown or PDF on demand.

Hello world

bash
curl -X POST https://adrevila.com/api/v1/analyses \
  -H "Authorization: Bearer pat_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.facebook.com/ads/library/?id=971390442080128"}'

# → 201 Created
# {
#   "id": "0190d2c1-8f3e-7000-bbaa-12cd34ef5678",
#   "status": "queued",
#   "estimatedSeconds": 90,
#   "links": { "self": "/api/v1/analyses/0190d2c1-..." }
# }

What's included

  • POST /api/v1/analyses — submit a URL, get an id to poll
  • GET /api/v1/analyses — paginated list of completed analyses
  • GET /api/v1/analyses/{id} — fetch as JSON, Markdown, or PDF (via Accept header)
  • GET /api/v1/credits — current credit balance

Not in v3

No webhooks, GraphQL, bulk submit, per-token scopes, or official SDKs (npm, pypi). We'll add them in v4 once we know which ones real callers actually want.

Higher rate limits, a custom integration, or a feature request? Email hello@adrevila.com.