Advertiser lookup by hostname
GET /advertisers/search_by_domain
GET /advertisers/search_by_domain
Operation
GET
/advertisers/search_by_domain
Domain-first advertiser lookup. Either `domain` or `url` is required; url is parsed to extract the hostname. Supports both cursor and page pagination.
Operation ID:
searchAdvertisersByDomain
·
Tags: Advertisers
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
domain
|
query | No | string | — |
url
|
query | No | string | — |
limit
|
query | No | integer | — |
cursor
|
query | No | string | — |
page
|
query | No | integer | — |
per_page
|
query | No | integer | — |
Request Body
No request body is defined for this operation.
Responses
Content Types
application/json
{
"description": "Advertisers matching the supplied domain/url (same shape as /domains/search)",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AdvertiserListItem"
}
},
"meta": {
"$ref": "#/components/schemas/DomainSearchMeta"
}
},
"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"
}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 |
|---|---|---|---|
| Advertiser lookup by hostname | GET |
/api/v1/advertisers/search_by_domain |
OpenAPI operationId: searchAdvertisersByDomain. |
GET /api/v1/advertisers/search_by_domain
OpenAPI
Advertiser lookup by hostname