> ## Documentation Index > Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # 特效详情 > 这是单个贴纸/特效的实时详情接口，通过明确的 `sticker_id` 拉一个具体贴纸实体，目标是查看它本身的元数据和热度表现。返回聚焦在贴纸本身的资料与使用状态，一个特效实体页，所以适合先确认这个贴纸是什么、是否活跃，再决定要不要继续追它的视频样本。 **接口用途推荐** - 适合做特效素材管理 - 跟踪某个贴纸是否在起量 - 判断某个贴纸值不值得跟拍、给创意团队找特效方向 **注意事项** - 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度）
🪙 1 credit每次请求
## Copy for AI

🤖 让 AI 帮你写调用代码

点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。

## OpenAPI ````yaml zh/tiktok.zh.openapi.json GET /v1/tiktok/sticker/detail openapi: 3.0.1 info: title: Tiktok API 中文文档 description: Tiktok API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。 version: 1.0.0 servers: - url: https://api.keyapi.ai description: Production security: [] tags: - name: TikTok 达人 - name: TikTok 店铺 - name: TikTok 内容数据 - name: TikTok 趋势洞察 paths: /v1/tiktok/sticker/detail: get: tags: - TikTok 内容 summary: 特效详情 description: >- 这是单个贴纸/特效的实时详情接口，通过明确的 `sticker_id` 拉一个具体贴纸实体，目标是查看它本身的元数据和热度表现。返回聚焦在贴纸本身的资料与使用状态，一个特效实体页，所以适合先确认这个贴纸是什么、是否活跃，再决定要不要继续追它的视频样本。 **接口用途推荐** - 适合做特效素材管理 - 跟踪某个贴纸是否在起量 - 判断某个贴纸值不值得跟拍、给创意团队找特效方向 **注意事项** - 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度） parameters: - name: sticker_id in: query description: 特效ID required: true example: '1108584' schema: type: string example: '1108584' responses: '200': description: '' content: application/json: schema: type: object properties: {} example: code: 0 message: success data: extra: fatal_item_ids: [] logid: 20260715120512A4D4B5233150481A6E87 now: 1784117112000 log_pb: impr_id: 20260715120512A4D4B5233150481A6E87 status_code: 0 status_msg: '' sticker_infos: - attributions: null avatar_large: uri: tiktok-obj/effect_ops_avatar.png url_list: - >- https://p16-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.image?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a - >- https://p19-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.image?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a - >- https://p16-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.jpeg?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a url_prefix: null avatar_medium: uri: tiktok-obj/effect_ops_avatar.png url_list: - >- https://p16-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.image?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a - >- https://p19-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.image?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a - >- https://p16-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.jpeg?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a url_prefix: null avatar_thumb: uri: tiktok-obj/effect_ops_avatar.png url_list: - >- https://p16-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.image?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a - >- https://p19-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.image?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a - >- https://p16-common.tiktokcdn-eu.com/tiktok-obj/effect_ops_avatar.png~tplv-tiktokx-origin.jpeg?dr=10423&t=4d5b0474&ps=933b5bde&shp=8b85b4fa&shcp=9b759fb9&idc=no1a url_prefix: null children: [] desc: '' effect_creator_type: 1 effect_id: '1108584' effect_source: 0 extra: '' icon_url: uri: acf2eb0c12e95ebefda328663c385a9d url_list: - >- https://lf16-effectcdn-sg.tiktokcdn.com/obj/ies.fe.effect.alisg/acf2eb0c12e95ebefda328663c385a9d - >- https://lf19-effectcdn-sg.tiktokcdn.com/obj/ies.fe.effect.alisg/acf2eb0c12e95ebefda328663c385a9d url_prefix: null id: '1108584' is_favorite: false is_top_effect: false is_top_effect_designer: false linked_anchors: null name: Зернистость owner_id: '' owner_nickname: TikTok owner_verified_type: 0 publish_time: 1629276427000 sdk_extra: '{"External_Producer":true}' sec_uid: '' share_info: now_invitation_card_image_urls: null share_desc: 'Check out this sticker! #TikTok' share_url: >- https://www.tiktok.com/sticker/%D0%97%D0%B5%D1%80%D0%BD%D0%B8%D1%81%D1%82%D0%BE%D1%81%D1%82%D1%8C-1108584?_r=1&_d=f0kdg8j5j5271c&share_sticker_id=1108584&source=h5_m&u_code=f0jj2geia4gdk0 tags: - new user_count: 15812564 vv_count: 11816531971 requestId: 08e57659-868f-4aa7-ab5e-79ef31514759 headers: {} '400': description: 请求参数错误，请检查必填字段和参数格式 content: application/json: schema: type: object example: code: 400 data: null message: Missing required parameter '401': description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效 content: application/json: schema: type: object example: code: 401 data: null message: apiKey is null '402': description: 账户余额或额度不足 content: application/json: schema: type: object example: code: 402 data: null message: apiKey quota is not enough '429': description: 请求过于频繁，已触发限流 content: application/json: schema: type: object example: code: 429 data: null message: qps limit exceeded '500': description: 服务器内部错误，请稍后重试 content: application/json: schema: type: object example: code: 500 data: null message: Internal server error deprecated: false security: - JWT Bearer: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://api.keyapi.ai/v1/tiktok/sticker/detail?sticker_id=1108584' \ --header 'Authorization: Bearer ' - lang: python label: Python source: |- import requests response = requests.get( 'https://api.keyapi.ai/v1/tiktok/sticker/detail', params={"sticker_id": "1108584"}, headers={'Authorization': 'Bearer '} ) print(response.json()) - lang: javascript label: JavaScript source: >- const params = new URLSearchParams({"sticker_id": "1108584"}); const response = await fetch(`https://api.keyapi.ai/v1/tiktok/sticker/detail?${params}`, { method: 'GET', headers: { 'Authorization': 'Bearer ' } }); const data = await response.json(); console.log(data); components: securitySchemes: JWT Bearer: type: http scheme: bearer bearerFormat: JWT description: |- 接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer `。 可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。 ````