Skip to main content
This guide walks you through making your first calls to the Liquid Rewards API. You’ll search for affiliate products, inspect the results, paginate through them, and fetch full details for an individual product — all in just a few minutes.
1

Get Your API Key

Contact your account manager to receive your API key. Once you have it, include it in the x-api-key request header for all authenticated endpoints.We recommend storing the key in an environment variable so it never appears in source code:
export LIQUID_REWARDS_API_KEY="YOUR_API_KEY"
Not all endpoints require an API key. See the Authentication page for a full breakdown.
2

Search for Products

Send a POST request to /v1/discovery/products/search with a natural-language query. The API returns a ranked list of matching affiliate products.
curl -X POST https://rewardsbot-prod.liquidrewardsapi.com/v1/discovery/products/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "running shoes",
    "per_page": 5
  }'
Example response:
{
  "query": "running shoes",
  "page_index": 0,
  "page_size": 5,
  "items": [
    {
      "type": "product",
      "slug": "abc123",
      "id": "prod-001",
      "name": "Nike Air Zoom Pegasus 41",
      "image_url": "https://example.com/pegasus.jpg",
      "product_url": "https://example.com/product",
      "merchant_url": "https://nike.com",
      "price": {
        "display": "$120.00",
        "value": 120.0,
        "currency": "USD",
        "on_sale": false
      },
      "merchant": { "id": "nike-001", "name": "Nike" },
      "brand": "Nike",
      "category": "Athletic Footwear"
    }
  ],
  "next_cursor": "cursor-xyz"
}
Each item in items includes a slug that uniquely identifies the product, along with pricing, merchant metadata, and a direct product URL.
3

Paginate Results

When there are more results available, the response includes a next_cursor value. Pass it in a follow-up request to retrieve the next page. You do not need to repeat the original query — the cursor encodes it.
curl -X POST https://rewardsbot-prod.liquidrewardsapi.com/v1/discovery/products/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor": "cursor-xyz"}'
Keep paginating until the response returns no next_cursor — that signals you’ve reached the last page of results.
4

Get Product Details

Use the slug returned in any search result to fetch the full product record, including extended metadata and all available affiliate links.
curl https://rewardsbot-prod.liquidrewardsapi.com/v1/discovery/products/abc123 \
  -H "x-api-key: YOUR_API_KEY"
The response returns the same fields as the search result item, plus any additional detail fields available for that product.

​
Next Steps

Now that you’ve made your first calls, explore the rest of the platform:

Affiliate Discovery

Learn all available search filters: brand, price range, sale status, merchant, and more

Criteria Sets

Save and reuse product filter configurations across searches

Chat Integration

Embed the AI shopping assistant in your app for conversational product discovery

Building Offers

Package products into single, multi, and carousel reward offers for your loyalty program