About the catalog

ucp.trychannel3.com is one catalog across many online stores. It uses the same product data as the Channel3 REST API.

Three tools

Tool	Use it when you want to…
`search_catalog`	Find products from a text query
`lookup_catalog`	Load products you already know by id or store URL
`get_product`	Load one product by id, with optional variant selection

How to shape a request

Every tool takes the same outer shape:

{
  "meta": null,
  "catalog": { }
}

catalog — your query (query, ids, urls, id, selected, preferences, pagination, filters, context for currency or country)
meta — pass null on Channel3 today (details)

The answer lives in structuredContent: products, pagination, and sometimes messages.

Channel3 extras

Base UCP gives you title, price, variants, and store domain. For filters by store, richer seller info, and URL lookup, use extension com.trychannel3.catalog.global. Details: Extension reference.

Same as REST

Tool	REST equivalent
`search_catalog`	`POST /v1/search`
`lookup_catalog` with `ids`	`POST /v1/lookup`
`lookup_catalog` with `urls`	`POST /v1/lookup` (URL)
`get_product`	`GET /v1/products/{id}` (`option_<name>=<label>` query params)

What’s next

Search

Text search and filters

Lookup

By id or store URL

Get product

One product by id, with variant selection

​Three tools

​How to shape a request

​Channel3 extras

​Same as REST

​What’s next