TikTok Shop Live: Live Room Product List

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

TikTok

TikTok Shop Live: Live Room Product List | TikHub

Enter a TikTok live room ID and its host (anchor) ID, plus optional region, page size, and offset, to pull that room’s promoted product list as structured data through TikHub. Pay-per-use: up to $0.0015 per call, no subscription.

You receive

Returns one live room's promoted product list, page by page via offset pagination. It needs both the room ID and the anchor ID, and it does not return gift lists, viewer lists, chat, or sales totals; fields follow what the provider returns. Billed per call, up to $0.0015.

Start with your task

TikTok Shop Live: Live Room Product List | TikHub

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `room_id, author_id`
cookie`queryParams.cookie`	`string`	Optional	The user's own cookie.
offset`queryParams.offset`	`integer`	Optional	Number of products to return. Default `0`
region`queryParams.region`	`string`	Optional	Region. Default `US`
room_id`queryParams.room_id`	`string`	Required	Live room ID. Examples `7420741353250507562`
author_id`queryParams.author_id`	`string`	Required	Anchor ID. Examples `7408859677050274859`
page_size`queryParams.page_size`	`integer`	Optional	Number of products to skip. Default `15`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "required": [
        "room_id",
        "author_id"
      ],
      "properties": {
        "cookie": {
          "type": "string",
          "title": "Cookie",
          "description": "The user's own cookie."
        },
        "offset": {
          "type": "integer",
          "title": "Offset",
          "default": 0,
          "description": "Number of products to return."
        },
        "region": {
          "type": "string",
          "title": "Region",
          "default": "US",
          "description": "Region."
        },
        "room_id": {
          "type": "string",
          "title": "Room Id",
          "examples": [
            "7420741353250507562"
          ],
          "description": "Live room ID."
        },
        "author_id": {
          "type": "string",
          "title": "Author Id",
          "examples": [
            "7408859677050274859"
          ],
          "description": "Anchor ID."
        },
        "page_size": {
          "type": "integer",
          "title": "Page Size",
          "default": 15,
          "description": "Number of products to skip."
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Bring your agent along.
Copy the note below into your agent’s chat. It reuses an existing connection or helps set one up.
Get connected
Start with your task
Tell your agent what you want to accomplish, including any constraints that matter.
Check before you call
I will inspect this tool, confirm the inputs and current cost, and check your authorization before running it. Then I will explain the result and its limits.

You receive

Start with your task

Inputs & outputs

Input schema

Result schema

Bring your agent along.

Start with your task

Check before you call