TikHub Complete (149 Endpoints) icon

TikHub Complete (149 Endpoints)

Access ALL 149 TikHub social media data endpoints for TikTok (64), Instagram (56), YouTube (16), and X/Twitter (13)
Join our community

Actions64

Overview

This node, named "TikHub Complete (149 Endpoints)", provides unified access to a wide range of social media data endpoints across four major platforms: TikTok, Instagram, YouTube, and X/Twitter. It supports 64 TikTok endpoints, 56 Instagram endpoints, 16 YouTube endpoints, and 13 X/Twitter endpoints, enabling users to retrieve diverse data such as videos, user profiles, analytics, posts, stories, reels, channels, tweets, timelines, and shop product lists.

The specific operation "Get shop product list data" under the "Default" resource for the TikTok platform allows users to fetch product listings from a TikTok shop or live room. This is particularly useful for marketers, e-commerce managers, or social media analysts who want to monitor or analyze product offerings linked to TikTok creators or sellers.

Practical examples:

  • Fetching all products available in a TikTok creator’s shop to analyze inventory or pricing.
  • Retrieving product lists from a live stream session to understand promoted items.
  • Paginating through large product catalogs using scroll or page parameters.

Properties

Name Meaning
Platform Select the social media platform to work with. Options: TikTok, Instagram, YouTube, X/Twitter.
创作者的sec_user_id/Creator's sec_user_id (kol_id) The unique sec_user_id of the TikTok creator whose product list is being fetched. (Required)
数量/Number (count) Number of products to retrieve. Optional; default is 20; max 1000.
翻页参数/Page parameter (next_scroll_param) Parameter used for pagination to fetch the next set of results. Optional.
商家id,店铺id/Seller id, shop id (seller_id) The seller or shop ID on TikTok whose products are being queried. (Required)
滚动参数，用于加载更多商品数据/Scroll parameter (scroll_params) Scroll parameter used to load more product data. Optional.
每页数量/Number per page (page_size) Number of products per page to return. Optional; default 20; max 1000.
排序字段/Sorting field (sort_field) Field by which to sort the product list. Optional.
排序方式/Sorting method (sort_order) Sorting order/method (e.g., ascending or descending). Optional.
直播间id/Live room id (room_id) The ID of the TikTok live room associated with the product list. (Required)
主播id/Anchor id (author_id) The anchor or host ID related to the live room or product list. (Required)
数量/Number (page_size) Number of items to retrieve per request. Optional; default 20; max 1000.
数量/Number (offset) Offset for pagination to skip a number of products. Optional.
地区/Region (region) Region code to filter products by geographic location. Optional.
用户自己的cookie/User's own cookie (cookie) User’s own cookie string for authentication or session purposes. Optional.

Note: Some properties appear multiple times with similar names but are contextually the same (e.g., page_size).

Output

The node outputs an array of JSON objects representing the product list data retrieved from the TikTok shop or live room. Each item in the output corresponds to a product with its associated details as returned by the TikHub API.

The exact structure of each product object depends on the TikHub API response but typically includes fields like product ID, name, price, availability, images, and other metadata relevant to the shop product.

If the node encounters errors during execution, it outputs JSON objects containing an error field with the error message, paired with the input item index.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for the TikHub API service.
  • The node makes HTTP requests to the TikHub API base URL: https://api.tikhub.io.
  • Proper configuration of the API key credential within n8n is necessary.
  • For some operations, user cookies may be optionally provided to enhance or authenticate requests.

Troubleshooting

  • Common issues:

    • Missing required parameters such as kol_id, seller_id, room_id, or author_id will cause the node to fail.
    • Invalid or expired API credentials will result in authentication errors.
    • Incorrect pagination parameters (next_scroll_param, scroll_params, offset) may lead to empty or incomplete results.
    • Rate limiting by the TikHub API could cause temporary failures.

  • Error messages:

    • "Unknown operation": Indicates that the specified operation is not supported for the selected platform.
    • API errors returned from TikHub will be passed through in the error field of the output JSON.

  • Resolutions:

    • Ensure all required fields are correctly filled.
    • Verify API key validity and permissions.
    • Use correct pagination tokens as returned by previous responses.
    • Handle errors gracefully by enabling "Continue On Fail" if partial data retrieval is acceptable.

Links and References

  • TikHub API Documentation (Assumed based on base URL, please verify actual docs)
  • TikTok Shop and Live Room official documentation for understanding IDs and parameters.
  • n8n documentation on creating and using API key credentials.

Discussion