Reporting

Get publisher report

Daily performance metrics for a single publisher.

GET/api/publishers/:id/report

Returns the same daily rows as Get team report, scoped to one publisher. Look up publisher IDs with List publishers.

Path parameters

Name
id
Type
string
Required
required
Description
The unique identifier of the publisher.

Query parameters

Name
starts_at
Type
string
Required
required
Description
First day of the range as an ISO 8601 date, e.g. 2026-01-01.
Name
ends_at
Type
string
Required
required
Description
Last day of the range as an ISO 8601 date, e.g. 2026-01-31. The range can span at most 90 days.
Name
inventory_types
Type
string[]
Description
Filter metrics by environment: web or app. Separate multiple values with commas, e.g. inventory_types=web,app. Omit to include all traffic. See environment filtering.
Name
slots
Type
string[]
Description
Names of slots to filter to, comma-separated. Omit to include every slot.

Headers

Name
Authorization
Type
string
Required
required
Description
Bearer [YOUR_API_TOKEN], using an API token generated from your Koah dashboard under Settings › API Tokens. Only publisher accounts can access this endpoint.

Response

Name
report
Type
object[]
Description
One entry per day in the range, with the same fields as the team report: date, queries, queries_with_ad, fill_rate, impressions, clicks, ctr, ecpc, ecpm and revenue.

Errors

Status	Error
`400`	`starts_at and ends_at must be valid dates`
`401`	`Unauthorized` — missing or invalid API token
`404`	`Not found` — publisher does not exist
`422`	`Date range must be positive and not exceed 90 days`
`429`	`Rate limit exceeded` — max 10 requests per minute

curl "https://app.koah.ai/api/publishers/string-unique-identifier/report?starts_at=2026-01-01&ends_at=2026-01-31&slots=in-article,homepage-hero&inventory_types=app" \
  -H "Authorization: Bearer [YOUR_API_TOKEN]"

Response

{
  "report": [
    {
      "date": "2026-01-01",
      "queries": 500,
      "queries_with_ad": 320,
      "fill_rate": 64.0,
      "impressions": 320,
      "clicks": 15,
      "ctr": 4.69,
      "ecpc": 0.27,
      "ecpm": 12.5,
      "revenue": 4.0
    }
  ]
}