Raptive Creator API
The Raptive Creator API provides programmatic access to creator site reporting data.
Use the API to bring Raptive earnings, traffic, and performance metrics into your own reporting tools and automated workflows. Requests are scoped to the sites and Raptive Dashboard permissions available to the dashboard user who created the API credential.
The base URL is:
https://publisher-api.raptive.com/creator-api/v1
Get Started
- For automated clients, start with the Quick Start for API Clients.
- Create API credentials and request an access token.
- List eligible sites to find
the
siteIdvalues your credential can access. - Check available date ranges before requesting reporting data.
- Call the reporting endpoint that matches the metric view you need.
What You Can Build
- Internal dashboards that combine Raptive earnings with other business metrics.
- Scheduled exports for analytics warehouses, spreadsheets, or BI tools.
- Content performance reporting for top pages, categories, countries, and traffic sources.
- Monitoring jobs that compare RPM, pageviews, sessions, and earnings over time.
Known Limitations
The Creator API does not currently provide:
- Dashboard summary widgets, portfolio-level reporting, or Raptive Compass insights.
- Additional earnings breakdowns such as device, ad unit, ad network/source, monetized RPM, video player earnings, or dashboard export files.
- Additional traffic breakdowns such as social network, top videos, or dashboard export files.
- Content Optimization and SEO data.
- Catalyst and Community analytics data.
- Payments, Ad Preferences, and Account Settings.
- Video library and playlist editing.
Creator API Capabilities may be expanded in the future. In the meantime, use the Raptive Dashboard for those views and workflows until dedicated Creator API endpoints are available.
API Reference
| Endpoint | Use it for |
|---|---|
GET /creator-api/v1/sites | Sites the credential can access through the Creator API. |
GET /creator-api/v1/sites/{siteId}/date-bounds | Available analytics and earnings date ranges for a site. |
Traffic
| Endpoint | Use it for |
|---|---|
GET /creator-api/v1/sites/{siteId}/traffic/summary | Traffic summary with pageviews, sessions, pages per session, bounce rate, and GA4 availability metadata. |
GET /creator-api/v1/sites/{siteId}/traffic/by-device | Traffic by device. |
GET /creator-api/v1/sites/{siteId}/traffic/by-source | Traffic by raw source. |
GET /creator-api/v1/sites/{siteId}/traffic/by-country | Traffic by country. |
GET /creator-api/v1/sites/{siteId}/traffic/pages | Paginated page title traffic. |
Performance
| Endpoint | Use it for |
|---|---|
GET /creator-api/v1/sites/{siteId}/earnings | Site performance overview with earnings, pageviews, sessions, RPM, and RPS. |
GET /creator-api/v1/sites/{siteId}/pages/performance | Performance by page. |
GET /creator-api/v1/sites/{siteId}/traffic-sources/performance | Performance by traffic source. |
GET /creator-api/v1/sites/{siteId}/countries/performance | Performance by country. |
GET /creator-api/v1/sites/{siteId}/categories/performance | Performance by content category. |
For request formatting and behavior details, see pagination and filtering, date ranges, and errors.