List advertiser opportunities
GET /opportunities
GET /opportunities
Operation
GET
/opportunities
Returns opportunity advertisers for the caller scope (admin can filter by publisher_id).
Operation ID:
listOpportunities
·
Tags: Advertisers
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
publisher_id
|
query | No | integer | Admin-only publisher filter |
sort
|
query | No | string | Sort field |
order
|
query | No | string | Sort order |
page
|
query | No | integer | — |
per_page
|
query | No | integer | — |
limit
|
query | No | integer | Upper bound for per_page |
Request Body
No request body is defined for this operation.
Responses
Content Types
application/json
{
"description": "Opportunity advertisers",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Opportunity"
}
},
"meta": {
"type": "object",
"properties": {
"current_page": {
"type": "integer"
},
"next_page": {
"type": "integer",
"nullable": true
},
"prev_page": {
"type": "integer",
"nullable": true
},
"per_page": {
"type": "integer"
},
"sort": {
"type": "string"
},
"order": {
"type": "string"
},
"publisher_id": {
"type": "integer",
"nullable": true
}
}
}
}
}
}
}
}{
"$ref": "#/components/responses/Unauthorized"
}API Playground
Run this GET request with your API key, or open it in a new tab. Path uses sample IDs where the OpenAPI path has {parameters}.
Sign in to enable live testing with your API key.
| Action | Method | Endpoint | Description |
|---|---|---|---|
| List advertiser opportunities | GET |
/api/v1/opportunities |
OpenAPI operationId: listOpportunities. |
GET /api/v1/opportunities
OpenAPI
List advertiser opportunities