Introduction
Getting Started
- Get invited. Your Delivr contact creates your organization and emails an invitation. Accept it and sign in at app.delivr.ai. Inviting more teammates is self-serve from there.
- Authentication: create an organization API key + secret at
https://app.delivr.ai/{org_id}/settings/api-keys - Account Setup: create a project and pixel
Then pick a path:
Knowledge
Concepts and reference material. No API calls required. Read these first to understand how the platform works.
| Page | Description |
|---|---|
| Person-Level vs Account-Level Intent | How Delivr identifies the person, not just the company |
| How Identity Resolution Works | The pixel-to-person pipeline: cookies, identity graph, enrichment |
| Understanding Resolution Rates | Why your resolution rate looks low and what it actually means |
| Event Types Reference | What each pixel event captures (page views, clicks, scrolls, copies) |
| Building Audience Filters | Filter structure, available fields, operators, and practical examples |
| Reading Parquet Files | How to convert audience downloads to CSV or open in Excel |
| Pixel Platform Compatibility | Which platforms support the pixel, which don't, and how to check |
API Reference
On-Domain Events (Pixel)
Install a pixel on your website and query visitor events in real-time.
Intent Audiences
Create intent-based audiences from our topic catalog and download the results.
Taxonomy
Browse the intent topic catalog (19,500+ topics across 34 categories). Use topic IDs when creating audiences.
UID2 Conversion
Convert SHA-256 hashed emails to UID2 tokens for privacy-compliant advertising.
Guides
Step-by-step recipes for common tasks.
| Guide | Description |
|---|---|
| Create an Intent Audience | End-to-end: browse topics, create, poll, download |
| Export Events to CSV | Paginate and export visitor data to CSV |
| High-Intent Visitors | Daily lead list from pricing/demo page visitors |
| Company Surge Report | Identify companies with increased site activity |
| White Label Pixel Setup | Host the resolution pixel on your own domain |
| Building an Audience Builder UI | Dynamic filter UI using Field Catalog API + Audiences API |
| Pixel Platform Compatibility | Which platforms support pixel installation and identity resolution |
| SPA Pixel Integration | Install the pixel in React, Next.js, Vue, and other single-page apps |
API Hosts
| Host | Used For | Auth |
|---|---|---|
apiv3.delivr.ai | Data APIs: events (v2), audiences, taxonomy, identity lookup | X-Api-Key + X-Api-Secret |
api.delivr.ai | App, project, pixel management (Partner API), field catalog, UID2 conversion | Platform JWT + X-Delivr-Client-ID/Secret |
apiv2.delivr.ai | Legacy. Use apiv3 for all new integrations | (legacy) |
New integrations should use
apiv3.delivr.aiwith an organization API key + secret pair, and the v2 events endpoints (/api/v2/events*). Migrating fromapiv2? See the API Migration Guide. For a full comparison of all three hosts, see the API Host Comparison.
Updated 12 days ago