Guides

These guides cover the concepts and conventions you'll encounter while working with the Odditt B2B API. If you're looking for a hands-on walkthrough with code examples, start with the Getting Started tutorial in the API Reference section.

Integration Essentials

• Rate Limiting - request limits per minute, hour, and day, and how to handle 429 responses.
• Pagination - navigating paginated results with page and page_size.
• Filtering & Query Parameters - entity filters, flow types, thresholds, operators, and date ranges.
• Response Format & Error Handling - JSON response conventions, HTTP status codes, and common error scenarios.

Discovery & Content

• Segmentation & Tags - discover the tag registry and filter flows by content and metadata tags.
• Affiliate API - the cart, offers, link inventory, and reporting endpoints behind the widget's affiliate mode.

Data Conventions

• External Keys - slug-style identifiers (nfl, nba) for exploration and examples; numeric IDs remain the canonical identifiers for production.
• Localization - get trend narratives in Spanish (Latin America), Italian, or Brazilian Portuguese.
• Caching - how server-side caching works and its effect on polling.
• Versioning - API version stability and deprecation policies.

Security & Access

• Advanced Authentication - JWT tokens, OAuth2 client credentials, and refresh flows.
• Account Management - credentials, secrets, and usage stats.