Skip to main content

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 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

EndpointUse it for
GET /creator-api/v1/sitesSites the credential can access through the Creator API.
GET /creator-api/v1/sites/{siteId}/date-boundsAvailable analytics and earnings date ranges for a site.

Traffic

EndpointUse it for
GET /creator-api/v1/sites/{siteId}/traffic/summaryTraffic summary with pageviews, sessions, pages per session, bounce rate, and GA4 availability metadata.
GET /creator-api/v1/sites/{siteId}/traffic/by-deviceTraffic by device.
GET /creator-api/v1/sites/{siteId}/traffic/by-sourceTraffic by raw source.
GET /creator-api/v1/sites/{siteId}/traffic/by-countryTraffic by country.
GET /creator-api/v1/sites/{siteId}/traffic/pagesPaginated page title traffic.

Performance

EndpointUse it for
GET /creator-api/v1/sites/{siteId}/earningsSite performance overview with earnings, pageviews, sessions, RPM, and RPS.
GET /creator-api/v1/sites/{siteId}/pages/performancePerformance by page.
GET /creator-api/v1/sites/{siteId}/traffic-sources/performancePerformance by traffic source.
GET /creator-api/v1/sites/{siteId}/countries/performancePerformance by country.
GET /creator-api/v1/sites/{siteId}/categories/performancePerformance by content category.

For request formatting and behavior details, see pagination and filtering, date ranges, and errors.