Make a Search

AI apps and agents use /search to find products across the web.

The request shape

{
  "query": "merino wool sweater",
  "filters": {
    "price": { "min_price": 50, "max_price": 200 },
    "availability": ["InStock"],
    "brand_ids": ["..."],
    "website_ids": ["..."],
    "category": "sweaters"
    // and many more
  },
  "limit": 20
}

Get an API key

Search requires an API key. Create a free account, then copy your key.

You get 1,000 free credits each month — that’s good for 1,000 searches. Extra usage is billed per call; see pricing for the breakdown.

Choose a search method

Search

Search with text and images.

Agentic search

Interpret longer shopping requests for an agent workflow.

Image search

Find visually similar products from an image URL or upload.

Filters

Add optional filters to narrow your search.

Price

Constrain results to an offer price range.

Color

Find products that match a hex color palette.

Dimensions

Constrain length, width, height, or weight.

Brand

Filter by the company behind a product.

Website

Restrict results to retailer offers from selected websites.

Attributes

Filter on category-specific structured attributes.

Start from an existing product

Look up a product URL

Get structured data from a URL, and offers at other retailers.

Find similar products

Get recommendations from a known Channel3 product ID.

Attribute clicks to your users

Send the x-user-id header on search (and other catalog) requests to tie buy-link clicks and commissions back to a user in your app. Channel3 adds it to every offer URL in the response.

curl -X POST https://api.trychannel3.com/v1/search \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "x-user-id: user_abc123" \
  -H "Content-Type: application/json" \
  -d '{"query": "merino wool sweater", "limit": 20}'

Use a stable ID from your system (UUID, Clerk ID, etc.). Filter reporting by the same value — see Reporting.

Next: What you get. It explains how products, offers, prices, and buy links appear in a response.

⌘I

Getting Started

Get Product Data

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ

Make a Search

The request shape

Get an API key

Choose a search method

Search

Agentic search

Image search

Filters

Price

Color

Dimensions

Brand

Website

Attributes

Start from an existing product

Look up a product URL

Find similar products

Attribute clicks to your users

Next

​The request shape

​Get an API key

​Choose a search method

Search

Agentic search

Image search

​Filters

Price

Color

Dimensions

Brand

Website

Attributes

​Start from an existing product

Look up a product URL

Find similar products

​Attribute clicks to your users

​Next

The request shape

Get an API key

Choose a search method

Filters

Start from an existing product

Attribute clicks to your users

Next