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

1. For automated clients, start with the Quick Start for API Clients.
2. Create API credentials and request an access token.
3. List eligible sites to find the siteId values your credential can access.
4. Check available date ranges before requesting reporting data.
5. 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 ad network/source, monetized RPM, or dashboard export files.
• Additional traffic breakdowns such as social network, top videos, or dashboard export files.
• Content Optimization and SEO data.
• Content brief status in page performance responses. This field is deferred until SEO data is added to the Creator API.
• 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 totals and daily pageviews/sessions, engagement metrics, and GA4 availability.
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}/ad-units/performance	Earnings, impressions, eCPM, and viewability by ad unit and device.
GET /creator-api/v1/sites/{siteId}/video/earnings	Video earnings and impressions per pageview over time, with a player breakdown.
GET /creator-api/v1/sites/{siteId}/devices/performance	Earnings, pageviews, sessions, RPM, and RPS by device.
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.