Regulad document

Use API tokens to authenticate requests to the reporting API. Keep them secret - anyone with a token can act on your behalf.

How to use your token

Call the reporting endpoint with your token to pull ad performance data.

1. Authenticate

Send your token in the Authorization header on every request.

Authorization: Bearer YOUR_API_TOKEN

2. Endpoint

GEThttps://api.regulad.com/api/v1/report

Param	Required	Description
from	Yes	Start date, format YYYY-MM-DD
to	Yes	End date, format YYYY-MM-DD

3. Example request

curl -X GET "https://api.regulad.com/api/v1/report?from=2026-06-01&to=2026-06-19" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

4. Example response

Each entry in report represents one ad zone, on one day, broken down by country.

{
  "report": [
    {
      "date": "...",
      "app_id": "...",
      "app_key": "...",
      "app_name": "...",
      "zone_name": "...",
      "zone_type": "...",
      "zone_id": "...",
      "country": "...",
      "requests": "...",
      "impressions": "...",
      "response": "...",
      "viewability": "...",
      "clicks": "...",
      "revenue": ...,
      "ecpm": ...,
      "fill_rate": "..."
    }
    // ...one object per zone / country / day
  ]
}

5. Field reference

Field	Meaning
requests	Ad requests sent to the network
response	Requests that got an ad back
impressions	Ads actually shown to a user
fill_rate	impressions ÷ requests, as a percentage
ecpm	Effective revenue per 1,000 impressions
revenue	Earnings in USD for that row