curl https://api.thrad.ai/v1/publisher/publishers \
-H "thrad-api-key: $THRAD_ORG_KEY"
{
"object": "list",
"data": [
{"object": "publisher", "id": "6f1c2b8e-1d2a-4c3b-9e8f-0a1b2c3d4e5f", "name": "Alpha", "inventory_type": "web"},
{"object": "publisher", "id": "1ce68bf7-91ac-4feb-9fc9-b4f289657e1e", "name": "Beta", "inventory_type": "ios_app"}
]
}
API Reference
Publishers
List the publishers your API key can read, with the ids to pass as publisher_id.
GET
/
v1
/
publisher
/
publishers
curl https://api.thrad.ai/v1/publisher/publishers \
-H "thrad-api-key: $THRAD_ORG_KEY"
{
"object": "list",
"data": [
{"object": "publisher", "id": "6f1c2b8e-1d2a-4c3b-9e8f-0a1b2c3d4e5f", "name": "Alpha", "inventory_type": "web"},
{"object": "publisher", "id": "1ce68bf7-91ac-4feb-9fc9-b4f289657e1e", "name": "Beta", "inventory_type": "ios_app"}
]
}
Returns the publishers an API key can read. Use it to find the
The list isn’t paginated.
publisher_id values for GET /v1/publisher/insights.
- Organization key (
sko_...): every publisher in your organization, sorted by name. - Publisher key (
sk_...): only that key’s own publisher.
Authorizations
string
required
An organization key (
sko_...) or a publisher key (sk_...). Authorization: Bearer <key> is accepted as an alternative. A missing key returns 401 auth_required; an unknown, expired, or revoked key returns 401 invalid_api_key.curl https://api.thrad.ai/v1/publisher/publishers \
-H "thrad-api-key: $THRAD_ORG_KEY"
{
"object": "list",
"data": [
{"object": "publisher", "id": "6f1c2b8e-1d2a-4c3b-9e8f-0a1b2c3d4e5f", "name": "Alpha", "inventory_type": "web"},
{"object": "publisher", "id": "1ce68bf7-91ac-4feb-9fc9-b4f289657e1e", "name": "Beta", "inventory_type": "ios_app"}
]
}
Response
string
Always
"list".array
Errors
Errors use the same bare shape as Insights.| Status | Type | Code | When |
|---|---|---|---|
401 | authentication_error | auth_required | No API key was sent. |
401 | authentication_error | invalid_api_key | The key is malformed, unknown, expired, or revoked. |
429 | rate_limit_error | rate_limit_exceeded | Exceeded the per-key limit of 1000 requests/hour, shared with Insights. |