Gamob API Documentation

Gamob Conversion Reports Guide

Document updated 30.07.2026

Gamob Conversion Reports

Overview

The Gamob environment provides a dedicated API endpoint for downloading daily conversion reports.

It uses the same authentication mechanism as the EA RSOC reports API (/api/get-report): a single Organization token authorizes both endpoints, and each endpoint only ever returns data for the traffic sources (tspid) linked to your token.


API Request Specification

The API provides the reports in JSON format.

Headers

Content-Type: application/json
Authorization: <YOUR_API_TOKEN>

Request Body Schema

{
  "startDate": "string (YYYYMMDD)",
  "endDate": "string (YYYYMMDD)"
}

Request Parameters

Parameter Type Required Description Example
startDate string No Start date in YYYYMMDD format (PST timezone). Defaults to today "20260728"
endDate string No End date in YYYYMMDD format (PST timezone). Defaults to today "20260729"

Request Example

{
  "startDate": "20260728",
  "endDate": "20260729"
}

Response Specification

Success Response (200)

The response is returned as base64-encoded gzip-compressed JSON.

Response Headers

Content-Type: application/json
Content-Encoding: gzip
Access-Control-Allow-Origin: *

Response Body Schema

{
  "data": [
    {
      "date": "string (YYYYMMDD)",
      "tspid": "string",
      "country": "string",
      "device_type": "string",
      "earnings": "float",
      "clicks": "integer",
      "impressions": "integer",
      "ad_requests": "integer"
    }
  ],
  "report_info": {
    "start_date": "string (YYYYMMDD)",
    "end_date": "string (YYYYMMDD)",
    "use_commission": "boolean",
    "total_records": "integer",
    "total_earnings": "float",
    "earnings_<tspid>": "float"
  }
}

Response Fields

Field Type Description
data array Array of daily report records
data[].date string Report date in YYYYMMDD format (PST)
data[].tspid string Traffic Source Partner ID
data[].country string Country code (may be empty)
data[].device_type string Device type (may be empty)
data[].earnings float Earnings for the record
data[].clicks integer Number of ad clicks
data[].impressions integer Number of ad impressions
data[].ad_requests integer Number of ad requests
report_info.use_commission boolean Whether earnings are commission-adjusted (default true)
report_info.start_date string Requested start date
report_info.end_date string Requested end date
report_info.total_records integer Total number of records returned
report_info.total_earnings float Total earnings across all records
report_info.earnings_<tspid> float Earnings for a specific TSPID

Error Responses

400 Bad Request

{
  "error": "string",
  "timestamp": "string (ISO 8601)"
}

401 Unauthorized

{
  "error": "Unauthorized",
  "timestamp": "string (ISO 8601)"
}

Keep in mind


Authorization

Authentication Method

The API uses token-based authentication via the Authorization header with token.

The same Organization token works for both the EA RSOC reports endpoint (/api/get-report) and this Gamob endpoint. A single token can support multiple tspid of the same Organization, and separate tokens can be generated per tspid if you need to isolate your traffic reports. Contact support to obtain your token.

Authorization Examples

cURL Example (Linux/Mac)

curl -X POST "https://expldata.com/api/get-gamob-report" \
-H "Authorization: **Your token should be here** " \
-H "Content-Type: application/json" \
-d '{
  "startDate": "20260728",
  "endDate": "20260729"
}'

Python Example

import requests
import json
import base64
import gzip

url = "https://expldata.com/api/get-gamob-report"
headers = {
    "Authorization": " **Your token should be here** ",
    "Content-Type": "application/json"
}

data = {
    "startDate": "20260728",
    "endDate": "20260729"
}

response = requests.post(url, json=data, headers=headers)

if response.status_code == 200:
    # Get the base64-encoded response body
    response_data = response.json()
    # Decode base64 and decompress gzip
    compressed_data = base64.b64decode(response_data)
    json_data = gzip.decompress(compressed_data)
    result = json.loads(json_data)
    print("Report:", result)
else:
    print(f"Error: {response.status_code}, {response.text}")

Example Response

{
    "data": [
        {
            "date": "20260728",
            "tspid": "tsp12",
            "country": "",
            "device_type": "",
            "earnings": 25.114,
            "clicks": 42,
            "impressions": 96,
            "ad_requests": 104
        },
        {
            "date": "20260729",
            "tspid": "tsp12",
            "country": "",
            "device_type": "",
            "earnings": 0,
            "clicks": 0,
            "impressions": 0,
            "ad_requests": 0
        }
    ],
    "report_info": {
        "start_date": "20260728",
        "end_date": "20260729",
        "use_commission": true,
        "total_records": 2,
        "total_earnings": 25.114,
        "earnings_tsp12": 25.114
    }
}