Retrieve TikTok LIVE effects API

Endpoint facts

Method

GET

API path

/tiktok/mobile/live/effects

Auth

apiKey

Credits

8 credits/request

Charged on

Successful 2xx responses only

Platform

TikTok

Execution

Managed browser rendering where the target needs it

Response schema

#/definitions/tiktokmobile.liveEffectsResponseDoc

How this endpoint behaves

Returns the complete LIVE effects/sticker asset catalogue in a single call: data.assets (2,032 assets in the measured response), where each asset carries id, name, describe, resource_url, resource_uri, md5, size, resource_type, download_type, model_requirements, sticker_asset_variant and video_resource_list.

This route takes no request parameters and has no paging: the upstream response is one complete catalogue dump (the measured body is 2,265,625 bytes), so the envelope carries no cursor and no has_more. The response is large because the catalogue itself is large, not because of paging; request it once and cache it rather than polling.

Query parameters: none.

Example response (truncated to one asset; a real response contains the full catalogue):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "data": {
      "assets": [
        {
          "id": "1",
          "name": "example",
          "describe": "example",
          "resource_url": {"url_list": ["https://example.invalid/asset.webp"]},
          "resource_uri": "example",
          "md5": "example",
          "size": 1,
          "resource_type": 1,
          "download_type": 1,
          "model_requirements": [],
          "sticker_asset_variant": 1,
          "video_resource_list": []
        }
      ]
    },
    "extra": {"log_id": "example", "now": 1792283000},
    "status_code": 0
  }
}

Shared guides

Related