tiktok/shop-web/products-by-category-id
Get product list by category ID Can be used to build category browsing feature.
Input
Category ID (required, from fetch_products_category_list API)
Offset for pagination (default 0)
Region code (US/GB/SG/MY/PH/TH/VN/ID)
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
tiktok/shop-web/products-by-category-id01
Input Schema
3 parameters · 1 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
category_id | integer | Required | Category ID (required, from fetch_products_category_list API) |
offset | integer | Optional | Offset for pagination (default 0) · Default: 0 |
region | string | Optional | Region code (US/GB/SG/MY/PH/TH/VN/ID) · Default: "US" |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "tiktok/shop-web/products-by-category-id",
"offset": 0,
"region": "US",
"prompt": "a beautiful sunset over mountains"
}'API README
Get products by category ID
Get product list by category ID Can be used to build category browsing feature. It is suitable for tiktok workflows.
Capability
Get product list by category ID Can be used to build category browsing feature. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Connect structured data to dashboards, agents, internal tools, and automated workflows.
- Create repeatable integrations that pass structured results to downstream business systems.
- Support scheduled jobs, internal tools, and agent workflows with structured results.