Which API Should I Use?
Delivr has two families of APIs that both say "intent" on the label. Pick by what you are holding and what you want back.
Start from what you have
| You have | You want | Use | Endpoint |
|---|---|---|---|
| A list of emails or LinkedIn URLs | Intent topics per person | Intent lookup | POST /api/v1/intent/lookup (one) or /api/v1/intent/batch (up to 10,000) |
| A list of company domains | Intent topics per company | Company intent | POST /api/v1/intent/company or /api/v1/intent/company/batch |
| A topic | The people researching it | Topic discovery | POST /api/v1/intent/people (add /multi for several topics) |
| A topic | The companies researching it | Topic discovery | POST /api/v1/intent/companies (add /multi for several topics) |
| A topic, and you want a free look first | A capped sample of real records | Previews | POST /api/v1/intent/people/preview, /api/v1/intent/companies/preview |
| Nothing yet; you want a reusable, filtered audience delivered somewhere | A built audience (files, destinations, refreshes) | Intent Audiences API | POST /api/v1/audiences and the Build Audiences guide |
| A pixel on your site | Your own visitors, resolved | Events API | GET /api/v3/events/{tier}, see Identify Site Visitors |
Rule of thumb
- Enriching records you already own (CRM rows, a CSV, a Clay table): intent lookup/batch. Per-row, synchronous, up to 10,000 per call. Start with the Quickstart.
- Finding net-new records from a topic (TAM discovery, list building): the topic-to-people and topic-to-companies endpoints. Paginated with cursors, ranked strongest-first, free previews available.
- Recurring, delivered audiences (weekly file to S3, sync to a destination): the Intent Audiences API. That is a build-and-deliver system, not a synchronous query.
- Your own website traffic: the Events API, which requires the Delivr pixel installed.
Every intent endpoint accepts "dry_run": true for a free, exact cost preview. See Rate Limits and Metering.
Updated about 15 hours ago
Did this page help you?