- finding the topics that map to your category
- previewing how much real demand exists around those topics
- narrowing the audience with filters like seniority, industry, company size, or contact coverage
- saving the audience so it can refresh over time
- exporting or querying the people behind that demand
What Orbit is
Orbit is Leadpipe’s intent audience API. Use it to find people who are actively researching specific B2B or B2C topics, then narrow those audiences with ICP filters such as company, seniority, industry, department, and contact availability. The typical Orbit workflow looks like this:- Browse or search topics
- Preview the audience size
- Save an audience
- Activate it
- Retrieve paginated people data
- Export a CSV when needed
Base URL
Authentication
Authenticated requests can use anX-API-Key header.
Quick start
Endpoint groups
Discovery
| Method | Path | Auth | Purpose |
|---|---|---|---|
GET | /v1/intent/topics/inventory | No | Browse all topics |
GET | /v1/intent/topics/inventory/facets | No | Get filter values with counts |
GET | /v1/intent/topics/search | No | Autocomplete topic search |
Audience management
| Method | Path | Auth | Purpose |
|---|---|---|---|
GET | /v1/intent/audience/filters | x-api-key | Get ICP filter values |
POST | /v1/intent/topics/audience/preview | x-api-key | Preview count and masked samples |
POST | /v1/intent/topics/audience | x-api-key | Get full paginated people data |
GET | /v1/intent/audiences | x-api-key | List saved audiences |
GET | /v1/intent/audiences/{id} | x-api-key | Get one audience |
POST | /v1/intent/audiences | x-api-key | Create an audience |
PATCH | /v1/intent/audiences/{id} | x-api-key | Update, activate, or pause |
DELETE | /v1/intent/audiences/{id} | x-api-key | Delete an audience |
GET | /v1/intent/audiences/{id}/stats | x-api-key | Get fill rates |
POST | /v1/intent/audiences/{id}/export | x-api-key | Export CSV |
GET | /v1/intent/audiences/{id}/runs | x-api-key | List daily runs |
Errors
| Status | Code | Meaning |
|---|---|---|
400 | VALIDATION_ERROR | Invalid request |
401 | AUTHENTICATION_ERROR | Missing or invalid API key |
403 | DRAFT_AUDIENCE | Audience is draft and must be activated first |
403 | NO_INTENT_CREDITS | Plan does not include intent slots |
403 | SLOTS_FULL | All audience slots are in use |
404 | NOT_FOUND | Audience or requested run was not found |
429 | — | Rate limit exceeded |
500 | PROCESSING_ERROR | Query failed |
Rate limits
| Auth mode | Limit |
|---|---|
| Unauthenticated | 2 requests per minute on all intent endpoints |
| Authenticated via API key or Bearer | 200 requests per minute |