Overview
The GoKart Singular Cost Reporting API provides aggregated daily campaign performance data that can be consumed by Singular or other third-party reporting systems.
This API is primarily intended for:
Singular's integrations team when configuring a custom data connector for an integrated partner using GoKart as their offer management and tracking platform.
Advertiser developers who wish to retrieve daily cost reporting data directly from GoKart.
Reporting and analytics platforms that need access to campaign-level spend and click metrics.
The endpoint returns daily aggregated performance data for the authenticated advertiser account, including campaign information, cost, and click metrics.
Important:
To ensure cost data is successfully returned, you must follow the instructions here to enable Singular cost reporting.
Authentication
All requests must include an Advertiser API token in the Authorization header, which GoKart uses to identify your integration system.
Request Header:
Authorization: ApiToken {your-token}Replace {your-token} with the actual token provided by GoKart.
Follow these instructions to generate your Advertiser API Key
Request URL - JSON
https://api.TENANT.getgokart.ai/api/v1/integrations/cost-
report/singular/json?date_from=2024-01-22&date_to=2025-01-22
Request Schema
Field | Type | Description | Example |
| DateTime | The start date for the report. | "2024-01-01" |
| DateTime | The end date for the report. | "2024-01-31" |
Response Fields
Field | Type | Description | Example |
| string | The user facing name of the offer. | "Test" |
| Guid | ID of the publisher associated with the offer. | "7df30136-..." |
| string | The name of the app. | "Test" |
| string | App store ID | com.test |
| string | The advertiser’s name of the offer. | AOS_TEST_2025 |
| Guid | Unique identifier for the offer. | "7df30136-..." |
| decimal | Total revenue generated by the offer. | 69 |
| decimal | Total clicks generated by the offer. | 100 |
Example Response
"data": {
"generatedAt": "2025-05-28T03:06:28.565Z",
"items": [
{
"date": "2025-05-28",
"offer_name": "string",
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"app": "string",
"store_id": "string",
"os": "IOS",
"campaign_name": "string",
"campaign_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cost": 0,
"clicks": 0
}