Skip to main content
List all affiliate merchants available in the discovery catalog. Results are paginated and include merchant details, affiliate network associations, and product catalog statistics.

​
Endpoint

GET /v1/discovery/merchants
Requires an x-api-key header.

​
Query Parameters

​
page
integer
Page number. Min: 1. Default: 1.
​
per_page
integer
Results per page. Min: 1, Max: 100. Default: 25.
​
cursor
string
Opaque pagination cursor from a previous response.

​
Example Request

cURL
curl "https://rewardsbot-prod.liquidrewardsapi.com/v1/discovery/merchants?page=1&per_page=25" \
  -H "x-api-key: YOUR_API_KEY"

​
Response (AffiliateDiscoveryMerchantListResponse)

​
query
string
The search query (empty for listing).
​
page_index
integer
Current page index.
​
page_size
integer
Page size.
​
items
AffiliateDiscoveryMerchantListItem[]
Array of merchant objects.
​
next_cursor
string | null
Cursor for the next page.
​
expires_at
string | null
Result set expiry timestamp.

​
Error Responses

Status CodeDescription
403 ForbiddenMissing API key
503 Service UnavailableMerchant search not configured
422 Unprocessable EntityValidation error