tiktok/web/general-search

Get general search list

Purpose:

• Get general search list Parameters:
• keyword: Search keyword
• offset: Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor.
• search_id: Search id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request.
  • For example: search_id = "20240828035554C02011379EBB6A00E00B"
  • JSON Path-1 : $.data.extra.logid
  • JSON Path-2 : $.data.log_pb.impr_id
• cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required) Return:
• General search list Note:
• All video CDN links returned by this interface need to carry the returned tt_chain_token parameter to be accessed normally, otherwise HTTP 403 error will be returned.
• When accessing the video CDN link, be sure to carry Cookie: tt_chain_token={tt_chain_token} in the request header, where {tt_chain_token} is replaced with the tt_chain_token parameter value returned by the interface.
• If you receive HTTP 403 error when accessing video CDN links:
  1. Use the video link starting with https://www.tiktok.com/aweme/v1/play/ from the API response (usually found in video.playAddr or similar fields)
  2. When requesting this link, make sure to add Cookie: tt_chain_token={tt_chain_token} in the request header, where {tt_chain_token} is the value returned by the API
  3. Example request header: Cookie: tt_chain_token=xxx
• If you need to bypass this restriction to get a watermark-free video CDN link that can be accessed directly, please use the interface under the TikTok APP V3 directory.

[Example]

keyword = "TikTok" offset = 0 search_id = ""

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.