Search deals with AI-friendly filters
GET /deals
GET /deals
Operation
GET
/deals
Advanced deal search for deals, offers, coupons, and promotions. Prefer q or query for free-form lookup, especially for natural-language requests like 'show me exclusive Alo Yoga deals', or use structured filters when you already know the advertiser, network, country, or activity constraints.
Operation ID:
listDeals
·
Tags: Deals
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
q
|
query | No | string | Preferred free-form query. Searches deal names plus indexed advertiser, campaign, and country fields, and can infer simple flags like exclusive or featured from natural language. |
query
|
query | No | string | Alias for q. |
search
|
query | No | string | Explicit deal search text. Prefer q unless you need to force the text-search field. |
advertiser_id
|
query | No | string | Advertiser ID or slug filter |
network_id
|
query | No | string | Network ID or slug filter |
vertical_id
|
query | No | string | Vertical ID filter |
country
|
query | No | string | Country filter (ISO code) |
country_code
|
query | No | string | Alias for country. |
exclusive
|
query | No | boolean | Exclusive deals filter |
active
|
query | No | boolean | Active deals filter |
featured
|
query | No | boolean | Featured deals filter |
status
|
query | No | string | Deal activity status filter. |
limit
|
query | No | integer | Upper bound for per_page. |
page
|
query | No | integer | Page number |
per_page
|
query | No | integer | Results per page |
include_total
|
query | No | boolean | Include exact total counts in the meta payload. |
include_count
|
query | No | boolean | Alias flag used by some list endpoints for count metadata. |
Request Body
No request body is defined for this operation.
Responses
Content Types
application/json
{
"description": "List of deals with enhanced metadata",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Deal"
}
},
"pagination": {
"$ref": "#/components/schemas/Pagination"
},
"meta": {
"type": "object",
"properties": {
"total_count": {
"type": "integer"
},
"summary": {
"type": "object",
"properties": {
"total_deals": {
"type": "integer"
},
"exclusive_deals": {
"type": "integer"
},
"active_deals": {
"type": "integer"
},
"featured_deals": {
"type": "integer"
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"verticals": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"filters_applied": {
"type": "object"
}
}
}
}
}
}
}
}{
"$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 deals with AI-friendly filters | GET |
/api/v1/deals |
OpenAPI operationId: listDeals. |
GET /api/v1/deals
OpenAPI
Search deals with AI-friendly filters