Catalog Products API (v1.3)
Endpoints to upload, update, and remove products inside a catalog. Use as an alternative (or complement) to feed URL ingestion — typical use case is a real-time inventory sync webhook 1.
Endpoints
| Method | Path | Purpose |
|---|---|---|
POST | /open_api/v1.3/catalog/product/file/ | Upload products via a file URL. |
POST | /open_api/v1.3/catalog/product/upload/ | Upload products via a JSON schema. |
POST | /open_api/v1.3/catalog/product/update/ | Update existing products. |
POST | /open_api/v1.3/catalog/product/delete/ | Bulk delete products. |
GET | /open_api/v1.3/catalog/product/get/ | Read products. |
GET | /open_api/v1.3/catalog/product/log/ | Per-row audit / failure log. |
Source: 2.
⚠ Rate limit — 1000 queries/hour/catalog
Verbatim from TikTok docs 1:
"If you use the four endpoints below to operate on the same catalog, you can make up to 1000 queries per hour. For additional requests, you'll get an error. You need to wait until the next hour before you can make new API requests."
Endpoints sharing the bucket:
/catalog/product/file//catalog/product/upload//catalog/product/update//catalog/product/delete/
Implication: high-turnover merchants should prefer scheduled feeds (/catalog/feed/*) for bulk ingest and reserve the products API for delta updates.
Debugging failed ingest
Per-row status is at GET /open_api/v1.3/catalog/product/log/. Pair with GET /open_api/v1.3/catalog/overview/ (see catalogs-api) for catalog-wide audit counts.
Related
- Catalog Feeds API — preferred for bulk
- Catalogs API
- Product Feeds (concept)