Search and lookup advertisers or affiliate programs
Operation
GET
/advertisers
AI-friendly advertiser search with intelligent matching, domain lookup, and comprehensive filtering. In user-facing language, advertisers may also be referred to as affiliate programs or merchants. Prefer q or query for free-form requests like 'find Alo Yoga affiliate programs'. When a client needs to answer a specific question about one advertiser/program, it should identify the record here and then call the advertiser detail endpoint.
listAdvertisers
·
Tags: Advertisers
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
q
|
query | No | string | Preferred free-form advertiser or program query. Accepts names, domains, URLs, tags, and related advertiser keywords, including noisy natural-language lookup. |
query
|
query | No | string | Alias for q. |
name
|
query | No | string | Explicit advertiser text filter |
domain
|
query | No | string | Domain filter (supports partial matching) |
url
|
query | No | string | Full URL filter |
network
|
query | No | string | Network name filter |
network_slug
|
query | No | string | Network slug filter |
country
|
query | No | string | Country filter (ISO code or name) |
vertical
|
query | No | string | Vertical filter |
status
|
query | No | string | Advertiser status filter |
with_deals
|
query | No | boolean | When true, only return advertisers that currently have deals. |
sort_by
|
query | No | string | Searchkick sort field |
sort_order
|
query | No | string | Searchkick sort direction |
limit
|
query | No | integer | Upper bound for page size |
cursor
|
query | No | string | Cursor for pagination |
page
|
query | No | integer | Page number |
per_page
|
query | No | integer | Results per page |
dry_run
|
query | No | boolean | Test request without making changes |
Request Body
No request body is defined for this operation.
Responses
Content Types
application/json
{
"description": "List of advertisers with enhanced metadata. Offset pagination returns `meta`; cursor pagination returns `pagination`.",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AdvertiserListItem"
}
},
"meta": {
"$ref": "#/components/schemas/AdvertiserOffsetMeta"
}
},
"required": [
"data",
"meta"
]
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AdvertiserListItem"
}
},
"pagination": {
"$ref": "#/components/schemas/AdvertiserPagination"
}
},
"required": [
"data",
"pagination"
]
}
]
}
}
}
}{
"$ref": "#/components/responses/BadRequest"
}{
"$ref": "#/components/responses/Unauthorized"
}{
"$ref": "#/components/responses/RateLimited"
}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 |
|---|---|---|---|
| Search and lookup advertisers or affiliate programs | GET |
/api/v1/advertisers |
OpenAPI operationId: listAdvertisers. |
GET /api/v1/advertisers
OpenAPI
Search and lookup advertisers or affiliate programs