What Is a Custom Catalog?
A custom catalog is any set of products you want ChatAds extractions to resolve to — instead of (or in addition to) Amazon. Common examples:- Your own product catalog — e-commerce platforms, marketplaces, or retailers who want to surface their own SKUs
- Direct brand inventory — brands who want their products returned directly rather than through an affiliate link
- A private affiliate network — custom link providers, CJ/Impact/Rakuten feeds, or first-party tracking
- A curated product list — a hand-picked set of products you trust for your users
Catalog Feed Format
Custom catalogs are uploaded as a flat feed — CSV or JSON, one row per SKU.Required Fields
| Field | Notes |
|---|---|
title | Full product title. Used to match extractions and returned in the API response. |
url | Destination URL returned in offer.url. Use whatever tracked link format your network requires. |
brand_name | Brand name. Required for accurate matching and shown in the response. |
Important but Optional
| Field | Why it matters |
|---|---|
product_id | Unique product identifier. Useful for your own reporting and dedup. |
image_url | Product image URL. Strongly recommended — without it, any UI rendering product cards has nothing to show. |
category_name | Top-level category (e.g. “Kitchen”). Lets your team use category targeting rules. |
category_path | Full breadcrumb (e.g. “Home > Kitchen > Cookware”). Enables finer-grained category targeting. |
price | USD price. Needed if you want to use minimum-price product quality filters. |
stars | Star rating (e.g. 4.5). Needed if you want to use minimum-rating filters. |
reviews | Number of reviews. Needed if you want to use minimum-review-count filters. |
Example Row
Getting Started
Reach out to team@getchatads.com for custom pricing and next steps.If you’d rather handle resolution yourself, you can run ChatAds in extraction-only mode and match the returned keywords against your catalog on your end. See Retail Media Product Extraction.