Authentication

All requests must include your API key as a query parameter:

?api_key=YOUR_API_KEY

Base URL: https://api.ampleleads.io/v1

Get your API key: https://app.ampleleads.io/api-keys

Examples

Bash

# GET: list runs
curl "https://api.ampleleads.io/v1/apollo/runs?api_key=YOUR_API_KEY&limit=50&offset=0"

# POST: start a scrape
curl -X POST "https://api.ampleleads.io/v1/apollo/scrape?api_key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"apollo_url":"https://app.apollo.io/#/people?...","fetch_count":200,"file_name":"Test"}'

Errors

• 401 Unauthorized — missing/invalid api_key
• 403 Forbidden — key inactive/revoked (if applicable)

Security

Keep keys secret, rotate if exposed, and use separate keys per environment.