Getting Started with the Reporting API

Use the Reporting API to pull campaign performance metrics directly into your internal tools or dashboards. You'll be able to filter by app, campaign, country, and date — and retrieve breakdowns like impressions, installs, and spend.

Base Endpoint

GET https://reporting.isappcloud.com/advertisers/v1/reports

Required Authentication

All requests require an API token passed in the header:

Authorization: Bearer YOUR_API_TOKEN

Tokens must include the Reporting permission scope
Only Advertiser Managers can generate tokens

What Can You Pull with the Reporting API?

Metrics like: impressions, clicks, launches, installs, spend, completions
Filter by campaign, country, app, package, and more
Group results by day, country, or app (using breakdowns)

See full Available Filters & Metrics

Quick Example Request

curl -X GET \
  "https://reporting.isappcloud.com/advertisers/v1/reports?start_date=2024-05-01&end_date=2024-05-07&metrics=impressions,clicks,spend&breakdowns=day,app_name" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response Format

Choose between json or csv
Default sort is by day and spend (descending)
Use pagination with next links for large datasets

See Understanding API Responses

Rate Limits

Max: 10,000 rows per request
Use pagination for larger results
Too many rapid requests may trigger a 429 Too Many Requests

Making API Requests

Get Campaigns

Get Campaign

Getting Started with Aura APIs

Getting Started with the Campaign API