{"components":{"responses":{"E400":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"An argument is missing, unknown or out of range. The message names it and says what the route takes. Not charged.","request_id":"req_0a1b2c3d4e5f","type":"invalid_request"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"An argument is missing, unknown or out of range. The message names it and says what the route takes. Not charged."},"E401":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"No API key, or the key is revoked. Send X-API-Key or Authorization: Bearer.","request_id":"req_0a1b2c3d4e5f","type":"unauthorized"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No API key, or the key is revoked. Send X-API-Key or Authorization: Bearer."},"E402":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"No credits left this period. Upgrade or wait for renewal. Not charged.","request_id":"req_0a1b2c3d4e5f","type":"credits_exhausted"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No credits left this period. Upgrade or wait for renewal. Not charged."},"E403":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"The API needs a paid plan (Starter, Growth, Pro or Enterprise). Not charged.","request_id":"req_0a1b2c3d4e5f","type":"plan_required"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API needs a paid plan (Starter, Growth, Pro or Enterprise). Not charged."},"E404":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"No such route, or TikTok has nothing at that id (deleted, private or never existed).","request_id":"req_0a1b2c3d4e5f","type":"not_found"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No such route, or TikTok has nothing at that id (deleted, private or never existed)."},"E429":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"Over your plan's requests per minute or calls at once. Wait for the Retry-After seconds. Not charged.","request_id":"req_0a1b2c3d4e5f","type":"rate_limited"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Over your plan's requests per minute or calls at once. Wait for the Retry-After seconds. Not charged."},"E502":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"TokConnect could not read this answer from TikTok. Retry shortly. Not charged.","request_id":"req_0a1b2c3d4e5f","type":"upstream_failed"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"TokConnect could not read this answer from TikTok. Retry shortly. Not charged."},"E503":{"content":{"application/json":{"example":{"error":{"charged":false,"docs":"https://tokconnect.com/docs/api/errors/","message":"TokConnect is at capacity. Retry after a few seconds. Not charged.","request_id":"req_0a1b2c3d4e5f","type":"server_busy"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"TokConnect is at capacity. Retry after a few seconds. Not charged."}},"schemas":{"Error":{"properties":{"error":{"properties":{"charged":{"description":"Always false: failed calls are not charged.","type":"boolean"},"docs":{"format":"uri","type":"string"},"message":{"description":"What went wrong and what to do.","type":"string"},"request_id":{"type":"string"},"retry_after":{"description":"Seconds to wait, on 429 and 503.","type":"integer"},"type":{"description":"Machine code: invalid_request, unauthorized, credits_exhausted, plan_required, forbidden (a browser request from a site that may not call the API), not_found, rate_limited, too_concurrent, upstream_failed, server_busy.","type":"string"}},"required":["type","message"],"type":"object"}},"required":["error"],"type":"object"},"Meta":{"properties":{"credits_charged":{"description":"1 on success.","type":"integer"},"credits_remaining":{"description":"Credits left this period, when known.","type":"integer"},"request_id":{"description":"Quote it to support.","type":"string"}},"type":"object"}},"securitySchemes":{"apiKey":{"in":"header","name":"X-API-Key","type":"apiKey"},"bearer":{"scheme":"bearer","type":"http"}}},"externalDocs":{"description":"Guides and reference","url":"https://tokconnect.com/docs/api/"},"info":{"contact":{"email":"dj@tokconnect.com","name":"TokConnect","url":"https://tokconnect.com/docs/api/"},"description":"TikTok data over HTTP: Shop sales estimates and rankings in 17 markets, and live TikTok search, creators, videos, comments, hashtags, sounds, LIVE, ads and charts. Every route is one of TokConnect's MCP tools, so a call here returns what the same tool returns in ChatGPT or Claude. One credit per successful call; failed calls are not charged. Guides: https://tokconnect.com/docs/api/","title":"TokConnect API","version":"4.1.0"},"openapi":"3.1.0","paths":{"/v1/ads/search":{"get":{"description":"This route: top ads matching keyword (worldwide).\n\nTikTok's library of top-performing ads: search by keyword, one ad's detail (countries it ran in, CTR, likes, objective, landing page, video), analysis (TikTok's per-second retention curve and the ad's CTR percentile against other ads), and similar ads. Search results are worldwide: the library does not filter by market (tested 31 Oct 2026 with US, DE and JP, and with a language filter, which returned the same ads), so check countries with method=detail. Examples: {\"method\":\"search\",\"keyword\":\"skincare\",\"period\":\"30\"}, {\"method\":\"analysis\",\"id\":\"7382019274430578705\"}.","operationId":"GET_ads_search","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=search: phrase in the ad, e.g. 'skincare'. Omit to list top ads of the period.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Results per page. search max 50. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=search: ads from the last 7, 30 or 180 days (default 30).","in":"query","name":"period","required":false,"schema":{"enum":["7","30","180"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:27:06Z","count":3,"has_more":true,"items":[{"brand":"","cover":"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oofEIsEmxiO1ABcc8qxtR7gzkiIYfBhBIz9Xm0~tplv-noop.image?dr=18692\u0026refresh_token=62c83a30\u0026x-expires=1793424472\u0026x-signature=YlOuM7U3FOPkNMfTUB1ozcJVmag%3D\u0026t=9276707c\u0026ps=14f1eb3e\u0026shp=9e36835a\u0026shcp=317596d8\u0026idc=my\u0026VideoID=v1c044g50000dapv4mvog65hoi7gt…","ctr":0.96,"duration":47.534,"id":"7689369336687034388","industry":"14104000000","likes":167,"objective":"reach","title":"Kalau korang area SG Besi, jangan scroll dulu 👀🔥 Ada satu spot yang korang kena try sendiri! ✨ Zufora SG Besi — sesuai untuk korang yang suka cantikkan diri dari segi makeup , supplement dan macam2 lagi 🌸 Jangan lupa waze  📍Zufora, SG Besi #Zufora #cosmetics #skincare #makeup #supple…"},{"brand":"medicube","cover":"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oAAxDGrVoIzE4bcgVIKeCLeieGdl6vQ5jOLLiA~tplv-noop.image?dr=18692\u0026refresh_token=37a069b0\u0026x-expires=1793424505\u0026x-signature=eCZBXTq9JTIhxCJ7wk4rxtu06Bs%3D\u0026t=9276707c\u0026ps=14f1eb3e\u0026shp=9e36835a\u0026shcp=317596d8\u0026idc=my\u0026VideoID=v14033g50000db2nlefog6…","ctr":0.78,"duration":80.214,"id":"7693690323848609793","industry":"14109000000","likes":7,"objective":"conversion","title":"50% OFF PLUS FREE SHIPPING "},{"brand":"","cover":"https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068/oUIFCICPICjSug6b8flWzQfjLF7e5DhpsCEgAC~tplv-noop.image?dr=18692\u0026refresh_token=4305f516\u0026x-expires=1793424533\u0026x-signature=Khk03LGsIUgc1c5lK9739vmojOQ%3D\u0026t=9276707c\u0026ps=14f1eb3e\u0026shp=9e36835a\u0026shcp=317596d8\u0026idc=my\u0026VideoID=v09044g40000cncvg6vog65iln66…","ctr":0.62,"duration":108.252,"id":"7391864211066601473","industry":"23122000000","likes":0,"objective":"product_sales","title":"Are you ready to build a skincare routine that actually works? You've come to the right video! Watch the first episode of our Skincare 101 series ▶️🩷 #kbeautycafe #skincareroutine #skincareforbeginners #skincare #koreanskincare #SkinCare101 #fyp "}],"market":"worldwide","next":"eyJwYWdlIjoyfQ","notes":["ctr and likes are TikTok's ad library figures for the ad; objective and industry are TikTok's labels.","The ad library answers worldwide; method=detail lists the countries each ad ran in."],"period_days":30,"see_also":["ad_library method=detail id=\u003citems[].id\u003e","ad_library method=analysis id=\u003citems[].id\u003e"],"source":"tiktok_live","total":33},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"items":{"items":{"properties":{"brand":{"type":"string"},"cover":{"type":"string"},"ctr":{"type":"number"},"duration":{"type":"number"},"id":{"type":"string"},"industry":{"type":"string"},"likes":{"type":"integer"},"objective":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"period_days":{"type":"integer"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"total":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok top ads library · search","tags":["ad_library"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"search","x-mcp-tool":"ad_library"}},"/v1/ads/{id}":{"get":{"description":"This route: one ad: countries, CTR, likes, objective, landing page, video.\n\nTikTok's library of top-performing ads: search by keyword, one ad's detail (countries it ran in, CTR, likes, objective, landing page, video), analysis (TikTok's per-second retention curve and the ad's CTR percentile against other ads), and similar ads. Search results are worldwide: the library does not filter by market (tested 31 Oct 2026 with US, DE and JP, and with a language filter, which returned the same ads), so check countries with method=detail. Examples: {\"method\":\"search\",\"keyword\":\"skincare\",\"period\":\"30\"}, {\"method\":\"analysis\",\"id\":\"7382019274430578705\"}.","operationId":"GET_ads_id","parameters":[{"description":"Ad id (items[].id from method=search or similar).","example":"7689369336687034388","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"ad":{"brand":"","comments":2,"countries":["MY"],"cover":"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oofEIsEmxiO1ABcc8qxtR7gzkiIYfBhBIz9Xm0~tplv-noop.image?dr=18692\u0026refresh_token=574a5739\u0026x-expires=1793424473\u0026x-signature=HJXPys9Os17%2F0bQZY5h5%2F9BbUvI%3D\u0026t=9276707c\u0026ps=14f1eb3e\u0026shp=9e36835a\u0026shcp=317596d8\u0026idc=my\u0026VideoID=v1c044g50000dapv4mvog65ho…","ctr":0.96,"duration":47.534,"id":"7689369336687034388","industry":"14104000000","likes":167,"objective":"reach","shares":4,"source":"Others","title":"Kalau korang area SG Besi, jangan scroll dulu 👀🔥 Ada satu spot yang korang kena try sendiri! ✨ Zufora SG Besi — sesuai untuk korang yang suka cantikkan diri dari segi makeup , supplement dan macam2 lagi 🌸 Jangan lupa waze  📍Zufora, SG Besi #Zufora #cosmetics #skincare #makeup #supple…","video_url":"https://v16m-default.tiktokcdn.com/c5b9222cf24f8648f8cad1b000953fd5/6ae57c59/video/tos/alisg/tos-alisg-pve-0037c001/oYFffikdAZORXBxhE19Btxv8OEiEsqLcgQBzII/?a=0\u0026bti=NTU4QDM1NGA%3D\u0026\u0026bt=988\u0026ft=cApXJCz7ThWHj788LGZmo0P\u0026mime_type=video_mp4\u0026rc=ZWloZDNlZDc3NGg2ZTs2NkBpajRqbGs5cnB5ZDMzODczNEBfLS4uMy02NTMxXjU…","voice_over":false},"as_of":"2026-10-30T23:27:07Z","notes":["ctr and likes are TikTok's ad library figures for the ad; objective and industry are TikTok's labels."],"see_also":["ad_library method=analysis id=7689369336687034388","ad_library method=similar id=7689369336687034388"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"ad":{"properties":{"brand":{"type":"string"},"comments":{"type":"integer"},"countries":{"items":{"type":"string"},"type":"array"},"cover":{"type":"string"},"ctr":{"type":"number"},"duration":{"type":"number"},"id":{"type":"string"},"industry":{"type":"string"},"likes":{"type":"integer"},"objective":{"type":"string"},"shares":{"type":"integer"},"source":{"type":"string"},"title":{"type":"string"},"video_url":{"type":"string"},"voice_over":{"type":"boolean"}},"type":"object"},"as_of":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok top ads library · detail","tags":["ad_library"],"x-credits":1,"x-example-params":{"id":"7689369336687034388"},"x-mcp-method":"detail","x-mcp-tool":"ad_library"}},"/v1/ads/{id}/analysis":{"get":{"description":"This route: retention curve per second, biggest drop, CTR percentile.\n\nTikTok's library of top-performing ads: search by keyword, one ad's detail (countries it ran in, CTR, likes, objective, landing page, video), analysis (TikTok's per-second retention curve and the ad's CTR percentile against other ads), and similar ads. Search results are worldwide: the library does not filter by market (tested 31 Oct 2026 with US, DE and JP, and with a language filter, which returned the same ads), so check countries with method=detail. Examples: {\"method\":\"search\",\"keyword\":\"skincare\",\"period\":\"30\"}, {\"method\":\"analysis\",\"id\":\"7382019274430578705\"}.","operationId":"GET_ads_id_analysis","parameters":[{"description":"Ad id (items[].id from method=search or similar).","example":"7689369336687034388","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:27:09Z","ctr_percentile":0.99,"duration":49,"id":"7689369336687034388","notes":["Calls made: TikTok's keyframe retention analysis and its CTR percentile for the ad.","TikTok returned no retention data for this ad (every point was 0), so no curve is shown.","ctr_percentile is TikTok's rank of the ad's click-through rate among ads over 180 days (0.99 = top 1%)."],"see_also":["ad_library method=detail id=7689369336687034388"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"ctr_percentile":{"type":"number"},"duration":{"type":"integer"},"id":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok top ads library · analysis","tags":["ad_library"],"x-credits":1,"x-example-params":{"id":"7689369336687034388"},"x-mcp-method":"analysis","x-mcp-tool":"ad_library"}},"/v1/ads/{id}/similar":{"get":{"description":"This route: ads TikTok recommends next to this one.\n\nTikTok's library of top-performing ads: search by keyword, one ad's detail (countries it ran in, CTR, likes, objective, landing page, video), analysis (TikTok's per-second retention curve and the ad's CTR percentile against other ads), and similar ads. Search results are worldwide: the library does not filter by market (tested 31 Oct 2026 with US, DE and JP, and with a language filter, which returned the same ads), so check countries with method=detail. Examples: {\"method\":\"search\",\"keyword\":\"skincare\",\"period\":\"30\"}, {\"method\":\"analysis\",\"id\":\"7382019274430578705\"}.","operationId":"GET_ads_id_similar","parameters":[{"description":"Ad id (items[].id from method=search or similar).","example":"7689369336687034388","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. search max 50. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:27:12Z","count":1,"has_more":false,"id":"7689369336687034388","items":[{"brand":"","cover":"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oQBIAgGHeQVALzx85geCr1DF4xebFiEnAIDujQ~tplv-noop.image?dr=18692\u0026refresh_token=13d07d8c\u0026x-expires=1793424460\u0026x-signature=0qdezaCOQa527FDQQnHG3Vkuqlw%3D\u0026t=9276707c\u0026ps=14f1eb3e\u0026shp=9e36835a\u0026shcp=317596d8\u0026idc=my\u0026VideoID=v10025g50000db0hf0fog65sekh7o…","ctr":0.83,"duration":28.84,"id":"7692455584689340423","industry":"14104000000","likes":785,"objective":"product_sales","title":"銀座に旗艦店がある、フローリアス(花西子)のUVクッションファンデ。本場中国のドール肌、宮廷時代から磨かれ続けた微細粒子と先端技術のUVカット。試してみない？ #とくとくセール #ショップ始めました #ファンデーショ…"}],"notes":["ctr and likes are TikTok's ad library figures for the ad; objective and industry are TikTok's labels.","Calls made: the ad's detail (industry 14104000000, country MY), then TikTok's recommended ads for them."],"see_also":["ad_library method=detail id=\u003citems[].id\u003e"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"brand":{"type":"string"},"cover":{"type":"string"},"ctr":{"type":"number"},"duration":{"type":"number"},"id":{"type":"string"},"industry":{"type":"string"},"likes":{"type":"integer"},"objective":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok top ads library · similar","tags":["ad_library"],"x-credits":1,"x-example-params":{"id":"7689369336687034388","limit":"3"},"x-mcp-method":"similar","x-mcp-tool":"ad_library"}},"/v1/affiliates/top":{"get":{"description":"This route: creators ranked by sales.\n\n[Shop Analytics] Creators (affiliates) ranked by the sales they drove over a date range: revenue, units, followers, engagement, views, trend. keyword = words in creator names, handles and bios (not the products they sell); category = a category name or id (levels 1-3: the creators selling in it, no keyword needed); both together narrow further. With neither, the result is the top 10 creators for the most recent days (about 6). Up to 100 rows per page with cursor paging, about 700 rows per keyword. sort: revenue, units, followers or growth; order=asc lists lowest first. Filters: revenue, followers, engagement, average views, price, growth, video or LIVE, gender, language, contact channel, MCN, audience age/language. region picks the market (default US). Examples: {\"category\":\"Pet Supplies\",\"followers\":\"10000-500000\",\"contact\":\"EMAIL\"}, {\"keyword\":\"beauty\",\"window\":\"7d\",\"sort\":\"units\"}.","operationId":"GET_affiliates_top","parameters":[{"description":"Filter. BELONGED_TO_SELLER = a brand's own account; INDEPENDENT = affiliate creator.","in":"query","name":"account_type","required":false,"schema":{"enum":["BELONGED_TO_SELLER","INDEPENDENT"],"type":"string"}},{"description":"Filter. Main follower age band.","in":"query","name":"audience_age","required":false,"schema":{"enum":["18-24","25-34","35-44","45-54","55+"],"type":"string"}},{"description":"Filter. Main follower language.","in":"query","name":"audience_language","required":false,"schema":{"enum":["en-US","es-ES","pt-BR","fr-FR","de-DE","it-IT","ja-JP","ru-RU"],"type":"string"}},{"description":"Filter. Average video views, e.g. \u003e10000.","in":"query","name":"avg_views","required":false,"schema":{"type":"string"}},{"description":"Narrow to one or more Shop categories (up to 5), by name or numeric id, levels 1 to 3: [\"Skincare\"], [\"Pet Supplies\"], [\"Beauty \u0026 Personal Care\",\"Health\"] or [\"601450\"]. Without a keyword the creators of the category are found by merging several generic keyword searches (a keyword is needed), and the result says how many keyword sweeps and distinct rows that gave. Find names and ids with category_trends method=tree.","in":"query","name":"category","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter. Only creators who list this contact channel. Several: comma separated, e.g. EMAIL,INSTAGRAM. Values: EMAIL, WHATSAPP, INSTAGRAM, YOUTUBE, FACEBOOK, TWITTER.","in":"query","name":"contact","required":false,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Filter. Days since the creator started selling: \u003c4, \u003c8, \u003c31, or \u003e30.","in":"query","name":"debut","required":false,"schema":{"enum":["\u003c4","\u003c8","\u003c31","\u003e30"],"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Filter. Video engagement rate percent, e.g. \u003e8.","in":"query","name":"engagement","required":false,"schema":{"type":"string"}},{"description":"Filter. Followers, e.g. 50000-500000.","in":"query","name":"followers","required":false,"schema":{"type":"string"}},{"description":"Filter. Creator gender as the feed classifies it.","in":"query","name":"gender","required":false,"schema":{"enum":["Female","Male"],"type":"string"}},{"description":"Filter. true = only creators whose revenue is growing.","in":"query","name":"growing","required":false,"schema":{"type":"boolean"}},{"description":"Matched against creator names, handles and bios (not the products they sell): 'pet' finds accounts like 'Pet Finds'. For the affiliates of a product type, pass category, or rank products with product_top_selling and call product method=creators on the top items. If keyword and category are both omitted, the result is the top 10 creators for the most recent days (about 6), whatever window is set: pass a keyword or category when the user wants more than 10 rows or a specific window.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Filter. Creator language.","in":"query","name":"language","required":false,"schema":{"enum":["en","es","pt","fr","zh","de","it"],"type":"string"}},{"description":"Results per page. Max 100 per page; pass next as cursor for the following page. Up to about 700 rows per keyword. Without a keyword or category: 10 rows. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Filter. Signed to an MCN (agency) or not.","in":"query","name":"mcn","required":false,"schema":{"enum":["SIGNED","NOT_SIGNED"],"type":"string"}},{"description":"desc (default, highest first) or asc (lowest first among the matching rows; pair it with a revenue or units filter to skip dead listings). Applies with a keyword or category.","in":"query","name":"order","required":false,"schema":{"enum":["desc","asc"],"type":"string"}},{"description":"Filter. Average price of what they sell, in the market's currency, e.g. \u003c20.","in":"query","name":"price","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Filter. Revenue the creator drove in the market's currency over the window, e.g. \u003e10000.","in":"query","name":"revenue","required":false,"schema":{"type":"string"}},{"description":"Filter. Main revenue source: VIDEO or LIVE.","in":"query","name":"revenue_source","required":false,"schema":{"enum":["VIDEO","LIVE"],"type":"string"}},{"description":"Ranking metric: followers, growth, revenue, units. Default revenue. growth favours brand-new items (shown as \u003e999.9%); pair it with a revenue or units filter. Applies with a keyword or category.","in":"query","name":"sort","required":false,"schema":{"enum":["followers","growth","revenue","units"],"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":3,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"items":[{"creatorDebut":"2024-01-01","followers":"10.5k","handle":"denisebw75","id":"6805718817295614981","main_category":"{\"pri_main_category\":[\"601352\",\"601152\",\"600154\"],\"sec_main_category\":[\"601352-900488\",\"600154-808328\",\"601450-848648\"],\"ter_main_category\":[\"601352-900488-901000\",\"600154-808328-600157\",\"601450-848648-601555\"]}","new_followers":"0","nickname":"TikTok’s Favorite Lips 👄","revenue":"$15.23k","revenue_grouping_rate":3.1356722740088223,"revenue_trend":[29,317,123],"sale":"558","signature":"Mom/Mimi/Woman Roofer/beauty/skincare/fashion/TTS/Pop Up LIVEHOST #TTFL 👄","total":500,"unit_price":"$27.29","video_engagement_rate":"1.37%","views":"411.13k","views_trend":[5474,7337,9372]},{"creatorDebut":"2024-10-19","followers":"7.8k","handle":"drchristinbradley","id":"7397862193050485802","main_category":"{\"pri_main_category\":[\"601450\"],\"sec_main_category\":[\"601450-849160\",\"601450-856208\"],\"ter_main_category\":[\"601450-849160-873736\",\"601450-856208-855952\"]}","new_followers":"211","nickname":"Royal Alchemyst Body Oils","revenue":"$9.71k","revenue_grouping_rate":-0.18963460104399701,"revenue_trend":[952,0,0],"sale":"206","signature":"Squalane infused body oils💧\nJoin the ROYAL VIP LIST 👇🏾","total":500,"unit_price":"$47.14","video_engagement_rate":"-","views":"36.2k","views_trend":[2614,105,361]},{"creatorDebut":"2021-11-06","followers":"12.8k","handle":"danina73","id":"6758777337975899142","main_category":"{\"pri_main_category\":[\"601450\",\"603014\",\"601152\"],\"sec_main_category\":[\"601450-1086856\",\"603014-834568\",\"601152-842376\"],\"ter_main_category\":[\"601450-1086856-1004680\",\"603014-834568-836104\",\"601152-842376-601276\"]}","new_followers":"0","nickname":"Oil Dlr","revenue":"$7.64k","revenue_grouping_rate":-0.19263273734158493,"revenue_trend":[437,276,323],"sale":"376","signature":"✨Short girl approved✨\n✨Leggings I’m obsessed with✨\n✨Cute | Comfy Fits✨\n✨Wellness that Works✨","total":500,"unit_price":"$20.31","video_engagement_rate":"0.94%","views":"334.08k","views_trend":[30886,14386,25282]}],"keyword":"lip oil","market":"US","next":"eyJwYWdlIjoyLCJzaXplIjozfQ","notes":["Market US (United States): amounts are in USD."],"see_also":"Pass a row's id or handle to creator_commerce (sales, products, shops, audience) or creator (profile, posts).","sortedBy":"revenue","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totalMatched":500,"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjozfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"items":{"items":{"properties":{"creatorDebut":{"type":"string"},"followers":{"type":"string"},"handle":{"type":"string"},"id":{"type":"string"},"main_category":{"type":"string"},"new_followers":{"type":"string"},"nickname":{"type":"string"},"revenue":{"type":"string"},"revenue_grouping_rate":{"type":"number"},"revenue_trend":{"items":{"type":"integer"},"type":"array"},"sale":{"type":"string"},"signature":{"type":"string"},"total":{"type":"integer"},"unit_price":{"type":"string"},"video_engagement_rate":{"type":"string"},"views":{"type":"string"},"views_trend":{"items":{"type":"integer"},"type":"array"}},"type":"object"},"type":"array"},"keyword":{"type":"string"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"type":"string"},"sortedBy":{"type":"string"},"source":{"type":"string"},"totalMatched":{"type":"integer"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Top-selling TikTok Shop creators","tags":["creator_top_selling"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"","x-mcp-tool":"creator_top_selling"}},"/v1/categories/market-size":{"get":{"description":"This route: how many products, shops, creators, videos, LIVEs and brands Shop Analytics tracks.\n\n[Shop Analytics] The top TikTok Shop categories by estimated revenue over the last 7 days of data: revenue, units, growth, revenue per shop, top-3 and top-10 shop share, split by video, LIVE and affiliate. method=tree lists category names and ids (pass them as category to product_top_selling or creator_top_selling); method=products gives a category's top product ids; method=market_size counts what Shop Analytics tracks in a market, not all of TikTok Shop. region picks the market (default US). Example: {\"method\":\"tree\",\"keyword\":\"skincare\"}.","operationId":"GET_categories_market_size","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"counts":{"brands":21214,"creators":277023,"livestreams":191201,"products":1041879,"shops":114343,"videos":1441803},"dataEnd":"2026-10-28","market":"US","notes":["Market US (United States)."],"scope":"Totals tracked by the data source in this market, not all of TikTok Shop. They size the source's own coverage (items it follows), not sales, and not every seller, creator or video on TikTok.","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price."},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"counts":{"properties":{"brands":{"type":"integer"},"creators":{"type":"integer"},"livestreams":{"type":"integer"},"products":{"type":"integer"},"shops":{"type":"integer"},"videos":{"type":"integer"}},"type":"object"},"dataEnd":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"scope":{"type":"string"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Shop category trends · market_size","tags":["category_trends"],"x-credits":1,"x-mcp-method":"market_size","x-mcp-tool":"category_trends"}},"/v1/categories/products":{"get":{"description":"This route: a category's top product ids (US market only).\n\n[Shop Analytics] The top TikTok Shop categories by estimated revenue over the last 7 days of data: revenue, units, growth, revenue per shop, top-3 and top-10 shop share, split by video, LIVE and affiliate. method=tree lists category names and ids (pass them as category to product_top_selling or creator_top_selling); method=products gives a category's top product ids; method=market_size counts what Shop Analytics tracks in a market, not all of TikTok Shop. region picks the market (default US). Example: {\"method\":\"tree\",\"keyword\":\"skincare\"}.","operationId":"GET_categories_products","parameters":[{"description":"method=products: category name exactly as method=list returns it (cate_id), e.g. 'Beauty \u0026 Personal Care'.","example":"Beauty \u0026 Personal Care","in":"query","name":"category","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"category":"Beauty \u0026 Personal Care","currency":"USD","dataEnd":"2026-10-28","groups":[{"cate_id":"Beauty \u0026 Personal Care","product":[{"id":"1732738686074327162"},{"id":"1732738538912714757"},{"id":"1732052189676081387"}]}],"market":"US","notes":["Market US (United States): amounts are in USD."],"see_also":"Pass these ids to product method=sales with ids=[...] for revenue and units, or product_top_selling with a keyword for a full ranking.","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"category":{"type":"string"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"groups":{"items":{"properties":{"cate_id":{"type":"string"},"product":{"items":{"properties":{"id":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"type":"string"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Shop category trends · products","tags":["category_trends"],"x-credits":1,"x-example-params":{"category":"Beauty \u0026 Personal Care"},"x-mcp-method":"products","x-mcp-tool":"category_trends"}},"/v1/categories/search":{"get":{"description":"This route: find category names and ids by keyword.\n\n[Shop Analytics] The top TikTok Shop categories by estimated revenue over the last 7 days of data: revenue, units, growth, revenue per shop, top-3 and top-10 shop share, split by video, LIVE and affiliate. method=tree lists category names and ids (pass them as category to product_top_selling or creator_top_selling); method=products gives a category's top product ids; method=market_size counts what Shop Analytics tracks in a market, not all of TikTok Shop. region picks the market (default US). Example: {\"method\":\"tree\",\"keyword\":\"skincare\"}.","operationId":"GET_categories_search","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=search: category name to look up, e.g. 'serum'. method=tree: text to find in category names, e.g. 'skincare'.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","items":[{"id":805640,"name":"Kids' Fashion-Boys' Footwear-Slippers","score":0},{"id":806536,"name":"Kids' Fashion-Girls' Footwear-Slippers","score":0},{"id":601374,"name":"Shoes-Men's Shoes-Slippers","score":0}],"keyword":"lip oil","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price."},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"items":{"items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"score":{"type":"integer"}},"type":"object"},"type":"array"},"keyword":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Shop category trends · search","tags":["category_trends"],"x-credits":1,"x-example-params":{"keyword":"lip oil"},"x-mcp-method":"search","x-mcp-tool":"category_trends"}},"/v1/categories/top":{"get":{"description":"This route: categories with revenue, growth and concentration.\n\n[Shop Analytics] The top TikTok Shop categories by estimated revenue over the last 7 days of data: revenue, units, growth, revenue per shop, top-3 and top-10 shop share, split by video, LIVE and affiliate. method=tree lists category names and ids (pass them as category to product_top_selling or creator_top_selling); method=products gives a category's top product ids; method=market_size counts what Shop Analytics tracks in a market, not all of TikTok Shop. region picks the market (default US). Example: {\"method\":\"tree\",\"keyword\":\"skincare\"}.","operationId":"GET_categories_top","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"method=list or tree: keep only categories of this level (1 = top level, 3 = most specific).","in":"query","name":"level","required":false,"schema":{"enum":["1","2","3"],"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":10,"currency":"USD","dataEnd":"2026-10-28","items":[{"affiliate_revenue":"$72.32m","average_revenue":"$5.67k","cate_id":"Beauty \u0026 Personal Care","date_interval":"7d","id":"601450","level":"1","live_revenue":"$16.40m","name":"Beauty \u0026 Personal Care","revenue":"$89.73m","revenue_growth_rate":-0.1423943532521982,"revenue_trend":[1222082970,1304434512,1093114419],"self_promotion_revenue":"$7.23m","shop_number":15829,"shopping_mall_revenue":"$10.19m","showcase_revenue":"$12.93m","top_10_shop_revenue_ratio":0.184013778054234,"top_3_shop_revenue_ratio":0.09835574995436176,"video_revenue":"$60.40m"},{"affiliate_revenue":"$59.36m","average_revenue":"$5.39k","cate_id":"Womenswear \u0026 Underwear","date_interval":"7d","id":"601152","level":"1","live_revenue":"$9.50m","name":"Womenswear \u0026 Underwear","revenue":"$73.80m","revenue_growth_rate":-0.21692984191843792,"revenue_trend":[946945250,1094214841.5,827028189],"self_promotion_revenue":"$7.17m","shop_number":13701,"shopping_mall_revenue":"$7.26m","showcase_revenue":"$10.49m","top_10_shop_revenue_ratio":0.15677009265967165,"top_3_shop_revenue_ratio":0.07922574659084249,"video_revenue":"$53.81m"},{"affiliate_revenue":"$25.90m","average_revenue":"$2.66k","cate_id":"Sports \u0026 Outdoor","date_interval":"7d","id":"603014","level":"1","live_revenue":"$4.88m","name":"Sports \u0026 Outdoor","revenue":"$34.18m","revenue_growth_rate":-0.10448608774096589,"revenue_trend":[483660312,505927939,419452406],"self_promotion_revenue":"$3.31m","shop_number":12859,"shopping_mall_revenue":"$4.97m","showcase_revenue":"$6.87m","top_10_shop_revenue_ratio":0.20453100930944212,"top_3_shop_revenue_ratio":0.11515856825031943,"video_revenue":"$22.43m"}],"market":"US","notes":["Market US (United States): amounts are in USD.","Category figures always cover the last 7 days of data (window below), whatever window you ask for. For a longer view of one category, rank its products with product_top_selling and a keyword."],"see_also":"Pass a row's cate_id as category to category_trends method=products for its top product ids.","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":7,"end":"2026-10-28","start":"2026-10-22"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"items":{"items":{"properties":{"affiliate_revenue":{"type":"string"},"average_revenue":{"type":"string"},"cate_id":{"type":"string"},"date_interval":{"type":"string"},"id":{"type":"string"},"level":{"type":"string"},"live_revenue":{"type":"string"},"name":{"type":"string"},"revenue":{"type":"string"},"revenue_growth_rate":{"type":"number"},"revenue_trend":{"items":{"type":"integer"},"type":"array"},"self_promotion_revenue":{"type":"string"},"shop_number":{"type":"integer"},"shopping_mall_revenue":{"type":"string"},"showcase_revenue":{"type":"string"},"top_10_shop_revenue_ratio":{"type":"number"},"top_3_shop_revenue_ratio":{"type":"number"},"video_revenue":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"type":"string"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Shop category trends · list","tags":["category_trends"],"x-credits":1,"x-mcp-method":"list","x-mcp-tool":"category_trends"}},"/v1/categories/tree":{"get":{"description":"This route: category names and ids to use as category.\n\n[Shop Analytics] The top TikTok Shop categories by estimated revenue over the last 7 days of data: revenue, units, growth, revenue per shop, top-3 and top-10 shop share, split by video, LIVE and affiliate. method=tree lists category names and ids (pass them as category to product_top_selling or creator_top_selling); method=products gives a category's top product ids; method=market_size counts what Shop Analytics tracks in a market, not all of TikTok Shop. region picks the market (default US). Example: {\"method\":\"tree\",\"keyword\":\"skincare\"}.","operationId":"GET_categories_tree","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=search: category name to look up, e.g. 'serum'. method=tree: text to find in category names, e.g. 'skincare'.","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"method=list or tree: keep only categories of this level (1 = top level, 3 = most specific).","in":"query","name":"level","required":false,"schema":{"enum":["1","2","3"],"type":"string"}},{"description":"method=tree: max categories to return (default 50).","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":3,"hasMore":true,"items":[{"id":"600001","level":1,"name":"Home Supplies"},{"id":"600024","level":1,"name":"Kitchenware"},{"id":"600154","level":1,"name":"Textiles \u0026 Soft Furnishings"}],"matched":26,"see_also":"Pass an id or name as category to product_top_selling or creator_top_selling. Names are the US English category names; ids are the source's own.","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price."},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"hasMore":{"type":"boolean"},"items":{"items":{"properties":{"id":{"type":"string"},"level":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"type":"array"},"matched":{"type":"integer"},"see_also":{"type":"string"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Shop category trends · tree","tags":["category_trends"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"tree","x-mcp-tool":"category_trends"}},"/v1/charts/hashtags":{"get":{"description":"This route: trending hashtags in a market (7, 30 or 90 days).\n\nTikTok's own leaderboards. sounds: the music chart (Top 50 or Viral 50; TikTok's chart, not per market). hashtags: trending hashtags in a market over 7, 30 or 90 days, with posts, views and a daily popularity curve (empty for PL, NL and IE). searches: trending search phrases TikTok's website shows. live: TikTok's LIVE leaderboard (daily gifts or LIVE sales), as TikTok's app serves it; not per market. videos: yesterday's top 100 videos in a market with views, organic views, engagement rate and 6-second view rate (TikTok has this list for US, JP, TH, ID and VN; other markets come back empty). Examples: {\"method\":\"hashtags\",\"region\":\"DE\",\"period\":\"30\"}, {\"method\":\"sounds\",\"chart\":\"viral\"}.","operationId":"GET_charts_hashtags","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. sounds max 50, hashtags max 50, searches max 100, live max 100, videos max 100. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=hashtags: last 7, 30 or 90 days (default 7).","in":"query","name":"period","required":false,"schema":{"enum":["7","30","90"],"type":"string"}},{"description":"method=hashtags or videos: market, one of US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX, PL, IT, NL, IE (default US).","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-15","count":3,"has_more":true,"items":[{"id":"7691443554018656263","name":"tiktokscaryhorrorcontest","popularity":[["2026-10-09",0],["2026-10-10",49.96],["2026-10-11",62.601]],"posts":73462,"rank":1,"top_creators":[{"country":"US","followers":116246,"handle":"sadwds213s"},{"country":"US","followers":19261,"handle":"dpaex.uxofj"},{"country":"US","followers":121772,"handle":"y6f_7ur2ca8"}],"views":312182870},{"id":"7462773581512966150","industry_ids":[25000000000],"name":"marvelrivalsavengers","popularity":[["2026-10-09",95.543],["2026-10-10",100],["2026-10-11",9.725]],"posts":110088,"rank":2,"top_creators":[{"country":"US","followers":7222,"handle":"cinnavry"},{"country":"US","followers":16364,"handle":"zygote907"},{"country":"US","followers":361231,"handle":"power.of.me.5"}],"views":24120743},{"id":"7534678037321744414","industry_ids":[23000000000],"name":"livecanbeeasy","popularity":[["2026-10-09",0],["2026-10-10",4.117],["2026-10-11",3.22]],"posts":21285,"rank":3,"top_creators":[{"country":"US","followers":32355,"handle":"bigalgladiator"},{"country":"US","followers":369670,"handle":"aesthetic_affairsx"},{"country":"US","followers":18399,"handle":"salvi_503"}],"views":30155625}],"market":"US","next":"eyJwYWdlIjoyfQ","notes":["posts and views are TikTok's counts for the period. popularity is TikTok's daily index, [date, value], 100 = the hashtag's peak in the period.","TikTok's period ends 2026-10-15 (its trending-hashtag data runs behind today)."],"period_days":7,"see_also":["hashtag_search keyword=\u003citems[].name\u003e"],"source":"tiktok_live","total":100},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"items":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"popularity":{"items":{"items":{"type":"string"},"type":"array"},"type":"array"},"posts":{"type":"integer"},"rank":{"type":"integer"},"top_creators":{"items":{"properties":{"country":{"type":"string"},"followers":{"type":"integer"},"handle":{"type":"string"}},"type":"object"},"type":"array"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"period_days":{"type":"integer"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"total":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok charts · hashtags","tags":["charts"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"hashtags","x-mcp-tool":"charts"}},"/v1/charts/live":{"get":{"description":"This route: LIVE leaderboard (daily gifts or sales).\n\nTikTok's own leaderboards. sounds: the music chart (Top 50 or Viral 50; TikTok's chart, not per market). hashtags: trending hashtags in a market over 7, 30 or 90 days, with posts, views and a daily popularity curve (empty for PL, NL and IE). searches: trending search phrases TikTok's website shows. live: TikTok's LIVE leaderboard (daily gifts or LIVE sales), as TikTok's app serves it; not per market. videos: yesterday's top 100 videos in a market with views, organic views, engagement rate and 6-second view rate (TikTok has this list for US, JP, TH, ID and VN; other markets come back empty). Examples: {\"method\":\"hashtags\",\"region\":\"DE\",\"period\":\"30\"}, {\"method\":\"sounds\",\"chart\":\"viral\"}.","operationId":"GET_charts_live","parameters":[{"description":"method=live: daily (gift points today, default) or sales (LIVE sales leaderboard).","in":"query","name":"board","required":false,"schema":{"enum":["daily","sales"],"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. sounds max 50, hashtags max 50, searches max 100, live max 100, videos max 100. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:27:15Z","board":"daily","count":3,"has_more":false,"items":[{"followers":10838,"handle":"jaybastardo","nickname":"Jay Bastardo","rank":1,"score":5388066,"user_id":"6770557577682027526"},{"followers":1077302,"handle":"nickthetraveler","nickname":"Nick ✈️","rank":2,"score":3012043,"user_id":"6791149056796574726"},{"followers":12567,"handle":"destroyer.galaxy","nickname":"Destroyer","rank":3,"score":1705220,"user_id":"7582763175394870286"}],"market":"as TikTok's app serves it (not per market)","notes":["score is the creator's gift points on TikTok's daily LIVE leaderboard.","room_id is present only while the creator is LIVE."],"resets_at":"2026-10-31T04:00:00Z","see_also":["creator id=@\u003citems[].handle\u003e","live id=\u003citems[].room_id\u003e"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"board":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"items":{"items":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"nickname":{"type":"string"},"rank":{"type":"integer"},"score":{"type":"integer"},"user_id":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"resets_at":{"type":"string"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok charts · live","tags":["charts"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"live","x-mcp-tool":"charts"}},"/v1/charts/searches":{"get":{"description":"This route: trending search phrases.\n\nTikTok's own leaderboards. sounds: the music chart (Top 50 or Viral 50; TikTok's chart, not per market). hashtags: trending hashtags in a market over 7, 30 or 90 days, with posts, views and a daily popularity curve (empty for PL, NL and IE). searches: trending search phrases TikTok's website shows. live: TikTok's LIVE leaderboard (daily gifts or LIVE sales), as TikTok's app serves it; not per market. videos: yesterday's top 100 videos in a market with views, organic views, engagement rate and 6-second view rate (TikTok has this list for US, JP, TH, ID and VN; other markets come back empty). Examples: {\"method\":\"hashtags\",\"region\":\"DE\",\"period\":\"30\"}, {\"method\":\"sounds\",\"chart\":\"viral\"}.","operationId":"GET_charts_searches","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. sounds max 50, hashtags max 50, searches max 100, live max 100, videos max 100. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:28:14Z","count":3,"has_more":true,"items":[{"phrase":"Hyena makeup for Halloween trend","rank":1},{"phrase":"Waddup My Dawg meme trend","rank":2},{"phrase":"Fancy Footwork trend","rank":3}],"market":"TikTok website (not per market)","notes":["Phrases in the order TikTok's website lists them. They are not search volumes; use demand_find_topics for volume."],"see_also":["demand_find_topics keyword=\u003citems[].phrase\u003e","video_search keyword=\u003citems[].phrase\u003e"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"items":{"items":{"properties":{"phrase":{"type":"string"},"rank":{"type":"integer"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok charts · searches","tags":["charts"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"searches","x-mcp-tool":"charts"}},"/v1/charts/sounds":{"get":{"description":"This route: TikTok's music chart (Top 50 or Viral 50).\n\nTikTok's own leaderboards. sounds: the music chart (Top 50 or Viral 50; TikTok's chart, not per market). hashtags: trending hashtags in a market over 7, 30 or 90 days, with posts, views and a daily popularity curve (empty for PL, NL and IE). searches: trending search phrases TikTok's website shows. live: TikTok's LIVE leaderboard (daily gifts or LIVE sales), as TikTok's app serves it; not per market. videos: yesterday's top 100 videos in a market with views, organic views, engagement rate and 6-second view rate (TikTok has this list for US, JP, TH, ID and VN; other markets come back empty). Examples: {\"method\":\"hashtags\",\"region\":\"DE\",\"period\":\"30\"}, {\"method\":\"sounds\",\"chart\":\"viral\"}.","operationId":"GET_charts_sounds","parameters":[{"description":"method=sounds: top (Top 50, default) or viral (Viral 50).","in":"query","name":"chart","required":false,"schema":{"enum":["top","viral"],"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. sounds max 50, hashtags max 50, searches max 100, live max 100, videos max 100. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-29","chart":"top","count":3,"has_more":true,"items":[{"album":"Kiss All The Time. Disco, Occasionally.","author":"Harry Styles","cleared_for_business":true,"duration":60,"id":"7613798254214187009","original":false,"rank":1,"release_date":"2026-03-06","title":"Coming Up Roses","trend":4,"videos":209442},{"album":"Housewife","author":"Tate McRae","cleared_for_business":true,"duration":36,"id":"7697010651306838068","original":false,"rank":2,"release_date":"2026-10-15","title":"Housewife","trend":4,"videos":401171},{"album":"Metropolitan","author":"Nova Charisma","cleared_for_business":true,"duration":60,"id":"7370364561877321729","original":false,"rank":3,"title":"Stolen From Each Other","trend":4,"videos":8479}],"market":"TikTok chart (not per market)","next":"eyJvZmZzZXQiOjN9","notes":["videos is TikTok's count of posts using the sound. cleared_for_business is TikTok's commercial-music flag. trend is TikTok's rank-movement code for the entry, passed on as TikTok sends it."],"see_also":["sound method=videos id=\u003citems[].id\u003e"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"chart":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"items":{"items":{"properties":{"album":{"type":"string"},"author":{"type":"string"},"cleared_for_business":{"type":"boolean"},"duration":{"type":"integer"},"id":{"type":"string"},"original":{"type":"boolean"},"rank":{"type":"integer"},"release_date":{"type":"string"},"title":{"type":"string"},"trend":{"type":"integer"},"videos":{"type":"integer"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok charts · sounds","tags":["charts"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"sounds","x-mcp-tool":"charts"}},"/v1/charts/videos":{"get":{"description":"This route: yesterday's top 100 videos in a market.\n\nTikTok's own leaderboards. sounds: the music chart (Top 50 or Viral 50; TikTok's chart, not per market). hashtags: trending hashtags in a market over 7, 30 or 90 days, with posts, views and a daily popularity curve (empty for PL, NL and IE). searches: trending search phrases TikTok's website shows. live: TikTok's LIVE leaderboard (daily gifts or LIVE sales), as TikTok's app serves it; not per market. videos: yesterday's top 100 videos in a market with views, organic views, engagement rate and 6-second view rate (TikTok has this list for US, JP, TH, ID and VN; other markets come back empty). Examples: {\"method\":\"hashtags\",\"region\":\"DE\",\"period\":\"30\"}, {\"method\":\"sounds\",\"chart\":\"viral\"}.","operationId":"GET_charts_videos","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. sounds max 50, hashtags max 50, searches max 100, live max 100, videos max 100. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=hashtags or videos: market, one of US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX, PL, IT, NL, IE (default US).","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-29","count":3,"has_more":true,"items":[{"cover":"https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogejjeAR8AEFQ7CvAMjVT3EDFQIqWIAHeiAIxD~tplv-tiktokx-origin.image?dr=9643\u0026nonce=16187\u0026refresh_token=454bd0fc425e4d6eb7d33033b05b8307\u0026x-expires=1794006000\u0026x-signature=OA1Xa3cs34T6Wn6EvilVDkTQ4iM%3D\u0026idc=useast5\u0026ps=13740610\u0026shcp=89439a58\u0026sh…","created":"2026-09-10","engagement_rate":0.001279374872518347,"followers":17082381,"handle":"fefe","id":"7684011124739656991","nickname":"Fefe","organic_views":1898401,"rank":1,"six_second_view_rate":0.02428703324049609,"title":"Existe combinação mais perfeita do que RUFFLES®️ e um bom filme? Impossível! Todo filme pede aquela crocância única para entrar no clima. 🎬✨ @br_ruffles  #publicidade #Ruffles #DêPlayNaSuaOnda","views":32906696},{"cover":"https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocK3E0iPwBkRoAA5XXAPvCEAiBoiaIcqlA9Cp~tplv-tiktokx-origin.image?dr=9643\u0026nonce=94514\u0026refresh_token=524b401cbb1fe7da2608837e4330079b\u0026x-expires=1794006000\u0026x-signature=TUYs89H5VNGFHB%2FB0vea2XXXv%2Fk%3D\u0026idc=useast5\u0026ps=13740610\u0026shcp=89439a58…","created":"2026-08-26","engagement_rate":0.0018894018055804198,"followers":250572,"handle":"megannco","id":"7678479724896587038","nickname":"Meg Ann Co.","organic_views":2735418,"rank":2,"six_second_view_rate":0.0342646857694568,"title":"Five years ago, I started my small business with no idea what it would grow into. From working out of my parents’ spare room to now having my own commercial space, @Shopify has been there every step of the way! Having the freedom to build a storefront that actually feels like my brand, from the fo…","views":31280800},{"cover":"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oEIAYqIEfCBAwgRNg9QAFFEDgMDDorAQmfEyGS~tplv-tiktokx-origin.image?dr=9643\u0026nonce=55110\u0026refresh_token=9727c5cb391721576eb26f7bc667c835\u0026x-expires=1794006000\u0026x-signature=qLkSy%2BBIhbNo%2FreeaceACf18570%3D\u0026idc=useast5\u0026ps=13740610\u0026shcp=89439a58…","created":"2026-09-17","engagement_rate":0.0005375644554008684,"followers":75381,"handle":"pierrahh","id":"7686545222628658446","nickname":"pierrah","organic_views":446268,"rank":3,"six_second_view_rate":0.011719839544846095,"title":"#walmartpartner runway silhouettes sourced at a cute price point. shop for your fall wardrobe @Walmart","views":24601701}],"market":"US","next":"eyJwYWdlIjoyfQ","notes":["TikTok's daily top-videos list for US, day ending 2026-10-29 UTC. views and organic_views are for that day; rates are fractions (0.012 = 1.2%)."],"see_also":["video id=\u003citems[].id\u003e"],"source":"tiktok_live","total":100},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"items":{"items":{"properties":{"cover":{"type":"string"},"created":{"type":"string"},"engagement_rate":{"type":"number"},"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"organic_views":{"type":"integer"},"rank":{"type":"integer"},"six_second_view_rate":{"type":"number"},"title":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"total":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok charts · videos","tags":["charts"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"videos","x-mcp-tool":"charts"}},"/v1/creative-center/partners":{"get":{"description":"This route: Creative Partner agencies for a market.\n\nTikTok Creative Center: top videos by market (US, JP, VN, TH, ID), public SEO inspiration lists, and Creative Partner agency leaderboards. Example: {\"method\":\"top_videos\",\"country\":\"JP\",\"sort\":\"engagement\"}.","operationId":"GET_creative_center_partners","parameters":[{"description":"method=top_videos: US (default), JP, VN, TH or ID. method=partners: market code from reference method=creative_markets, e.g. TH (default US, where TikTok lists no partners).","example":"US","in":"query","name":"country","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=partners: unix timestamp from reference method=creative_markets.","in":"query","name":"query_date","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"partners":[]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"partners":{"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Creative Center · partners","tags":["creative_center"],"x-credits":1,"x-example-params":{"country":"US"},"x-mcp-method":"partners","x-mcp-tool":"creative_center"}},"/v1/creative-center/seo":{"get":{"description":"This route: public SEO inspiration names by type.\n\nTikTok Creative Center: top videos by market (US, JP, VN, TH, ID), public SEO inspiration lists, and Creative Partner agency leaderboards. Example: {\"method\":\"top_videos\",\"country\":\"JP\",\"sort\":\"engagement\"}.","operationId":"GET_creative_center_seo","parameters":[{"description":"method=seo_list or seo_detail: which list.","example":"keyword","in":"query","name":"biz_type","required":false,"schema":{"enum":["keyword","hashtag","selling_points","top_content","top_ads"],"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"names":[],"updated":"2026-10-30T00:00:00Z"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"names":{"type":"array"},"updated":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Creative Center · seo_list","tags":["creative_center"],"x-credits":1,"x-example-params":{"biz_type":"keyword"},"x-mcp-method":"seo_list","x-mcp-tool":"creative_center"}},"/v1/creative-center/seo/detail":{"get":{"description":"This route: detail for names from seo_list.\n\nTikTok Creative Center: top videos by market (US, JP, VN, TH, ID), public SEO inspiration lists, and Creative Partner agency leaderboards. Example: {\"method\":\"top_videos\",\"country\":\"JP\",\"sort\":\"engagement\"}.","operationId":"GET_creative_center_seo_detail","parameters":[{"description":"method=seo_list or seo_detail: which list.","in":"query","name":"biz_type","required":false,"schema":{"enum":["keyword","hashtag","selling_points","top_content","top_ads"],"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=seo_detail: exact names from method=seo_list.","in":"query","name":"names","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record."},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Creative Center · seo_detail","tags":["creative_center"],"x-credits":1,"x-mcp-method":"seo_detail","x-mcp-tool":"creative_center"}},"/v1/creative-center/top-videos":{"get":{"description":"This route: trending videos by market with engagement.\n\nTikTok Creative Center: top videos by market (US, JP, VN, TH, ID), public SEO inspiration lists, and Creative Partner agency leaderboards. Example: {\"method\":\"top_videos\",\"country\":\"JP\",\"sort\":\"engagement\"}.","operationId":"GET_creative_center_top_videos","parameters":[{"description":"method=top_videos: US (default), JP, VN, TH or ID. method=partners: market code from reference method=creative_markets, e.g. TH (default US, where TikTok lists no partners).","in":"query","name":"country","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. method=top_videos max 20 (TikTok often returns 4). Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=top_videos: page 1-25.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"method=top_videos: week (default), day or long.","in":"query","name":"period","required":false,"schema":{"enum":["week","day","long"],"type":"string"}},{"description":"method=top_videos: unix seconds for the ranking close; 0 = last Sunday.","in":"query","name":"period_end","required":false,"schema":{"type":"integer"}},{"description":"method=top_videos: views (default), engagement or six_seconds_vtr.","in":"query","name":"sort","required":false,"schema":{"enum":["views","engagement","six_seconds_vtr"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJwYWdlIjoyfQ","videos":[{"caption":"プロ達の評価が恐ろしく高い プリュスオーから新作がでた plus eau（プリュスオー） リポルムシャンプー・トリートメント　各1,650円（税込） 全国のドラッグストア・バラエティストア等で販売中！ #PR #pluseau #シャンプー #��…","engagementRate":0.00048087144629807885,"handle":"yuya.koyama","id":"7694996589001248021","nickname":"こやゆう【美髪アドバイザー】","posted":"2026-10-10T11:16:58Z","url":"https://www.tiktok.com/@yuya.koyama/video/7694996589001248021","views":5893467},{"caption":"友達の様子が突然変わったらみんなはどうする？？💖好きな人ができたのかな？とか色々考えちゃうよね！ 鼻の黒ずみ*で悩んでいるならクレンジングはパーフェクトワンフォーカスの黒バームが推し🎶リニューアル前も��…","engagementRate":0.00901324900435645,"handle":"maipan_03","id":"7698310710845115668","nickname":"まいぱん🍞","posted":"2026-10-19T09:37:26Z","url":"https://www.tiktok.com/@maipan_03/video/7698310710845115668","views":5766622},{"caption":"この主人公、不気味すぎる... #PR #ハズカシゲーム #LINEマンガ #無料マンガ","engagementRate":0.002261597480148014,"handle":"motsumotsu_manga","id":"7694498082603552021","nickname":"もつもつ🍆漫画紹介のひと","posted":"2026-10-09T03:02:30Z","url":"https://www.tiktok.com/@motsumotsu_manga/video/7694498082603552021","views":5078711}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"engagementRate":{"type":"number"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"posted":{"type":"string"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok Creative Center · top_videos","tags":["creative_center"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"top_videos","x-mcp-tool":"creative_center"}},"/v1/creators/{id}":{"get":{"description":"This route: followers, likes, videos, bio, link, verified, Shop seller, ids.\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"bio":"Just Do It.","bioLink":"http://empli.fi/niketiktok","followers":9345115,"following":91,"handle":"nike","id":"208464585232822272","likes":50478646,"nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","url":"https://www.tiktok.com/@nike","verified":true,"videos":1147},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"bio":{"type":"string"},"bioLink":{"type":"string"},"followers":{"type":"integer"},"following":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"likes":{"type":"integer"},"nickname":{"type":"string"},"secUid":{"type":"string"},"url":{"type":"string"},"verified":{"type":"boolean"},"videos":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · profile","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike"},"x-mcp-method":"profile","x-mcp-tool":"creator"}},"/v1/creators/{id}/audit":{"get":{"description":"This route: registered country, ids, TikTok milestones (started posting, follower marks).\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_audit","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:27:19Z","country":"US","followers":9345458,"handle":"nike","likes":50478595,"milestones":[{"date":"2021-06-05","title":"Reached 1M followers","top_posts":["6947750712164093189","6960708098977729797","6965902749355625734"]},{"date":"2020-03-27","title":"Reached 500K followers","top_posts":["6795435424132205829","6797470670591741190","6795576861863775493"]},{"date":"2020-02-13","title":"Reached 100K followers","top_posts":["6792724034258750726","6792723599254981893","6792722035081579782"]}],"nickname":"Nike","notes":["Calls made: TikTok's account-country lookup and its creator milestones.","country is the country TikTok has on record for the account, not where its followers are.","TikTok does not expose the account creation date; started_posting is the first milestone TikTok shows."],"sec_uid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","see_also":["creator method=profile id=@nike","creator method=lookalikes id=@nike"],"source":"tiktok_live","started_posting":"2017-03-24","user_id":"208464585232822272"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"country":{"type":"string"},"followers":{"type":"integer"},"handle":{"type":"string"},"likes":{"type":"integer"},"milestones":{"items":{"properties":{"date":{"type":"string"},"title":{"type":"string"},"top_posts":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"nickname":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"sec_uid":{"type":"string"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"started_posting":{"type":"string"},"user_id":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · audit","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike"},"x-mcp-method":"audit","x-mcp-tool":"creator"}},"/v1/creators/{id}/collections":{"get":{"description":"This route: public saved collections (often empty).\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_collections","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":false,"playlists":[]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"playlists":{"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · collections","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":3},"x-mcp-method":"collections","x-mcp-tool":"creator"}},"/v1/creators/{id}/embed":{"get":{"description":"This route: posts in the creator's embed widget.\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_embed","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":false,"videos":[{"caption":"Sculpted out of endless curiosity. Built for an obsession with better.  The Kobe 10 Protro arrives 8.23.","comments":0,"creator":{"handle":"nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"},"id":"7670207038068215054","likes":0,"saves":0,"shares":0,"url":"https://www.tiktok.com/@nike/video/7670207038068215054","views":1100000},{"caption":"(✨️life changing title✨️)#kitten #why #confetti #weirdshithappenstome #whyandhowthefuckisthisconfettiflying","comments":0,"creator":{"handle":"ech0d0gg","secUid":"MS4wLjABAAAAWvoibP5ag1boCZQKyWxN2IAWjXUi5JCEZsa97O_f8nTG-BXFORDu7j8QR60jpbxX"},"id":"7699977998820281620","likes":0,"saves":0,"shares":0,"url":"https://www.tiktok.com/@ech0d0gg/video/7699977998820281620","views":9000000}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"handle":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"id":{"type":"string"},"likes":{"type":"integer"},"saves":{"type":"integer"},"shares":{"type":"integer"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · embed","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":3},"x-mcp-method":"embed","x-mcp-tool":"creator"}},"/v1/creators/{id}/followers":{"get":{"description":"This route: followers, when TikTok shows them (usually hidden).\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_followers","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"accounts":[{"followers":864,"handle":"an_a1130","id":"7151412295716045870","nickname":"𝒜𝓃𝒶","secUid":"MS4wLjABAAAAXO8B9taNnHhJTyIOFTVDQjg3nBJ0yf-3ByIJs0ZqWky9Ikt8A039USDtWurUDwfO","verified":true},{"followers":33,"handle":"igorkrepe","id":"7510391742630282247","nickname":"iguins_rlk","secUid":"MS4wLjABAAAAS7BUaaFIDbK1U9nziOV1KKZKlIzHmgiR2bxaWGJx0fn-EVFrxu_P6AXfMhM8i1cR","verified":true},{"followers":227,"handle":"random_things__5","id":"7470355816270627883","nickname":"randomstuff","secUid":"MS4wLjABAAAAnhNCoUXQk-1nudlsOoITQqtXqcbqTMMUwdFgP7Vaj7z0KI5jebFAftvY2iF6MCLw","verified":true}],"hasMore":true,"max_time":1793402802,"min_time":1793402752,"myself_user_id":"0","next":"eyJtYXhfY3Vyc29yIjoiMTc5MzQwMjgwMiIsIm1pbl9jdXJzb3IiOiIxNzkzNDAyNzUyIn0","next_page_token":"eyJtYXhfY3Vyc29yIjoxNzkzNDAyNzc0LCJtaW5fY3Vyc29yIjoxNzkzNDAyNzUyfQ==","version":"v2"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJtYXhfY3Vyc29yIjoiMTc5MzQwMjgwMiIsIm1pbl9jdXJzb3IiOiIxNzkzNDAyNzUyIn0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"accounts":{"items":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"type":"array"},"hasMore":{"type":"boolean"},"max_time":{"type":"integer"},"min_time":{"type":"integer"},"myself_user_id":{"type":"string"},"next":{"type":"string"},"next_page_token":{"type":"string"},"version":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · followers","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":"3"},"x-mcp-method":"followers","x-mcp-tool":"creator"}},"/v1/creators/{id}/following":{"get":{"description":"This route: accounts followed, when shown (usually hidden).\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_following","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"tiktok","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"accounts":[{"followers":9000000,"handle":"tiktokcreators","id":"6551237489917432832","nickname":"tiktok creators","secUid":"MS4wLjABAAAAXqqA-cLDC0hfQPIrS5APYNsg04zkl-socWCkqkI3UIOaEe6_Qnokg0GcWpLnMNQP","verified":true}],"hasMore":false,"isTruncated":false},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"accounts":{"items":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"type":"array"},"hasMore":{"type":"boolean"},"isTruncated":{"type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · following","tags":["creator"],"x-credits":1,"x-example-params":{"id":"tiktok","limit":3},"x-mcp-method":"following","x-mcp-tool":"creator"}},"/v1/creators/{id}/likes":{"get":{"description":"This route: public Liked tab (empty when hidden).\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_likes","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOiIxNzkzMTQzODIxMDAwIn0","videos":[]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOiIxNzkzMTQzODIxMDAwIn0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · likes","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":3},"x-mcp-method":"likes","x-mcp-tool":"creator"}},"/v1/creators/{id}/lookalikes":{"get":{"description":"This route: accounts TikTok suggests as similar.\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_lookalikes","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:27:20Z","count":3,"has_more":true,"id":"nike","items":[{"bio":"Energy, Uncompromised. \n\nIntentional energy to unlock clarity.","followers":34122,"handle":"drinkupdate","likes":911029,"nickname":"Update","sec_uid":"MS4wLjABAAAA-9wqJbm_0WZLTwJ0M9y3dqpQwIVlxcgkRlr18Gu6FgZWAxv7KU7ch8RQz403erSB","user_id":"7579300616255718413","verified":false,"videos":55},{"bio":"The next generation of underwear and loungewear.","followers":3072432,"handle":"skims","likes":40256030,"nickname":"SKIMS","sec_uid":"MS4wLjABAAAAMe5oovmTxsAE9a4nA3cGv2QXfvAPoPYw1Pnvg9nHtgSIqYLU2zcf4LmWWPGRRcn0","user_id":"6714013419890852870","verified":true,"videos":3246},{"bio":"Managed by parents\n Use code Saint10 at\n@Charge Graphics","followers":83972,"handle":".s4into","likes":1430253,"nickname":"SAINT2STEEZY","sec_uid":"MS4wLjABAAAA-oDAVsukJBl04OTSqtYkh41UhbSfQ0kIAkNZfd62Rz3Y3jky9l61tTb81IP1XBF9","user_id":"7588795210720281613","verified":false,"videos":129}],"next":"eyJ0b2tlbiI6Ik16QT0ifQ","notes":["TikTok's own similar-account suggestions, in TikTok's order. Not ranked by TokConnect."],"see_also":["creator method=audit id=@\u003citems[].handle\u003e","creator method=profile id=@\u003citems[].handle\u003e"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJ0b2tlbiI6Ik16QT0ifQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"bio":{"type":"string"},"followers":{"type":"integer"},"handle":{"type":"string"},"likes":{"type":"integer"},"nickname":{"type":"string"},"sec_uid":{"type":"string"},"user_id":{"type":"string"},"verified":{"type":"boolean"},"videos":{"type":"integer"}},"type":"object"},"type":"array"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · lookalikes","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":"3"},"x-mcp-method":"lookalikes","x-mcp-tool":"creator"}},"/v1/creators/{id}/playlists":{"get":{"description":"This route: public playlists (ids for creator_playlist).\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_playlists","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOiIzIn0","playlists":[{"creator":{"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"},"id":"7628692798685940494","name":"Athlete Versus","videos":4},{"creator":{"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"},"id":"7352922358623062826","name":"Air Max Dn BTS","videos":5},{"creator":{"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"},"id":"7268891136851413806","name":"1000Victories","videos":19}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOiIzIn0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"playlists":{"items":{"properties":{"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"id":{"type":"string"},"name":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · playlists","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":"3"},"x-mcp-method":"playlists","x-mcp-tool":"creator"}},"/v1/creators/{id}/posts":{"get":{"description":"This route: posts, newest first, with counts and linked products.\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_posts","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOjE3OTMyNDM2NjYwMDB9","videos":[{"caption":"Welcome to New York City. This tour is 26.2 miles and will take everything you've got. See you at the finish. #nikerunning #fiveboroughs #marathon #fyp","comments":30,"creator":{"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","verified":true},"durationSec":13,"hashtags":[{"id":"13020056","name":"nikerunning"},{"id":"77850878","name":"fiveboroughs"},{"id":"20467","name":"marathon"}],"id":"7702531221674347789","language":"en","likes":590,"posted":"2026-10-30T18:35:40Z","saves":12,"shares":7,"sound":{"author":"Nike","id":"7702531360175098638","original":true,"title":"原声 - Nike"},"url":"https://www.tiktok.com/@nike/video/7702531221674347789","views":8168},{"caption":"Nike Jewelry just landed. Check the SNKRS app for more. #nike #jewelry #fyp","comments":50,"creator":{"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","verified":true},"durationSec":7,"hashtags":[{"id":"9789","name":"nike"},{"id":"21519","name":"jewelry"},{"id":"229207","name":"fyp"}],"id":"7702142102230158606","language":"en","likes":2596,"posted":"2026-10-29T17:25:17Z","saves":104,"shares":28,"sound":{"author":"Nike","id":"7702142090700180238","original":true,"title":"原声 - Nike"},"url":"https://www.tiktok.com/@nike/video/7702142102230158606","views":35963},{"caption":"How refreshing. A 57-year thirst has been quenched.","comments":41,"creator":{"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","verified":true},"durationSec":28,"id":"7701922739875089678","language":"en","likes":1269,"posted":"2026-10-29T03:14:26Z","saves":45,"shares":12,"sound":{"author":"Nike","id":"7701922865952983822","original":true,"title":"原声 - Nike"},"url":"https://www.tiktok.com/@nike/video/7701922739875089678","views":19870}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjE3OTMyNDM2NjYwMDB9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"durationSec":{"type":"integer"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · posts","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":"3"},"x-mcp-method":"posts","x-mcp-tool":"creator"}},"/v1/creators/{id}/reposts":{"get":{"description":"This route: posts the creator reposted.\n\nOne creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections. Pass any identifier; TokConnect resolves the ids. For what the creator sells or earns, the products they link, or their follower demographics, use creator_commerce. Example: {\"id\":\"@dollskill\",\"method\":\"posts\"}. method=audit reports the account's registered country, ids and TikTok's milestones (started posting, follower marks); method=lookalikes lists accounts TikTok suggests as similar. Example: {\"id\":\"@nike\",\"method\":\"audit\"}.","operationId":"GET_creators_id_reposts","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"nike","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. posts max 35, others max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOiIzIn0","videos":[{"caption":"Golden boots for a golden player ✨","comments":74,"creator":{"followers":67500,"handle":"londoncitylionesses","id":"6815596123420525573","nickname":"londoncitylionesses","secUid":"MS4wLjABAAAACewsvrGMrmompNpDsbDcxWQnGMdve7wSF-RshmCY2980g9YC6p3Sy121iV8rZtbz"},"durationSec":46,"id":"7701372324020276502","language":"en","likes":14600,"posted":"2026-10-27T15:38:02Z","saves":1053,"shares":482,"sound":{"author":"londoncitylionesses","id":"7701372337848961814","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@londoncitylionesses/video/7701372324020276502","views":118900},{"caption":"Alpha Chi ❤︎’s @Nike  Shoutout to Nike for gifting our new member class their new Studio Fleece! Seriously the best sweatsets ever! #nikeaxo #studiofleece #nike #sorority #universityofsouthcarolina","comments":222,"creator":{"followers":39900,"handle":"alphachiuofsc","id":"7047632338502796334","nickname":"ALPHA CHI USC","secUid":"MS4wLjABAAAAO7_-6IqQYl0sEDTZRi7gf1YkQbYcMLOuEpDsrU6DjbsKTzr0pCn3A5wHmp8EwtCG"},"durationSec":11,"hashtags":[{"id":"7677236652473286669","name":"nikeaxo"},{"id":"7662951028928544782","name":"studiofleece"},{"id":"9789","name":"nike"}],"id":"7677263890794761503","language":"en","likes":26300,"posted":"2026-08-23T16:25:13Z","saves":546,"shares":1031,"sound":{"author":"twokay","id":"7531317665290390273","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@alphachiuofsc/video/7677263890794761503","views":488800},{"caption":"OH NO! @LSU TIGER GIRLS we stole your girl 😉 PC ‘26 JUST DO IT \u0026 GO DZ!!!  Thank you @Nike #teamnike  Choreo by: @Carsen R. @Sammy McFadden  #asudznike #notlikeus #rushtok #sorority","comments":1817,"creator":{"followers":74400,"handle":"asudeltazeta","id":"6821168696859395077","nickname":"ASU Delta Zeta","secUid":"MS4wLjABAAAAPO9are-WaNTkxqwEdkFhTU2pOh8EEOnWTY5IxajgQ0NGDunDtzXlpWgSB17LGYrX"},"durationSec":20,"hashtags":[{"id":"351929","name":"teamnike"},{"id":"7672433323716640798","name":"asudznike"},{"id":"25392924","name":"notlikeus"}],"id":"7672486939706019102","language":"en","likes":421100,"posted":"2026-08-10T19:28:08Z","saves":9957,"shares":16500,"sound":{"author":"ASU Delta Zeta","id":"7672486895805025054","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@asudeltazeta/video/7672486939706019102","views":4200000}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOiIzIn0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"integer"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok creator · reposts","tags":["creator"],"x-credits":1,"x-example-params":{"id":"nike","limit":"3"},"x-mcp-method":"reposts","x-mcp-tool":"creator"}},"/v1/creators/{id}/shop/audience":{"get":{"description":"This route: follower age, gender, top locations and languages, active hours (when Shop Analytics has built it).\n\nWhat a creator sells. Live: linked_products (products linked in recent posts, with views; no sales). [Shop Analytics, any market via region]: sales (revenue, units, video vs LIVE), trend (daily), products (with revenue), shops (brands they sell for), videos (selling videos), audience (follower age, gender, locations, languages; says so when it has not been built). Use to vet affiliates. Example: {\"id\":\"@dollskill\",\"method\":\"products\",\"window\":\"90d\"}.","operationId":"GET_creators_id_shop_audience","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"6963732702017668101","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"audience":null,"dataEnd":"2026-10-28","id":"6963732702017668101","market":"US","notes":["Market US (United States).","The source has not built this creator's audience breakdown yet, so there is no follower age, gender, location or language data to report. Try again later; no other tool returns it."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","status":"not_built","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"audience":{"type":"null"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"status":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"A creator's TikTok Shop business · audience","tags":["creator_commerce"],"x-credits":1,"x-example-params":{"id":"6963732702017668101"},"x-mcp-method":"audience","x-mcp-tool":"creator_commerce"}},"/v1/creators/{id}/shop/linked-products":{"get":{"description":"This route: each product linked in recent posts, with post count, views and likes (not sales).\n\nWhat a creator sells. Live: linked_products (products linked in recent posts, with views; no sales). [Shop Analytics, any market via region]: sales (revenue, units, video vs LIVE), trend (daily), products (with revenue), shops (brands they sell for), videos (selling videos), audience (follower age, gender, locations, languages; says so when it has not been built). Use to vet affiliates. Example: {\"id\":\"@dollskill\",\"method\":\"products\",\"window\":\"90d\"}.","operationId":"GET_creators_id_shop_linked_products","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"6963732702017668101","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=linked_products: post pages to scan, 15 posts each (default 3, max 5).","in":"query","name":"max_pages","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"creator":{"followers":279536,"handle":"sharkbeauty","nickname":"Shark Beauty","secUid":"MS4wLjABAAAAzeqNqWunXSTTn5OPKk-IYTqhuv4aoEn42EiNJcl8riTWAgYH9GU1lGJZEhVpl1Zo","verified":true},"from":"2026-09-30","note":"Products linked in the creator's recent public posts (TikTok Shop links on videos). Not the full showcase tab, and not sales.","postsWithProducts":0,"productCount":0,"products":[],"scannedPosts":45,"to":"2026-10-30"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"from":{"type":"string"},"note":{"type":"string"},"postsWithProducts":{"type":"integer"},"productCount":{"type":"integer"},"products":{"type":"array"},"scannedPosts":{"type":"integer"},"to":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"A creator's TikTok Shop business · linked_products","tags":["creator_commerce"],"x-credits":1,"x-example-params":{"id":"6963732702017668101"},"x-mcp-method":"linked_products","x-mcp-tool":"creator_commerce"}},"/v1/creators/{id}/shop/products":{"get":{"description":"This route: products they sold, with revenue.\n\nWhat a creator sells. Live: linked_products (products linked in recent posts, with views; no sales). [Shop Analytics, any market via region]: sales (revenue, units, video vs LIVE), trend (daily), products (with revenue), shops (brands they sell for), videos (selling videos), audience (follower age, gender, locations, languages; says so when it has not been built). Use to vet affiliates. Example: {\"id\":\"@dollskill\",\"method\":\"products\",\"window\":\"90d\"}.","operationId":"GET_creators_id_shop_products","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"6963732702017668101","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":20,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"id":"6963732702017668101","items":[{"id":"1732479640669033376","product_title":"Shark FacialPro Glow At Home Facial System - FH320","revenue":"$40.66k","sale":"136","seller_id":"7494661364292028320","unit_price":"$299.00"},{"id":"1732571163004670880","product_title":"Shark FacialPro Glow At Home Hydrating Facial System - FH310","revenue":"$28.39k","sale":"114","seller_id":"7494661364292028320","unit_price":"$249.00"},{"id":"1732479644677411744","product_title":"Shark Beauty SilkiPro Hair Straightener and Dryer - HT400","revenue":"$25.07k","sale":"126","seller_id":"7494661364292028320","unit_price":"$199.00"}],"market":"US","next":"eyJwYWdlIjoyLCJzaXplIjoyMH0","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjoyMH0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"id":{"type":"string"},"product_title":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"seller_id":{"type":"string"},"unit_price":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"A creator's TikTok Shop business · products","tags":["creator_commerce"],"x-credits":1,"x-example-params":{"id":"6963732702017668101"},"x-mcp-method":"products","x-mcp-tool":"creator_commerce"}},"/v1/creators/{id}/shop/sales":{"get":{"description":"This route: revenue, units, video vs LIVE, average price.\n\nWhat a creator sells. Live: linked_products (products linked in recent posts, with views; no sales). [Shop Analytics, any market via region]: sales (revenue, units, video vs LIVE), trend (daily), products (with revenue), shops (brands they sell for), videos (selling videos), audience (follower age, gender, locations, languages; says so when it has not been built). Use to vet affiliates. Example: {\"id\":\"@dollskill\",\"method\":\"products\",\"window\":\"90d\"}.","operationId":"GET_creators_id_shop_sales","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"6963732702017668101","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"6963732702017668101","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"day_followers":"396","day_live_revenue":"$7.96k","day_live_views":"17.7k","day_revenue":"$8.03k","day_sale":"36.4","day_shop_revenue":"$69.16","day_video_revenue":"$0.00","day_video_views":"299.44k","followers":"11.9k","live_revenue":"$238.91k","live_views":"531.01k","revenue":"$240.98k","sale":"1.09k","shop_revenue":"$2.07k","unit_price":"$220.68","video_revenue":"$0.00","video_views":"8.98m"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"day_followers":{"type":"string"},"day_live_revenue":{"type":"string"},"day_live_views":{"type":"string"},"day_revenue":{"type":"string"},"day_sale":{"type":"string"},"day_shop_revenue":{"type":"string"},"day_video_revenue":{"type":"string"},"day_video_views":{"type":"string"},"followers":{"type":"string"},"live_revenue":{"type":"string"},"live_views":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"shop_revenue":{"type":"string"},"unit_price":{"type":"string"},"video_revenue":{"type":"string"},"video_views":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"A creator's TikTok Shop business · sales","tags":["creator_commerce"],"x-credits":1,"x-example-params":{"id":"6963732702017668101"},"x-mcp-method":"sales","x-mcp-tool":"creator_commerce"}},"/v1/creators/{id}/shop/shops":{"get":{"description":"This route: shops (brands) they sell for, with revenue.\n\nWhat a creator sells. Live: linked_products (products linked in recent posts, with views; no sales). [Shop Analytics, any market via region]: sales (revenue, units, video vs LIVE), trend (daily), products (with revenue), shops (brands they sell for), videos (selling videos), audience (follower age, gender, locations, languages; says so when it has not been built). Use to vet affiliates. Example: {\"id\":\"@dollskill\",\"method\":\"products\",\"window\":\"90d\"}.","operationId":"GET_creators_id_shop_shops","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"6963732702017668101","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":1,"currency":"USD","dataEnd":"2026-10-28","hasMore":false,"id":"6963732702017668101","items":[{"live_revenue":"$238.91k","product_count":"21","revenue":"$240.98k","sale":"1.09k","seller_id":"7494661364292028320","seller_type":"BRAND","shop_name":"Shark Beauty","video_revenue":"$0.00"}],"market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"live_revenue":{"type":"string"},"product_count":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"seller_id":{"type":"string"},"seller_type":{"type":"string"},"shop_name":{"type":"string"},"video_revenue":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"A creator's TikTok Shop business · shops","tags":["creator_commerce"],"x-credits":1,"x-example-params":{"id":"6963732702017668101"},"x-mcp-method":"shops","x-mcp-tool":"creator_commerce"}},"/v1/creators/{id}/shop/trend":{"get":{"description":"This route: daily revenue (up to ~13 months).\n\nWhat a creator sells. Live: linked_products (products linked in recent posts, with views; no sales). [Shop Analytics, any market via region]: sales (revenue, units, video vs LIVE), trend (daily), products (with revenue), shops (brands they sell for), videos (selling videos), audience (follower age, gender, locations, languages; says so when it has not been built). Use to vet affiliates. Example: {\"id\":\"@dollskill\",\"method\":\"products\",\"window\":\"90d\"}.","operationId":"GET_creators_id_shop_trend","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"6963732702017668101","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"coverage":{"days":27,"daysWithSales":23,"firstDayWithSales":"2026-10-02"},"currency":"USD","dataEnd":"2026-10-28","id":"6963732702017668101","market":"US","notes":["Market US (United States): amounts are in USD.","First day with recorded sales in this window: 2026-10-02."],"series":[{"content_views":238295,"followers":400,"live_revenue":9454.86,"live_views":14021,"partition_day":"2026-10-02","revenue":9572.82,"sale":44,"unit_price":217.56,"video_revenue":0,"video_views":224274},{"content_views":291172,"followers":300,"live_revenue":0,"live_views":0,"partition_day":"2026-10-03","revenue":78,"sale":2,"unit_price":39,"video_revenue":0,"video_views":291172},{"content_views":1529670,"followers":500,"live_revenue":21725.95,"live_views":42909,"partition_day":"2026-10-04","revenue":21842.95,"sale":92,"unit_price":237.42,"video_revenue":0,"video_views":1486761}],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"revenue":240984,"units":1092},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"coverage":{"properties":{"days":{"type":"integer"},"daysWithSales":{"type":"integer"},"firstDayWithSales":{"type":"string"}},"type":"object"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"series":{"items":{"properties":{"content_views":{"type":"integer"},"followers":{"type":"integer"},"live_revenue":{"type":"number"},"live_views":{"type":"integer"},"partition_day":{"type":"string"},"revenue":{"type":"number"},"sale":{"type":"integer"},"unit_price":{"type":"number"},"video_revenue":{"type":"integer"},"video_views":{"type":"integer"}},"type":"object"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"revenue":{"type":"integer"},"units":{"type":"integer"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"A creator's TikTok Shop business · trend","tags":["creator_commerce"],"x-credits":1,"x-example-params":{"id":"6963732702017668101"},"x-mcp-method":"trend","x-mcp-tool":"creator_commerce"}},"/v1/creators/{id}/shop/videos":{"get":{"description":"This route: their selling videos, with revenue.\n\nWhat a creator sells. Live: linked_products (products linked in recent posts, with views; no sales). [Shop Analytics, any market via region]: sales (revenue, units, video vs LIVE), trend (daily), products (with revenue), shops (brands they sell for), videos (selling videos), audience (follower age, gender, locations, languages; says so when it has not been built). Use to vet affiliates. Example: {\"id\":\"@dollskill\",\"method\":\"products\",\"window\":\"90d\"}.","operationId":"GET_creators_id_shop_videos","parameters":[{"description":"Creator: @handle, profile or video link, secUid (MS4wLjAB...) or numeric user id. TokConnect looks up the ids it needs.","example":"6963732702017668101","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":20,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"id":"6963732702017668101","items":[{"ad":0,"ad2Cost":"$0.00","ad2Roas":0,"ad_cpa":0,"ad_revenue_ratio":"0%","ad_view_ratio":"0%","ai_video":0,"collect_day":"2026-10-26","content_type":"video","create_time":"2026/10/26 09:55:54","creator_uid":"6963732702017668101","description":"Don’t miss @Chrisappleton1 LIVE tonight on our TikTok! Who's in? 👀 #sharkbeauty #chrisappleton #tiktoklive #tiktokshop #hairtutorial","duration":"12s","follower_count":278600,"gpm":0,"handle":"sharkbeauty","id":"7700974905965268237","original_duration":12,"product_ids":[],"revenue":"$0.00","sale":"0","views":"6.5k"},{"ad":0,"ad2Cost":"$0.00","ad2Roas":0,"ad_cpa":0,"ad_revenue_ratio":"0%","ad_view_ratio":"0%","ai_video":0,"collect_day":"2026-10-01","content_type":"video","create_time":"2026/10/01 15:53:28","creator_uid":"6963732702017668101","description":"National Hair Day calls for two things: bouncy blowouts and shopping early prime day deals sale on @amazon . 🍒✨ Shop FlexStlye now. #sharkbeauty #sharkflexstyle #amazon #primeday #nationalhairday","duration":"18s","follower_count":278100,"gpm":0,"handle":"sharkbeauty","id":"7691789893600562446","original_duration":18,"product_ids":[],"revenue":"$0.00","sale":"0","views":"12.08k"},{"ad":0,"ad2Cost":"$0.00","ad2Roas":0,"ad_cpa":0,"ad_revenue_ratio":"0%","ad_view_ratio":"0%","ai_video":0,"collect_day":"2026-10-05","content_type":"video","create_time":"2026/10/05 10:38:44","creator_uid":"6963732702017668101","description":"Gentle on the skin, big on the glow. ✨Shop now. #sharkbeauty #sharkfacialproglow #gentle #dermdetox #sensitiveskin","duration":"16s","follower_count":278600,"gpm":0,"handle":"sharkbeauty","id":"7693193061777591565","original_duration":16,"product_ids":[],"revenue":"$0.00","sale":"0","views":"4.36k"}],"market":"US","next":"eyJwYWdlIjoyLCJzaXplIjoyMH0","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjoyMH0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"ad":{"type":"integer"},"ad2Cost":{"type":"string"},"ad2Roas":{"type":"integer"},"ad_cpa":{"type":"integer"},"ad_revenue_ratio":{"type":"string"},"ad_view_ratio":{"type":"string"},"ai_video":{"type":"integer"},"collect_day":{"type":"string"},"content_type":{"type":"string"},"create_time":{"type":"string"},"creator_uid":{"type":"string"},"description":{"type":"string"},"duration":{"type":"string"},"follower_count":{"type":"integer"},"gpm":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"original_duration":{"type":"integer"},"product_ids":{"type":"array"},"revenue":{"type":"string"},"sale":{"type":"string"},"views":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"A creator's TikTok Shop business · videos","tags":["creator_commerce"],"x-credits":1,"x-example-params":{"id":"6963732702017668101"},"x-mcp-method":"videos","x-mcp-tool":"creator_commerce"}},"/v1/feeds/discover":{"get":{"description":"This route: Discover picks: creators, hashtags, sounds.\n\nSamples TikTok's own feeds: For You (as a neutral US viewer), Explore categories, and Discover creators/hashtags/sounds. Samples, not rankings. Example: {\"method\":\"explore\",\"category_id\":3}. Category ids come from reference method=explore_categories.","operationId":"GET_feeds_discover","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. for_you, discover max 30; explore, discover_hashtags max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=discover: Discover scene (15 is the full catalogue).","in":"query","name":"scene","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"creators":[{"followers":74600000,"handle":"billieeilish","id":"6879693940111901701","nickname":"BILLIE EILISH","secUid":"MS4wLjABAAAAQC9D0J9C7zCdiToBJvaCHEZZl1FXTKeeSVoyGQld--0hcxb3lqDTxaSRjByAVlAs","verified":true},{"followers":16900000,"handle":"rihanna","id":"6621955904844021765","nickname":"Rihanna","secUid":"MS4wLjABAAAAd04PpJrQJrRv5QpeLCz-tj41zTwuemXz6WBpyycnVNGeYqJjlOzJ5fpV9QWK5h4B","verified":true},{"followers":18100000,"handle":"edsheeran","id":"173245838817808384","nickname":"Ed Sheeran","secUid":"MS4wLjABAAAAW-m9le-3IwWQcihDj2Io53yCuEgz0wb1Np_JY3chG8vAsK_fzWmK2NWaz1nzttoD","verified":true}],"hashtags":[{"id":"7701142521555976205","name":"tiktokshopcollectiblescarnivals","views":99200},{"id":"7029514091618123822","name":"blackfridayearlyaccess","views":29800000},{"id":"1674571239209989","name":"discoveryourgift","views":741000000}],"sounds":[{"author":"3.1M videos","id":"6740248251825391617","title":"Forever (From \"Euphoria: Season 1\" Soundtrack)","videos":3100000},{"author":"87.1K videos","id":"5000000001008467945","title":"Quinceañera","videos":87100},{"author":"221.7K videos","id":"222453230176251905","title":"Hasta la Raíz","videos":221700}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"creators":{"items":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"type":"array"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"sounds":{"items":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok feeds · discover","tags":["video_feed"],"x-credits":1,"x-example-params":{"limit":3},"x-mcp-method":"discover","x-mcp-tool":"video_feed"}},"/v1/feeds/discover/hashtags":{"get":{"description":"This route: Discover hashtags with sample videos.\n\nSamples TikTok's own feeds: For You (as a neutral US viewer), Explore categories, and Discover creators/hashtags/sounds. Samples, not rankings. Example: {\"method\":\"explore\",\"category_id\":3}. Category ids come from reference method=explore_categories.","operationId":"GET_feeds_discover_hashtags","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. for_you, discover max 30; explore, discover_hashtags max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"hashtags":[{"id":"1612000725392390","name":"cindytest","sampleVideos":[{"caption":"#cindytest #","comments":4,"creator":{"followers":2908,"handle":"edgar.alex.alcedo0","id":"7319128708127409158","nickname":"EL TERROR 🇵🇪🇵🇪🇵🇪🇵🇪🇵🇪","secUid":"MS4wLjABAAAA7zr7Ai1E_tdLqQ2Gxylv8rCmfRghekX5O_UpU3d9JABWoesADQITcAA3WYbS6ZLv"},"durationSec":52,"hashtags":[{"id":"1612000725392390","name":"cindytest"}],"id":"7665797426422287637","language":"un","likes":24,"posted":"2026-07-23T18:49:20Z","saves":1,"shares":7,"sound":{"author":"Ragal Ironbull","id":"7624518713740118806","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@edgar.alex.alcedo0/video/7665797426422287637","views":941},{"caption":"Well, not #gorgeous  But that @beachwaver is the freaking bomb #emptynester #hairtok #beachwaver #fyp","comments":0,"creator":{"followers":164,"handle":"justcindy59andholding","id":"7613894746034308109","nickname":"JustCindy","secUid":"MS4wLjABAAAAnI9ulHJfHJ8Yj-FpmaO8wh4QJELHonBK2ck2t-CXtp17Ly_ehzv-MCGoouhQNbvj"},"durationSec":7,"hashtags":[{"id":"10959","name":"gorgeous"},{"id":"1620699584019462","name":"emptynester"},{"id":"1631187004035077","name":"hairtok"}],"id":"7688569373887450398","language":"en","likes":2,"posted":"2026-09-23T03:36:09Z","saves":0,"shares":1,"sound":{"author":"Taylor Swift","id":"6752003160799201281","title":"Gorgeous"},"url":"https://www.tiktok.com/@justcindy59andholding/video/7688569373887450398","views":309},{"caption":"I know.  You want this recipe! ##emptynester #rice #homemade #yummy","comments":0,"creator":{"followers":164,"handle":"justcindy59andholding","id":"7613894746034308109","nickname":"JustCindy","secUid":"MS4wLjABAAAAnI9ulHJfHJ8Yj-FpmaO8wh4QJELHonBK2ck2t-CXtp17Ly_ehzv-MCGoouhQNbvj"},"durationSec":23,"hashtags":[{"id":"1620699584019462","name":"emptynester"},{"id":"28775","name":"rice"},{"id":"120886","name":"homemade"}],"id":"7688565274487885087","language":"en","likes":3,"posted":"2026-09-23T03:20:09Z","saves":0,"shares":0,"sound":{"author":"Spandau Ballet","id":"5000000001102939173","title":"True"},"url":"https://www.tiktok.com/@justcindy59andholding/video/7688565274487885087","views":18}],"url":"https://www.tiktok.com/tag/cindytest","videos":83,"views":63993},{"description":"Try longer videos (videos longer than 1 minute)! Create longer videos to express yourself and share more of your story on TikTok","id":"1604297750222853","name":"longervideos","sampleVideos":[{"caption":"Let’s Make a delicious fried Rice 😋👌🏽 Here is the recipe below 👇🏾  Ingredients  * 2 large chicken breast, cut into small cubes * 1/2 onion, diced  * 1/4 red, yellow and green bell peppers, diced * 3 Tbsp avocado oil  * 1 tsp crushed garlic  * 2 cups cooked leftover rice, any kind  *…","comments":420,"creator":{"followers":329100,"handle":"sifo_the_cooking_husband","id":"6986275915727127557","nickname":"The Cooking Husband- Foodie","secUid":"MS4wLjABAAAAirNoRF6mQ0kTxnwwVEaouXI9E-Iqm327koq9eAXHOUV2nazaZoIiZL8ai9ZfXMOd"},"durationSec":63,"hashtags":[{"id":"122788","name":"friedrice"},{"id":"88552244","name":"ricerecipe"},{"id":"5718","name":"food"}],"id":"7359831944349093125","language":"en","likes":28300,"posted":"2024-04-20T06:26:53Z","saves":7996,"shares":5047,"sound":{"author":"Deep Narratives \u0026 ZVRI \u0026 Culoe De Song","id":"7259523870389045250","title":"Insimbi"},"url":"https://www.tiktok.com/@sifo_the_cooking_husband/video/7359831944349093125","views":1200000},{"caption":"Zizi Kodwa #ZiziKodwa #Cellular #kasifootball #SAMA28 #sasa17thawards #mzansifootball #mzansicomedy #motivation #sportsontiktok #levelupafrica","comments":460,"creator":{"followers":1300000,"handle":"cellular__jnr","id":"7304528873608692742","nickname":"Cellular Maake","secUid":"MS4wLjABAAAAJdJhQ01l33vggUbGvgRa717MAvaowI9YQaf9eR7PhsnGdrCj9Eo9OHdnkiIvzO4b"},"durationSec":87,"hashtags":[{"id":"1697989924753409","name":"zizikodwa"},{"id":"436229","name":"cellular"},{"id":"1665797528099846","name":"kasifootball"}],"id":"7365556329051589889","language":"xh","likes":33500,"place":{"id":"22535865213134166","name":"Sun City"},"posted":"2024-05-05T16:40:30Z","saves":1096,"shares":2997,"sound":{"author":"Cellular Maake","id":"7365556382919461648","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@cellular__jnr/video/7365556329051589889","views":1200000},{"caption":"Morgan Mammila On Footballer of the Season. #PSL #DStvPrem #OrlandoPirates #SAMA28 #SportsOnTikTok #Fyp #fypシ #Sundowns #LevelUpAfrica","comments":497,"creator":{"followers":478200,"handle":"lorenz_ko","id":"7004391325513401349","nickname":"Lorenz Köhler","secUid":"MS4wLjABAAAA0aiitSXzb30nLf9xk1b-GFd23khQoDTSbQxEDlyFlPMFlZ_4ac4TBj5NHRMTGogt","verified":true},"durationSec":98,"hashtags":[{"id":"660376","name":"psl"},{"id":"1678791567736833","name":"dstvprem"},{"id":"1635060031427590","name":"orlandopirates"}],"id":"7365843241398209800","language":"en","likes":17300,"place":{"id":"22535796494106239","name":"Germiston Stadium"},"posted":"2024-05-06T11:13:48Z","saves":558,"shares":2162,"sound":{"author":"Lorenz Köhler","id":"7365843278912047889","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@lorenz_ko/video/7365843241398209800","views":632400}],"url":"https://www.tiktok.com/tag/longervideos","videos":7654978,"views":435009025218},{"id":"235463","name":"1min","sampleVideos":[{"caption":"You have 1 minute… #unusannus #unusannuscountdown #unusannusclock  (Not in association with anyone from Unus Annus)","comments":1618,"creator":{"followers":4659,"handle":"unusannuscountdown","id":"7435094030264878122","nickname":"Unus Annus Countdown Clock","secUid":"MS4wLjABAAAAx52zFY0uabbWCNY2AxQIq3Q2ebgHPwdGkdUaY-OB76ZABbphuTRLeMtwc1IFqdmA"},"durationSec":63,"hashtags":[{"id":"1650287797879814","name":"unusannus"},{"id":"1681619012001798","name":"unusannuscountdown"},{"id":"1683309923177478","name":"unusannusclock"}],"id":"7437551913899658542","language":"en","likes":51000,"posted":"2024-11-15T17:00:08Z","saves":10300,"shares":10500,"sound":{"author":"Unus Annus Countdown Clock","id":"7437551930303433518","original":true,"title":"Unus Annus Countdown Clock 1 Minute"},"url":"https://www.tiktok.com/@unusannuscountdown/video/7437551913899658542","views":1500000},{"caption":"1 minute countdown timer with time up alert. No Audio. Just a 5 second countdown beep and end buzzer - adjust the volume accordingly to your needs. A stylish, accurate countdown timer to use for timing your food, games, test, quiz, sports, cooking, work breaks, meditation, chores, play, exercise, re…","comments":85,"creator":{"followers":2472,"handle":"clocktocktimer","id":"7615215731055936534","nickname":"Clock Tock Timer","secUid":"MS4wLjABAAAAnnFSHz3EEr2c3t70Fk44XceJkQJEAjDDu5lvdzoX66gdjtfJJB1yRzdXC7meYPpd"},"durationSec":68,"hashtags":[{"id":"1650390904487942","name":"1minutetimer"},{"id":"72910","name":"timer"},{"id":"1593836352973830","name":"countdowntimer"}],"id":"7652449909064371478","language":"en","likes":1102,"posted":"2026-06-17T19:34:03Z","saves":662,"shares":413,"sound":{"author":"Clock Tock Timer","id":"7652449932364466966","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@clocktocktimer/video/7652449909064371478","views":134200},{"caption":"🎥 Full aesthetic timers on YouTube - SoftlyTimed ⏱️ 1 minute / 60 seconds focus boost.  What do you use it for? 💗 #timer #studytimer #aesthetictimer #oneminutefocus #studywithme","comments":715,"creator":{"followers":2387,"handle":"softlytimed_","id":"7554715016700888066","nickname":"SoftlyTimed","secUid":"MS4wLjABAAAAK8mzddpRyzCKSn2xNGc0RRE7CLlXgkwjDCxeGaFn5SHMHYFQ6Jx2qTXkuUm_XkVT"},"durationSec":66,"hashtags":[{"id":"72910","name":"timer"},{"id":"45299846","name":"studytimer"},{"id":"7232884973903511558","name":"aesthetictimer"}],"id":"7596375038756982038","language":"en","likes":7299,"posted":"2026-01-17T16:54:54Z","saves":5315,"shares":788,"sound":{"author":"Muspace Lofi","id":"7176685873453500417","title":"More of My Time (Lofi)"},"url":"https://www.tiktok.com/@softlytimed_/video/7596375038756982038","views":629500}],"url":"https://www.tiktok.com/tag/1min","videos":470547,"views":13287342684}],"next":"eyJvZmZzZXQiOjJ9"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"sampleVideos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"integer"},"hashtags":{"items":{"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"url":{"type":"string"},"videos":{"type":"integer"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"next":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok feeds · discover_hashtags","tags":["video_feed"],"x-credits":1,"x-example-params":{"limit":3},"x-mcp-method":"discover_hashtags","x-mcp-tool":"video_feed"}},"/v1/feeds/explore":{"get":{"description":"This route: videos from one Explore category.\n\nSamples TikTok's own feeds: For You (as a neutral US viewer), Explore categories, and Discover creators/hashtags/sounds. Samples, not rankings. Example: {\"method\":\"explore\",\"category_id\":3}. Category ids come from reference method=explore_categories.","operationId":"GET_feeds_explore","parameters":[{"description":"method=explore: id from reference method=explore_categories.","example":120,"in":"query","name":"category_id","required":false,"schema":{"type":"integer"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. for_you, discover max 30; explore, discover_hashtags max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"explore_item_source":"ug_same_country","hasMore":true,"videos":[{"caption":"(✨️life changing title✨️)#kitten #why #confetti #weirdshithappenstome #whyandhowthefuckisthisconfettiflying","comments":12600,"creator":{"followers":4315,"handle":"ech0d0gg","id":"7609364764213527573","nickname":"🌀//-Ech0._.D0gg-//🏳️‍⚧️","secUid":"MS4wLjABAAAAWvoibP5ag1boCZQKyWxN2IAWjXUi5JCEZsa97O_f8nTG-BXFORDu7j8QR60jpbxX"},"durationSec":7,"hashtags":[{"id":"6845","name":"kitten"},{"id":"7754","name":"why"},{"id":"87899","name":"confetti"}],"id":"7699977998820281620","language":"en","likes":1100000,"place":{"id":"42203860546907036","name":"Behind You"},"posted":"2026-10-23T21:27:25Z","saves":82300,"shares":57100,"sound":{"author":"Jacket2026","id":"7673220508500052756","original":true,"title":"оригинальный звук"},"url":"https://www.tiktok.com/@ech0d0gg/video/7699977998820281620","views":9100000},{"caption":"тгк: lybima411    шота у нас не получился этот тренд","comments":2185,"creator":{"followers":38200,"handle":"onlyfrantsss","id":"6704968772954801158","nickname":"onlyfrants","secUid":"MS4wLjABAAAAPi5HECJh2vsFAzNTPJQxJvG5LVNUpWi-Ba4RQtLmhpZNfIfrAtLSfxHYEbp_LQqR"},"durationSec":7,"id":"7699537178774359317","language":"ru","likes":689900,"posted":"2026-10-22T16:56:43Z","saves":29700,"shares":11100,"sound":{"author":"jamal","id":"7687759421904096013","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@onlyfrantsss/video/7699537178774359317","views":9200000},{"caption":"#fyp @Sextar","comments":34500,"creator":{"followers":327600,"handle":"b4rbbbiee","id":"6879235892633109505","nickname":"Barbibu","secUid":"MS4wLjABAAAAJ-o2JbN9PO4eb2oc_bGkfQFnM1yrwp22rshsTEKhm9AP0rw-yn_rS2EoF1mfH7dD"},"durationSec":7,"hashtags":[{"id":"229207","name":"fyp"}],"id":"7699677067105144085","language":"un","likes":7500000,"posted":"2026-10-23T01:59:36Z","saves":712800,"shares":1100000,"sound":{"author":"‽","id":"7521507656105151248","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@b4rbbbiee/video/7699677067105144085","views":41200000}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"explore_item_source":{"type":"string"},"hasMore":{"type":"boolean"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"integer"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"place":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok feeds · explore","tags":["video_feed"],"x-credits":1,"x-example-params":{"category_id":120,"limit":3},"x-mcp-method":"explore","x-mcp-tool":"video_feed"}},"/v1/feeds/for-you":{"get":{"description":"This route: a page of the For You feed.\n\nSamples TikTok's own feeds: For You (as a neutral US viewer), Explore categories, and Discover creators/hashtags/sounds. Samples, not rankings. Example: {\"method\":\"explore\",\"category_id\":3}. Category ids come from reference method=explore_categories.","operationId":"GET_feeds_for_you","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. for_you, discover max 30; explore, discover_hashtags max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"home_model":1,"log_info":{"impr_id":"20261030233320252DED3F3D4CA96C0082","pull_type":"1"},"max_cursor":7,"min_cursor":0,"preload_ads":[],"preload_awemes":null,"refresh_clear":1,"videos":[{"caption":"7","comments":1,"creator":{"handle":"joyreelsshort.ca","id":"7639195000521786388","nickname":"JoyReelsshort CA","secUid":"MS4wLjABAAAAZl2od8WK6lFoTSzxEquguEIyb_eWjZe7JjzMS7s2juhEVkMwu7yYvcbcMXycxwZ0","verified":true},"durationSec":84.44,"id":"7700899193195449621","language":"un","likes":330,"posted":"2026-10-26T13:02:30Z","saves":172,"shares":13,"sound":{"author":"JoyReelsshort CA","id":"7700899226716244757","title":"suono originale - joyreelsshort.ca"},"url":"https://www.tiktok.com/@joyreelsshort.ca/video/7700899193195449621","views":58888},{"caption":"magari tornare a parigi","comments":1013,"creator":{"handle":"caterinamellusii","id":"6696822421436253190","nickname":"cate","secUid":"MS4wLjABAAAAd0Bb-tLv2sD8KUA0H7yUo0Gnf2nYFOW63dPyWbng7gNGmZMj48yKBzBAgv2WR5Fp","verified":true},"durationSec":10.634,"id":"7683308873704394016","language":"it","likes":191772,"posted":"2026-09-08T23:22:41Z","saves":14604,"shares":6840,"sound":{"author":"SoundWaves","id":"7600964198817893142","title":"suono originale - soundwaves.it"},"url":"https://www.tiktok.com/@caterinamellusii/video/7683308873704394016","views":1066264},{"caption":"Il carico è arrivato 🚛🪵 Faggio stagionato, pronto da bruciare. Fai scorta prima del freddo 🔥 Consegna a Lecco e in Brianza 📲 WhatsApp 320 746 7020 #legnadaardere #lecco #camino #stufaalegna #inverno","comments":10,"creator":{"handle":"radasnc","id":"7047523516694217734","nickname":"Rada","secUid":"MS4wLjABAAAAr51i3kp6Kzu7217gB3jsySH2jPNZZZXBxAmpsv4WEBGavzxuTO-QRfQczc2VBuGv","verified":true},"durationSec":19.318,"hashtags":[{"id":"1663053011916806","name":"legnadaardere"},{"id":"27958339","name":"lecco"},{"id":"24299","name":"camino"}],"id":"7690872488833584417","language":"it","likes":135,"posted":"2026-09-29T08:33:19Z","saves":37,"shares":110,"sound":{"author":"🎧","id":"7478091635340626710","title":"suono originale - lyrics.7670"},"url":"https://www.tiktok.com/@radasnc/video/7690872488833584417","views":4172}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"home_model":{"type":"integer"},"log_info":{"properties":{"impr_id":{"type":"string"},"pull_type":{"type":"string"}},"type":"object"},"max_cursor":{"type":"integer"},"min_cursor":{"type":"integer"},"preload_ads":{"type":"array"},"preload_awemes":{"type":"null"},"refresh_clear":{"type":"integer"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"durationSec":{"type":"number"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"TikTok feeds · for_you","tags":["video_feed"],"x-credits":1,"x-example-params":{"limit":3},"x-mcp-method":"for_you","x-mcp-tool":"video_feed"}},"/v1/hashtags/{id}":{"get":{"description":"This route: views, video count, description.\n\nOne hashtag (id from hashtag_search or hashtags[].id on a post): detail, its videos (hot or newest), or related hashtags. Example: {\"id\":\"229207\",\"method\":\"videos\",\"sort\":\"newest\"}.","operationId":"GET_hashtags_id","parameters":[{"description":"Hashtag id (hashtags[].id).","example":"504245","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"description":"From routines to glow ups, discover how the skincare community on TikTok keeps their skin cared for.","id":"504245","name":"SkinCare","url":"https://www.tiktok.com/tag/SkinCare","videos":62776858,"views":1002857221064},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"},"views":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One hashtag · detail","tags":["hashtag"],"x-credits":1,"x-example-params":{"id":"504245"},"x-mcp-method":"detail","x-mcp-tool":"hashtag"}},"/v1/hashtags/{id}/related":{"get":{"description":"This route: hashtags TikTok relates to it.\n\nOne hashtag (id from hashtag_search or hashtags[].id on a post): detail, its videos (hot or newest), or related hashtags. Example: {\"id\":\"229207\",\"method\":\"videos\",\"sort\":\"newest\"}.","operationId":"GET_hashtags_id_related","parameters":[{"description":"Hashtag id (hashtags[].id).","example":"504245","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. videos max 50, related max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":false,"hashtags":[{"id":"55253017","name":"skincareproducts","url":"https://www.tiktok.com/tag/skincareproducts","videos":1728190,"views":22631704765},{"id":"7024790","name":"skin_care","url":"https://www.tiktok.com/tag/skin_care","videos":33779,"views":481670171}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One hashtag · related","tags":["hashtag"],"x-credits":1,"x-example-params":{"id":"504245","limit":3},"x-mcp-method":"related","x-mcp-tool":"hashtag"}},"/v1/hashtags/{id}/videos":{"get":{"description":"This route: videos using the hashtag.\n\nOne hashtag (id from hashtag_search or hashtags[].id on a post): detail, its videos (hot or newest), or related hashtags. Example: {\"id\":\"229207\",\"method\":\"videos\",\"sort\":\"newest\"}.","operationId":"GET_hashtags_id_videos","parameters":[{"description":"Hashtag id (hashtags[].id).","example":"504245","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. videos max 50, related max 20. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=videos: hot (TikTok's ranking, default) or newest.","in":"query","name":"sort","required":false,"schema":{"enum":["hot","newest"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOjN9","videos":[{"caption":"4 Step Beginner Skincare routine 🌸✨ #skincare #beginnerskincareroutine #skincaretipsforeveryone #blackgirlskincare","comments":1155,"creator":{"handle":"mayriahm.a","id":"6532038966940549121","nickname":"Mariam 🤍","secUid":"MS4wLjABAAAAD3qd3TUwzYmyLsecBZa8h_NysIiFd8bZp-8IwV_eFBNBhfh9oihgSEjLrw7FrtOX","verified":true},"durationSec":44.534,"hashtags":[{"id":"504245","name":"SkinCare"},{"id":"1690942436043778","name":"beginnerskincareroutine"},{"id":"1665214116743170","name":"skincaretipsforeveryone"}],"id":"7107330561206734086","language":"en","likes":140759,"posted":"2022-06-09T19:52:32Z","saves":58342,"shares":3536,"sound":{"author":"Burna Boy","id":"7096289813334083585","title":"Last Last"},"url":"https://www.tiktok.com/@mayriahm.a/video/7107330561206734086","views":4340166},{"caption":"The fact it doesn’t sting her eyes 😭 i need #kylie #kyliejenner #skincare","comments":98,"creator":{"handle":"koreababe1","id":"6981218295518299137","nickname":"Korea Babe","secUid":"MS4wLjABAAAAepazH0jrDXmFaU8uFeQbD8MkWRhuXxy1ijlbb-arPTtS1K4qcHhpGIyjjK8Ac7i6","verified":true},"durationSec":7.151,"hashtags":[{"id":"23295","name":"kylie"},{"id":"18830","name":"kyliejenner"},{"id":"504245","name":"skincare"}],"id":"7692712348200504583","language":"en","likes":57559,"posted":"2026-10-04T07:32:52Z","saves":8792,"shares":728,"sound":{"author":"ℳ𝒶𝓃𝓊 🪽","id":"7596069087663459084","original":true,"title":"MONTAGEM ALQUIMIA"},"url":"https://www.tiktok.com/@koreababe1/video/7692712348200504583","views":1296455},{"caption":"Skincare routine for glass skin #skincare #ai #aivids #animation #healthy","comments":62,"creator":{"handle":"healthhandwellness","id":"7295346887061341217","nickname":"healthandwellness","secUid":"MS4wLjABAAAAAWuLv1V6Ti8czBxz1lhPxnVhGXdu-vDtPmULvWZBUszqJZYc1afnVNvc61lcr9SX","verified":true},"durationSec":37.801,"hashtags":[{"id":"504245","name":"SkinCare"},{"id":"183145","name":"ai"},{"id":"1681909226079234","name":"aivids"}],"id":"7599023958746238230","language":"en","likes":7798,"posted":"2026-01-24T20:14:03Z","saves":4728,"shares":975,"sound":{"author":"Limbo","id":"6754175395743926274","title":"Airplane Mode"},"url":"https://www.tiktok.com/@healthhandwellness/video/7599023958746238230","views":262094}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"durationSec":{"type":"number"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One hashtag · videos","tags":["hashtag"],"x-credits":1,"x-example-params":{"id":"504245","limit":"3"},"x-mcp-method":"videos","x-mcp-tool":"hashtag"}},"/v1/keywords/accounts":{"get":{"description":"This route: account (@handle) suggestions.\n\nAutocomplete and keyword ideas from TikTok and TikTok Shop. method=signals adds TikTok's predicted click-through and a shopping-intent flag per phrase. These rank phrases; they are not search volume (use demand_find_topics for volume). Example: {\"keyword\":\"matcha\",\"method\":\"signals\"}.","operationId":"GET_keywords_accounts","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Seed phrase. Not needed for method=trending.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Results per page. tiktok/accounts max 50, signals max 20, trending max 30, ad_library max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"suggestions":["lip oil","Lip Oil","Lip oil"]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"suggestions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Keyword suggestions · accounts","tags":["demand_keywords"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"accounts","x-mcp-tool":"demand_keywords"}},"/v1/keywords/ad-library":{"get":{"description":"This route: EU/UK Ad Library advertiser and keyword autocomplete.\n\nAutocomplete and keyword ideas from TikTok and TikTok Shop. method=signals adds TikTok's predicted click-through and a shopping-intent flag per phrase. These rank phrases; they are not search volume (use demand_find_topics for volume). Example: {\"keyword\":\"matcha\",\"method\":\"signals\"}.","operationId":"GET_keywords_ad_library","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Seed phrase. Not needed for method=trending.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Results per page. tiktok/accounts max 50, signals max 20, trending max 30, ad_library max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=ad_library: 2-letter EU/UK country from reference method=ad_regions. Default DE.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=ad_library: TikTok's suggestion type, default 1 (advertisers and keywords).","in":"query","name":"suggest_type","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"advertisers":[],"code":0,"keywords":[]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"advertisers":{"type":"array"},"code":{"type":"integer"},"keywords":{"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Keyword suggestions · ad_library","tags":["demand_keywords"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"ad_library","x-mcp-tool":"demand_keywords"}},"/v1/keywords/shop":{"get":{"description":"This route: TikTok Shop search autocomplete.\n\nAutocomplete and keyword ideas from TikTok and TikTok Shop. method=signals adds TikTok's predicted click-through and a shopping-intent flag per phrase. These rank phrases; they are not search volume (use demand_find_topics for volume). Example: {\"keyword\":\"matcha\",\"method\":\"signals\"}.","operationId":"GET_keywords_shop","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Seed phrase. Not needed for method=trending.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"page":"suggest","suggestions":["lip oil hydration","lip oil stain","lip oil gloss"]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"page":{"type":"string"},"suggestions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Keyword suggestions · shop","tags":["demand_keywords"],"x-credits":1,"x-example-params":{"keyword":"lip oil"},"x-mcp-method":"shop","x-mcp-tool":"demand_keywords"}},"/v1/keywords/signals":{"get":{"description":"This route: autocomplete with click-through and shopping-intent signals.\n\nAutocomplete and keyword ideas from TikTok and TikTok Shop. method=signals adds TikTok's predicted click-through and a shopping-intent flag per phrase. These rank phrases; they are not search volume (use demand_find_topics for volume). Example: {\"keyword\":\"matcha\",\"method\":\"signals\"}.","operationId":"GET_keywords_signals","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Seed phrase. Not needed for method=trending.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Results per page. tiktok/accounts max 50, signals max 20, trending max 30, ad_library max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"keyword":"lip oil","suggestions":[{"ecomIntent":2,"predictedCtr":0.026337544,"text":"lip oil"},{"ecomIntent":1,"predictedCtr":0.0067250463,"text":"lip oil vs lip gloss"},{"ecomIntent":2,"predictedCtr":0.0041258996,"text":"Lip oil essence"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"keyword":{"type":"string"},"suggestions":{"items":{"properties":{"ecomIntent":{"type":"integer"},"predictedCtr":{"type":"number"},"text":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Keyword suggestions · signals","tags":["demand_keywords"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"signals","x-mcp-tool":"demand_keywords"}},"/v1/keywords/suggest":{"get":{"description":"This route: TikTok search autocomplete.\n\nAutocomplete and keyword ideas from TikTok and TikTok Shop. method=signals adds TikTok's predicted click-through and a shopping-intent flag per phrase. These rank phrases; they are not search volume (use demand_find_topics for volume). Example: {\"keyword\":\"matcha\",\"method\":\"signals\"}.","operationId":"GET_keywords_suggest","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Seed phrase. Not needed for method=trending.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Results per page. tiktok/accounts max 50, signals max 20, trending max 30, ad_library max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"suggestions":["lip oil","lip oil vs lip gloss","Lip oil essence"]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"suggestions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Keyword suggestions · tiktok","tags":["demand_keywords"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"tiktok","x-mcp-tool":"demand_keywords"}},"/v1/keywords/trending":{"get":{"description":"This route: trending phrases TikTok's website shows.\n\nAutocomplete and keyword ideas from TikTok and TikTok Shop. method=signals adds TikTok's predicted click-through and a shopping-intent flag per phrase. These rank phrases; they are not search volume (use demand_find_topics for volume). Example: {\"keyword\":\"matcha\",\"method\":\"signals\"}.","operationId":"GET_keywords_trending","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. tiktok/accounts max 50, signals max 20, trending max 30, ad_library max 20. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"searches":["Hyena makeup for Halloween trend","Band Aid and 2 Pimple Patches remarks trend","Fancy Footwork trend"]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"searches":{"items":{"type":"string"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Keyword suggestions · trending","tags":["demand_keywords"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"trending","x-mcp-tool":"demand_keywords"}},"/v1/lives/top-selling":{"get":{"description":"This route: top LIVEs by sales.\n\n[Shop Analytics] The top 10 LIVE broadcasts by estimated revenue over a date range, with host, start and end time, duration, units, GPM and average price. This ranking takes no filters. Pass a row's id to live method=products, sales or history. Example: {\"window\":\"7d\"}.","operationId":"GET_lives_top_selling","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":10,"currency":"USD","dataEnd":"2026-10-28","hasMore":false,"items":[{"create_time":"2026/10/21 06:15:53","duration":"123h 56m","finish_time":"2026/10/26 10:12:51","gpm":"$55.39","handle":"based","id":"7699061230417349407","main_category":["601450-848904"],"record_type":"SHORT","revenue":"$169.85k","sale":5694,"title":"DEALS FOR YOU - Live Now!","uid":"7153432386608251946","unit_price":"$29.83","views":"3.07m"},{"create_time":"2026/10/25 15:40:57","duration":"11h 39m","finish_time":"2026/10/26 03:20:04","gpm":"$763.53","handle":"glamourmodernfashion1","id":"7700692389735811853","main_category":["601152-842376"],"record_type":"SHORT","revenue":"$89.92k","sale":1251,"title":"","uid":"7043091206013060102","unit_price":"$71.88","views":"117.77k"},{"create_time":"2026/10/27 18:27:37","duration":"5h 57m","finish_time":"2026/10/28 00:25:29","gpm":"$816.49","handle":"noelyfajas","id":"7701477528661920543","main_category":["601152-842888"],"record_type":"SHORT","revenue":"$82.50k","sale":969,"title":"Fall Deals For You LIVE","uid":"6801519791112897542","unit_price":"$85.13","views":"101.04k"}],"market":"US","notes":["Market US (United States): amounts are in USD.","Without a keyword the data source returns its fixed overall top 10 for the most recent days (window below), whatever window you ask for. Add a keyword to rank more rows over your own window."],"see_also":"Pass a row's id to live: method=products, sales, history.","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":8,"end":"2026-10-28","start":"2026-10-21"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"items":{"items":{"properties":{"create_time":{"type":"string"},"duration":{"type":"string"},"finish_time":{"type":"string"},"gpm":{"type":"string"},"handle":{"type":"string"},"id":{"type":"string"},"main_category":{"items":{"type":"string"},"type":"array"},"record_type":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"integer"},"title":{"type":"string"},"uid":{"type":"string"},"unit_price":{"type":"string"},"views":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"type":"string"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Top-selling TikTok Shop LIVEs","tags":["live_top_selling"],"x-credits":1,"x-mcp-method":"","x-mcp-tool":"live_top_selling"}},"/v1/lives/{id}":{"get":{"description":"This route: live status, viewers, likes, Shop selling.\n\nOne LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). [Shop Analytics, any market via region]: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {\"id\":\"7695846289116416799\",\"method\":\"products\"}.","operationId":"GET_lives_id","parameters":[{"description":"LIVE room id.","example":"7702601891041020685","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"creator":{"handle":"nnnnylsoj","id":"6959222640256353285","nickname":"💋Jos💋","secUid":"MS4wLjABAAAAutZIjs8mDE0LgnvabgKchstKgD6108hgzz94dnD6Smy5YBp6Y-fbOz7rZ0eThp4Q"},"likes":9898,"live":true,"roomId":"7702601891041020685","started":"2026-10-30T23:10:19Z","title":"Doing mi makeup","totalViewers":8213,"url":"https://www.tiktok.com/@nnnnylsoj/live","viewers":1428},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"likes":{"type":"integer"},"live":{"type":"boolean"},"roomId":{"type":"string"},"started":{"type":"string"},"title":{"type":"string"},"totalViewers":{"type":"integer"},"url":{"type":"string"},"viewers":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok LIVE · now","tags":["live"],"x-credits":1,"x-example-params":{"id":"7702601891041020685"},"x-mcp-method":"now","x-mcp-tool":"live"}},"/v1/lives/{id}/history":{"get":{"description":"This route: performance over the broadcast.\n\nOne LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). [Shop Analytics, any market via region]: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {\"id\":\"7695846289116416799\",\"method\":\"products\"}.","operationId":"GET_lives_id_history","parameters":[{"description":"LIVE room id.","example":"7699061230417349407","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","history":[{"duration":"0","finish_time":"1792579235","revenue":"0.0","total_user":"6621","total_user_incre":"0","viewer_num":"350"},{"duration":"0","finish_time":"1792579538","revenue":"86.8559709094514","total_user":"8144","total_user_incre":"1523","viewer_num":"410"},{"duration":"0","finish_time":"1792579835","revenue":"82.69281537669372","total_user":"9594","total_user_incre":"1450","viewer_num":"438"}],"id":"7699061230417349407","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"history":{"items":{"properties":{"duration":{"type":"string"},"finish_time":{"type":"string"},"revenue":{"type":"string"},"total_user":{"type":"string"},"total_user_incre":{"type":"string"},"viewer_num":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok LIVE · history","tags":["live"],"x-credits":1,"x-example-params":{"id":"7699061230417349407"},"x-mcp-method":"history","x-mcp-tool":"live"}},"/v1/lives/{id}/products":{"get":{"description":"This route: products sold in the LIVE, with revenue.\n\nOne LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). [Shop Analytics, any market via region]: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {\"id\":\"7695846289116416799\",\"method\":\"products\"}.","operationId":"GET_lives_id_products","parameters":[{"description":"LIVE room id.","example":"7702601891041020685","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":0,"currency":"USD","dataEnd":"2026-10-28","hasMore":false,"id":"7702601891041020685","items":[],"market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok LIVE · products","tags":["live"],"x-credits":1,"x-example-params":{"id":"7702601891041020685","limit":3},"x-mcp-method":"products","x-mcp-tool":"live"}},"/v1/lives/{id}/sales":{"get":{"description":"This route: revenue, units, duration, viewers.\n\nOne LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). [Shop Analytics, any market via region]: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {\"id\":\"7695846289116416799\",\"method\":\"products\"}.","operationId":"GET_lives_id_sales","parameters":[{"description":"LIVE room id.","example":"7699061230417349407","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"7699061230417349407","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"id":"7699061230417349407","revenue":"$174.88k","sale":"5.87k","unit_price":"$29.81","viewer_num":"435","views":"3.09m"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"id":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"unit_price":{"type":"string"},"viewer_num":{"type":"string"},"views":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok LIVE · sales","tags":["live"],"x-credits":1,"x-example-params":{"id":"7699061230417349407"},"x-mcp-method":"sales","x-mcp-tool":"live"}},"/v1/lives/{id}/strategy":{"get":{"description":"This route: price bands of what was sold.\n\nOne LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). [Shop Analytics, any market via region]: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {\"id\":\"7695846289116416799\",\"method\":\"products\"}.","operationId":"GET_lives_id_strategy","parameters":[{"description":"LIVE room id.","example":"7699061230417349407","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"7699061230417349407","market":"US","notes":["Market US (United States): amounts are in USD."],"pricing":[{"cate_id":"Others","id":"-1","percentage":"100","revenue":"$174.88k"},{"cate_id":"Beauty \u0026 Personal Care","id":"601450","percentage":92,"revenue":"$161.70k"},{"cate_id":"Home Supplies","id":"600001","percentage":0,"revenue":"$0.00"}],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"pricing":{"items":{"properties":{"cate_id":{"type":"string"},"id":{"type":"string"},"percentage":{"type":"string"},"revenue":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok LIVE · strategy","tags":["live"],"x-credits":1,"x-example-params":{"id":"7699061230417349407"},"x-mcp-method":"strategy","x-mcp-tool":"live"}},"/v1/lives/{id}/stream-urls":{"get":{"description":"This route: recording and stream URLs.\n\nOne LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). [Shop Analytics, any market via region]: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {\"id\":\"7695846289116416799\",\"method\":\"products\"}.","operationId":"GET_lives_id_stream_urls","parameters":[{"description":"LIVE room id.","example":"7702601891041020685","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"7702601891041020685","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","urls":{"is_purchase":false,"record_type":"SHORT","screenshotUrl":"https://example.com/media\u0026time=1793403315359","shortUrl":"https://example.com/media\u0026time=1793403315373"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"urls":{"properties":{"is_purchase":{"type":"boolean"},"record_type":{"type":"string"},"screenshotUrl":{"type":"string"},"shortUrl":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok LIVE · stream_urls","tags":["live"],"x-credits":1,"x-example-params":{"id":"7702601891041020685","limit":3},"x-mcp-method":"stream_urls","x-mcp-tool":"live"}},"/v1/lives/{id}/top-categories":{"get":{"description":"This route: top categories sold.\n\nOne LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). [Shop Analytics, any market via region]: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {\"id\":\"7695846289116416799\",\"method\":\"products\"}.","operationId":"GET_lives_id_top_categories","parameters":[{"description":"LIVE room id.","example":"7699061230417349407","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"categories":{"topCates":[{"cate_id":"Beauty \u0026 Personal Care","id":"601450","revenue":5030}]},"currency":"USD","dataEnd":"2026-10-28","id":"7699061230417349407","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"categories":{"properties":{"topCates":{"items":{"properties":{"cate_id":{"type":"string"},"id":{"type":"string"},"revenue":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok LIVE · top_categories","tags":["live"],"x-credits":1,"x-example-params":{"id":"7699061230417349407"},"x-mcp-method":"top_categories","x-mcp-tool":"live"}},"/v1/markets":{"get":{"description":"This route: the supported markets.\n\nLists the TikTok Shop markets Shop Analytics covers, with each market's currency, language and tier. core = the 13 main markets; extended = Poland, Italy, the Netherlands and Ireland, which Shop Analytics also answers with local data. Pass the code as region to any Shop Analytics tool; other countries are refused. Default market is US. Example: {}.","operationId":"GET_markets","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":17,"default":"US","markets":[{"code":"US","currency":"USD","language":"en","name":"United States","tier":"core"},{"code":"GB","currency":"GBP","language":"en","name":"United Kingdom","tier":"core"},{"code":"DE","currency":"EUR","language":"de","name":"Germany","tier":"core"}],"notes":["Pass a market's code as region to product_top_selling, shop_top_selling, creator_top_selling, video_top_selling, live_top_selling, category_trends, product, shop, creator_commerce, video or live (their Shop Analytics methods).","Amounts are in the market's currency; product, shop and creator names are in the market's language. Product and shop ids belong to one market: use them with the same region.","Only these markets are accepted. The data source answers any other country code with one default dataset instead of local data, so TokConnect refuses them."]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"default":{"type":"string"},"markets":{"items":{"properties":{"code":{"type":"string"},"currency":{"type":"string"},"language":{"type":"string"},"name":{"type":"string"},"tier":{"type":"string"}},"type":"object"},"type":"array"},"notes":{"items":{"type":"string"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Shop Analytics markets","tags":["shop_regions"],"x-credits":1,"x-mcp-method":"","x-mcp-tool":"shop_regions"}},"/v1/places/{id}":{"get":{"description":"This route: name, category, address, tagged video count.\n\nOne tagged place: business, venue or landmark (id from place_search, a post's place.id, or a place link): detail, videos tagged there, or TikTok's public reviews. Example: {\"id\":\"2214...\",\"method\":\"reviews\"}.","operationId":"GET_places_id","parameters":[{"description":"Place id (place.id on a post, or from place_search) or a place link.","example":"42203860535857971","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"address":"Haarlemmerstraat 44, 1013 ES Amsterdam, Netherlands","category":"Coffee Shop","city":"Amsterdam","hours":"1:00 AM – 8:00 AM","id":"42203860535857971","name":"Coffeeshop Amsterdam","rating":5,"reviews":19,"url":"https://www.tiktok.com/place/-42203860535857971","videos":285},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"address":{"type":"string"},"category":{"type":"string"},"city":{"type":"string"},"hours":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"rating":{"type":"integer"},"reviews":{"type":"integer"},"url":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One place · detail","tags":["place"],"x-credits":1,"x-example-params":{"id":"42203860535857971"},"x-mcp-method":"detail","x-mcp-tool":"place"}},"/v1/places/{id}/reviews":{"get":{"description":"This route: public reviews with stars, text and photos.\n\nOne tagged place: business, venue or landmark (id from place_search, a post's place.id, or a place link): detail, videos tagged there, or TikTok's public reviews. Example: {\"id\":\"2214...\",\"method\":\"reviews\"}.","operationId":"GET_places_id_reviews","parameters":[{"description":"Place id (place.id on a post, or from place_search) or a place link.","example":"42203860535857971","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. videos max 30, reviews max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOjN9","place":"Coffeeshop Amsterdam","reviews":[{"id":"7686931645366600481","language":"mk","posted":"2026-09-19T15:51:36Z","rating":5,"reviewer":".qcold3","text":"заебато"},{"id":"7679038250304045857","language":"nl","posted":"2026-08-29T14:57:57Z","rating":5,"reviewer":"user.anoniem033","text":"lekker wietje"}],"score":5,"scoreLabel":"Eccezionale","totalReviews":19},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"place":{"type":"string"},"reviews":{"items":{"properties":{"id":{"type":"string"},"language":{"type":"string"},"posted":{"type":"string"},"rating":{"type":"integer"},"reviewer":{"type":"string"},"text":{"type":"string"}},"type":"object"},"type":"array"},"score":{"type":"integer"},"scoreLabel":{"type":"string"},"totalReviews":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One place · reviews","tags":["place"],"x-credits":1,"x-example-params":{"id":"42203860535857971","limit":3},"x-mcp-method":"reviews","x-mcp-tool":"place"}},"/v1/places/{id}/videos":{"get":{"description":"This route: videos tagged at the place.\n\nOne tagged place: business, venue or landmark (id from place_search, a post's place.id, or a place link): detail, videos tagged there, or TikTok's public reviews. Example: {\"id\":\"2214...\",\"method\":\"reviews\"}.","operationId":"GET_places_id_videos","parameters":[{"description":"Place id (place.id on a post, or from place_search) or a place link.","example":"42203860535857971","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. videos max 30, reviews max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOiIxNTkxNCJ9","videos":[{"caption":"i really need some video ideas 😭#viral #foryou #xyzcba #bikelife #boyfriend","comments":125,"creator":{"followers":2437,"handle":"skppy.x","id":"6843364600545575942","nickname":"pinda🦘🏍","secUid":"MS4wLjABAAAAmLBnir6TTibzwb0g7YJg_7hCOWxu6fStF2XQjEtsHvT2_CL9B3eqMRIaFkD7819G"},"durationSec":10,"hashtags":[{"id":"20884","name":"viral"},{"id":"42164","name":"foryou"},{"id":"1652823554560005","name":"xyzcba"}],"id":"7598997004211014944","language":"en","likes":90300,"place":{"id":"42203860535857971","name":"Coffeeshop Amsterdam"},"posted":"2026-01-24T18:29:40Z","saves":7251,"shares":5526,"sound":{"author":"Aurora 💫","id":"7135134965590657834","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@skppy.x/video/7598997004211014944","views":679400},{"caption":"lekkerste ontbijt in nederland  #fyp #viral #tosti  #antidepresivo #ontbijt","comments":119,"creator":{"followers":6713,"handle":"kroketa.memes","id":"7445298973416211488","nickname":"kroketa memes","secUid":"MS4wLjABAAAAlBOLPepjOXfIm81qNQI2tEkm5diCvzBOUqckXgBP-f3XzMaWE4erJw6XoEBHKW52"},"durationSec":7,"hashtags":[{"id":"229207","name":"fyp"},{"id":"20884","name":"viral"},{"id":"3019133","name":"tosti"}],"id":"7592287717405297952","language":"nl","likes":49800,"place":{"id":"42203860535857971","name":"Coffeeshop Amsterdam"},"posted":"2026-01-06T16:34:13Z","saves":6600,"shares":19300,"sound":{"author":"kroketa memes","id":"7592287775769070368","original":true,"title":"origineel geluid"},"url":"https://www.tiktok.com/@kroketa.memes/video/7592287717405297952","views":643200},{"caption":"@JERJERRR :: final diva #fyp #diva #veryverytugf #jeremy #edit @༝꩜🦋𝘕𝘢𝘺𝘢🌀🧩🌀🐉🐺𝛂丰㊙🛝🛹 @ꪑ𝓲ꪑ𝓲 ᖭི༏ᖫྀ (ᴇʟʟɪᴇ’s ᴠᴇʀsɪᴏɴ) @amelia.mamuti13 @𝖆𝖎𝖒𝖊𝖊 ⚯ ͛ @ayoub_0164 @❥︎𝐿𝑖𝑧𝑧𝑖𝑒","comments":75,"creator":{"followers":286,"handle":"doe_maar","id":"7605724897726383126","nickname":"𝔇𝔦𝔩𝔞𝔯𝔞|🏚️","secUid":"MS4wLjABAAAA-8YvQCd6wGpH3mRgg_hFZiHIy4TA6DBqTcEKUiKhjGk5XIltlCUchVSxuKYNZcW_"},"durationSec":14,"hashtags":[{"id":"229207","name":"fyp"},{"id":"16087","name":"diva"},{"id":"7640578335592218657","name":"veryverytugf"}],"id":"7640909707703536929","language":"en","likes":16000,"place":{"id":"42203860535857971","name":"Coffeeshop Amsterdam"},"posted":"2026-05-17T17:12:09Z","saves":1310,"shares":1238,"sound":{"author":"𝔇𝔦𝔩𝔞𝔯𝔞|🏚️","id":"7640909718353775392","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@doe_maar/video/7640909707703536929","views":103600}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOiIxNTkxNCJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"integer"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"place":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One place · videos","tags":["place"],"x-credits":1,"x-example-params":{"id":"42203860535857971","limit":3},"x-mcp-method":"videos","x-mcp-tool":"place"}},"/v1/playlists/{id}":{"get":{"description":"This route: name, video count, owner.\n\nOne creator playlist or saved collection (id from creator method=playlists or method=collections): detail or its videos. Example: {\"id\":\"7123...\",\"kind\":\"playlist\",\"method\":\"videos\"}.","operationId":"GET_playlists_id","parameters":[{"description":"Playlist or collection id.","example":"7628692798685940494","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"playlist (default) or collection.","in":"query","name":"kind","required":false,"schema":{"enum":["playlist","collection"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"creator":{"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"},"id":"7628692798685940494","name":"Athlete Versus","videos":4},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"id":{"type":"string"},"name":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One playlist or collection · detail","tags":["creator_playlist"],"x-credits":1,"x-example-params":{"id":"7628692798685940494"},"x-mcp-method":"detail","x-mcp-tool":"creator_playlist"}},"/v1/playlists/{id}/videos":{"get":{"description":"This route: the videos in it.\n\nOne creator playlist or saved collection (id from creator method=playlists or method=collections): detail or its videos. Example: {\"id\":\"7123...\",\"kind\":\"playlist\",\"method\":\"videos\"}.","operationId":"GET_playlists_id_videos","parameters":[{"description":"Playlist or collection id.","example":"7628692798685940494","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"playlist (default) or collection.","in":"query","name":"kind","required":false,"schema":{"enum":["playlist","collection"],"type":"string"}},{"description":"Results per page. Max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJjdXJzb3IiOiIzIn0","videos":[{"allowsAdUse":true,"caption":"@A’ja Wilson has been and forever will be a bucket 🪣","comments":82,"creator":{"followers":9300000,"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","verified":true},"durationSec":78,"id":"7611313628892908814","isAd":true,"language":"en","likes":4538,"posted":"2026-02-26T23:04:22Z","saves":222,"shares":165,"sound":{"author":"Nike","id":"7611313645716507405","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@nike/video/7611313628892908814","views":102300},{"allowsAdUse":true,"caption":"Sabrina Ionescu isn’t new to this","comments":77,"creator":{"followers":9300000,"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","verified":true},"durationSec":76,"id":"7628691578630032653","isAd":true,"language":"en","likes":2677,"posted":"2026-04-14T19:00:22Z","saves":147,"shares":81,"sound":{"author":"Nike","id":"7628691779193211662","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@nike/video/7628691578630032653","views":170100},{"allowsAdUse":true,"caption":"We all know Nelly Korda can sink putts but she can sink some baskets too.","comments":152,"creator":{"followers":9300000,"handle":"nike","id":"208464585232822272","nickname":"Nike","secUid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","verified":true},"durationSec":84,"id":"7629804861051161869","isAd":true,"language":"en","likes":2189,"posted":"2026-04-17T19:00:09Z","saves":136,"shares":115,"sound":{"author":"Nike","id":"7629804938620685069","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@nike/video/7629804861051161869","views":184000}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOiIzIn0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"items":{"properties":{"allowsAdUse":{"type":"boolean"},"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"durationSec":{"type":"integer"},"id":{"type":"string"},"isAd":{"type":"boolean"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One playlist or collection · videos","tags":["creator_playlist"],"x-credits":1,"x-example-params":{"id":"7628692798685940494","limit":"3"},"x-mcp-method":"videos","x-mcp-tool":"creator_playlist"}},"/v1/products/top":{"get":{"description":"This route: products ranked by sales.\n\n[Shop Analytics] Products ranked by estimated sales over a date range: revenue, units, video/LIVE/showcase split, growth, price, commission, creators, launch date, daily trend. keyword = words in product titles; category = a category name or id (levels 1-3, several allowed; no keyword needed); both together narrow further. With neither, the result is the top 10 products for the most recent days (about 6). Up to 100 rows per page with cursor paging, about 700 rows per keyword (max_rows up to 3,000 in the US). sort: revenue, units, price, growth or creators; order=asc lists lowest first. Filters: revenue, units, growth, price, commission, creators, launch date, channel, rating, seller type, shipping. region picks the market (default US). Shopper's live view: shop_browse. Examples: {\"category\":\"Skincare\",\"launched_within_days\":\"30\"}, {\"keyword\":\"lip oil\",\"region\":\"DE\",\"sort\":\"units\"}.","operationId":"GET_products_top","parameters":[{"description":"Filter. PUBLIC_PLAN = open affiliate plan; NON_AFFILIATE = not open to affiliates.","in":"query","name":"affiliate","required":false,"schema":{"enum":["PUBLIC_PLAN","NON_AFFILIATE"],"type":"string"}},{"description":"Narrow to one or more Shop categories (up to 5), by name or numeric id, levels 1 to 3: [\"Skincare\"], [\"Pet Supplies\"], [\"Beauty \u0026 Personal Care\",\"Health\"] or [\"601450\"]. Without a keyword the products of the category are found by merging several generic keyword searches (a keyword is needed), and the result says how many keyword sweeps and distinct rows that gave. Find names and ids with category_trends method=tree.","in":"query","name":"category","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter. Affiliate commission percent, e.g. 15-35.","in":"query","name":"commission","required":false,"schema":{"type":"string"}},{"description":"Filter. Percent of creators who made a sale, e.g. \u003e45.","in":"query","name":"creator_conversion","required":false,"schema":{"type":"string"}},{"description":"Filter. Number of creators selling it, e.g. 10-50.","in":"query","name":"creators","required":false,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Words from product titles, e.g. 'vitamin c serum' or 'lip oil'. Ranks every matching product over your window. If keyword and category are both omitted, the result is the top 10 products for the most recent days (about 6), whatever window is set: pass a keyword or category when the user wants more than 10 rows or a specific window.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Filter. Only products launched in the last N days.","in":"query","name":"launched_within_days","required":false,"schema":{"enum":["3","7","30","180","365"],"type":"string"}},{"description":"Results per page. Max 100 per page; pass next as cursor for the following page. Up to about 700 rows per keyword (max_rows scans up to 3,000 in the US). Without a keyword or category: 10 rows. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Scan up to this many matching products (101-3000) before sorting, to go past the 700-row cap; the top limit rows are returned. Needs keyword; US market only; not with category.","in":"query","name":"max_rows","required":false,"schema":{"type":"integer"}},{"description":"desc (default, highest first) or asc (lowest first among the matching rows; pair it with a revenue or units filter to skip dead listings). Applies with a keyword or category.","in":"query","name":"order","required":false,"schema":{"enum":["desc","asc"],"type":"string"}},{"description":"Filter. Average selling price in the market's currency, e.g. \u003c20 or 20-100.","in":"query","name":"price","required":false,"schema":{"type":"string"}},{"description":"Filter. Product rating, e.g. \u003e4.5.","in":"query","name":"rating","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Filter. Revenue in the market's currency over the window: a-b, \u003ca or \u003eb, e.g. 1000-10000.","in":"query","name":"revenue","required":false,"schema":{"type":"string"}},{"description":"Filter. Revenue growth vs the previous equal window, percent, e.g. \u003e30.","in":"query","name":"revenue_growth","required":false,"schema":{"type":"string"}},{"description":"Filter. Where the revenue came from: VIDEO, LIVE or SHOWCASE (shop tab and search). Several: comma separated, e.g. VIDEO,LIVE. Values: VIDEO, LIVE, SHOWCASE.","in":"query","name":"sales_channel","required":false,"schema":{"type":"string"}},{"description":"Filter. Who sold it: the seller's own accounts, independent affiliates, or the Shop mall.","in":"query","name":"seller_type","required":false,"schema":{"enum":["BELONGED_TO_SELLER","INDEPENDENT","SHOPPING_MALL"],"type":"string"}},{"description":"Filter. local = ships from warehouses in the market; global = cross-border.","in":"query","name":"shipping","required":false,"schema":{"enum":["local","global"],"type":"string"}},{"description":"Ranking metric: creators, growth, price, revenue, units. Default revenue. growth favours brand-new items (shown as \u003e999.9%); pair it with a revenue or units filter. Applies with a keyword or category.","in":"query","name":"sort","required":false,"schema":{"enum":["creators","growth","price","revenue","units"],"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Filter. Units sold over the window, e.g. 500-5000 or \u003e10000.","in":"query","name":"units","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":3,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"items":[{"commission_rate":"13%","creator_conversion_ratio":0.47589952477936187,"creator_num":1473,"delivery_type":"local","id":"1731896769144001226","is_full_service":0,"is_overseas":0,"is_tokopedia":0,"launch_date":"2025-10-18","live_revenue":"$5.19k","max_real_price":"$13.92","min_real_price":"$13.92","pri_cate_id":601450,"product_rating":4.4,"product_title":"Hydrating Lip Gloss - High Shine \u0026 Tinted, Infused with Hyaluronic Acid, Jojoba Oil \u0026 Shea Butter","revenue":"$285.28k","revenue_grouping_rate":"16.2%","revenue_trend":[4760,0,0],"sale":35660,"sec_cate_id":848648,"shipping_fee":"$0.00","showcase_revenue":"$112.00","ter_cate_id":601534,"total":407,"unit_price":"$8.00","video_revenue":"$279.98k"},{"commission_rate":"15%","creator_conversion_ratio":0.47819767441860467,"creator_num":688,"delivery_type":"local","id":"1732111846411833635","is_full_service":0,"is_overseas":0,"is_tokopedia":0,"launch_date":"2025-12-02","live_revenue":"$2.72k","max_real_price":"$14.00","min_real_price":"$14.00","pri_cate_id":601450,"product_rating":4.6,"product_title":"e.l.f. Glow Reviver Lip Oil Stick, Nourishing Lip Oil Stick Infused with Squalane Shea Butter \u0026 Jojoba Oil for Buildable Color \u0026 Soft Shine 3.3mL","revenue":"$177.48k","revenue_grouping_rate":"25.6%","revenue_trend":[2700,5480,8200],"sale":17748,"sec_cate_id":848648,"shipping_fee":"$0.00","showcase_revenue":"$30.00","ter_cate_id":601534,"total":407,"unit_price":"$10.00","video_revenue":"$174.73k"},{"commission_rate":"13%","creator_conversion_ratio":0.4717948717948718,"creator_num":780,"delivery_type":"local","id":"1729440860171702516","is_full_service":0,"is_overseas":0,"is_tokopedia":0,"launch_date":"2024-04-10","live_revenue":"$17.58k","max_real_price":"$19.50","min_real_price":"$15.00","pri_cate_id":601450,"product_rating":4.2,"product_title":"Nooni Korean Apple Lip Oil + Lip Stain | Glossy Lip Stain, Tinting \u0026 Long Lasting, Moisturizing Lip Care (17 options) Hydrate Lipgloss Lipstick Makeup Glossy Hydrating Moisturizer Plump Transfer-proof","revenue":"$169.86k","revenue_grouping_rate":"-3.2%","revenue_trend":[3795,4365,5115],"sale":11324,"sec_cate_id":848648,"shipping_fee":"$0.00","showcase_revenue":"$330.00","ter_cate_id":601534,"total":407,"unit_price":"$15.00","video_revenue":"$151.95k"}],"keyword":"lip oil","market":"US","next":"eyJwYWdlIjoyLCJzaXplIjozfQ","notes":["Market US (United States): amounts are in USD."],"see_also":"Pass a row's id to product: method=trend (daily), creators (who sells it), video_sales, page (live price and stock).","sortedBy":"revenue","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totalMatched":407,"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjozfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"items":{"items":{"properties":{"commission_rate":{"type":"string"},"creator_conversion_ratio":{"type":"number"},"creator_num":{"type":"integer"},"delivery_type":{"type":"string"},"id":{"type":"string"},"is_full_service":{"type":"integer"},"is_overseas":{"type":"integer"},"is_tokopedia":{"type":"integer"},"launch_date":{"type":"string"},"live_revenue":{"type":"string"},"max_real_price":{"type":"string"},"min_real_price":{"type":"string"},"pri_cate_id":{"type":"integer"},"product_rating":{"type":"number"},"product_title":{"type":"string"},"revenue":{"type":"string"},"revenue_grouping_rate":{"type":"string"},"revenue_trend":{"items":{"type":"integer"},"type":"array"},"sale":{"type":"integer"},"sec_cate_id":{"type":"integer"},"shipping_fee":{"type":"string"},"showcase_revenue":{"type":"string"},"ter_cate_id":{"type":"integer"},"total":{"type":"integer"},"unit_price":{"type":"string"},"video_revenue":{"type":"string"}},"type":"object"},"type":"array"},"keyword":{"type":"string"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"type":"string"},"sortedBy":{"type":"string"},"source":{"type":"string"},"totalMatched":{"type":"integer"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Top-selling TikTok Shop products","tags":["product_top_selling"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"","x-mcp-tool":"product_top_selling"}},"/v1/products/{id}":{"get":{"description":"This route: live price, SKUs and stock, sold, rating, shop.\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"categories":["Beauty \u0026 Personal Care","Makeup","Lipstick \u0026 Lip Gloss"],"currency":"USD","delivery":"3-day delivery","id":"1731896769144001226","moreFromShop":[{"brand":"Truly Beauty","currency":"USD","id":"1729389462563361482","price":33,"rating":4.4,"reviews":9993,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":81325,"title":"Glazed Donut Brightening Oil – Discoloration-Fighting Treatment – Brightens Dull, Uneven Skin with Vitamin E, Niacinamide \u0026 Hyaluronic Acid – Deeply Hydrates, Minimizes Ingrowns \u0026 Enhances Radiance on Legs, Underarms \u0026 Bikini Line – Vanilla Glaze Scent","url":"https://shop.tiktok.com/us/pdp/after-shave-oil-by-truly-beauty-glazed-donut-hydrating-serum/1729389462563361482"},{"brand":"Truly Beauty","currency":"USD","id":"1729445990437982922","price":33,"rating":4.5,"reviews":16603,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":150492,"title":"Soft Serve After Shave Oil – Soothes Razor Burn and Redness with Peptides \u0026 Hyaluronic Acid – Increases Collagen Production – Prevents Ingrowns and Brightens Uneven Skin Tone for Smoother Legs, Underarms \u0026 Pubic Area – Strawberry Vanilla Scent","url":"https://shop.tiktok.com/us/pdp/after-shave-oil-by-truly-beauty-soft-serve-strawberry-vanilla-scent/1729445990437982922"},{"brand":"Truly Beauty","currency":"USD","discount":"10%","id":"1729389546288747210","originalPrice":33,"price":29.7,"rating":4.3,"reviews":9856,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":105758,"title":"Jelly Booster Pigment Body Potion – Targeted Discoloration Treatment with Pomegranate \u0026 Vitamin B12 – Corrects Dark Spots, Hyperpigmentation \u0026 Acne Scars – Boosts Collagen and Renews Skin for a Smoother, Even Tone – Suitable for All Skin Types","url":"https://shop.tiktok.com/us/pdp/jelly-booster-body-potion-by-pomegranate-targets-hyperpigmentation-boosts-collagen/1729389546288747210"}],"price":13.92,"rating":4.5,"relatedProducts":[{"brand":"Truly Beauty","currency":"USD","discount":"52%","id":"1731896769144001226","originalPrice":29,"price":13.92,"rating":4.5,"reviews":14794,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":153726,"title":"Hydrating Lip Gloss - High Shine \u0026 Tinted, Infused with Hyaluronic Acid, Jojoba Oil \u0026 Shea Butter","url":"https://shop.tiktok.com/us/pdp/hydrating-lip-gloss-high-shine-tinted-hyaluronic-acid/1731896769144001226"},{"brand":"Colourpop Cosmetics LLC","currency":"USD","id":"1730162690572390449","price":12.99,"rating":4.8,"reviews":4092,"sellerId":"7495294719207180337","shop":"ColourPop Cosmetics","sold":45759,"title":"ColourPop Fresh Kiss Glossy Balm - Peptides \u0026 Hyaluronic Acid","url":"https://shop.tiktok.com/us/pdp/glossy-lip-balm-by-colourpop-fresh-kiss-with-peptides-hyaluronic-acid/1730162690572390449"},{"brand":"Laneige","currency":"USD","id":"1729424048269136205","price":24.7,"rating":4.8,"reviews":2000,"sellerId":"7495286718562273613","shop":"Laneige US","sold":6367,"title":"Laneige Lip Glowy Balm, Hydrating and Glossy Tinted Lip Care with Shea Butter, Korean Skincare, Lightweight Moisturizer","url":"https://shop.tiktok.com/us/pdp/lip-glowy-balm-by-laneige-us-moisture-rich-hydrating-treatment/1729424048269136205"}],"reviews":14794,"sellerId":"7495153913553128138","shop":"Truly Beauty","shopInfo":{"name":"Truly Beauty","products":49,"rating":4.4,"sellerId":"7495153913553128138","sold":1786361},"skus":[{"id":"1731896802257769162","inStock":true,"price":13.92,"variant":"Soft Serve"},{"id":"1731896802257834698","inStock":true,"price":13.92,"variant":"Glazed Donut"},{"id":"1731896802257900234","inStock":true,"price":13.92,"variant":"Vanilla Baby"}],"sold":153726,"title":"Hydrating Lip Gloss - High Shine \u0026 Tinted, Infused with Hyaluronic Acid, Jojoba Oil \u0026 Shea Butter","url":"https://www.tiktok.com/view/product/1731896769144001226","videos":[{"caption":"The definition of a high shine gloss!😍🤏🏽🫦#trulylipgloss #trulybeauty #tiktokshopstockup #tiktokshopcreatorpicks #tiktokshopmothersday","creatorId":"7384276485555094570","creatorName":"Peta🎀","durationSec":32.2,"earnsCommission":true,"likes":72013,"posted":"2026-04-30T04:39:25Z","videoId":"7634407159618489630","views":6015574},{"caption":"shade: soft serve 🎀🍦 extra hydration with hyaluronic acid! 💦 @Truly Beauty #hyaluronicacid #lipgloss #lipcare #lipessentials #lippies","creatorId":"6807303228855305221","creatorName":"leah ♡","durationSec":16.973,"earnsCommission":true,"likes":66363,"posted":"2025-12-14T08:40:54Z","videoId":"7583630601534672158","views":2922982},{"caption":"Trulys LIP GLOSS 💋✨ I need every single shade #tiktokshopcreatorpicks #tiktokshopmemorialday #ttsverticalpro #trulybeauty #lipgloss @Truly Beauty","creatorId":"6813360351690949637","creatorName":"ChavonSade🦋","durationSec":18.134,"earnsCommission":true,"likes":69809,"posted":"2026-05-11T17:30:44Z","videoId":"7638687816909671694","views":5151747}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"categories":{"items":{"type":"string"},"type":"array"},"currency":{"type":"string"},"delivery":{"type":"string"},"id":{"type":"string"},"moreFromShop":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"id":{"type":"string"},"price":{"type":"integer"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"price":{"type":"number"},"rating":{"type":"number"},"relatedProducts":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"discount":{"type":"string"},"id":{"type":"string"},"originalPrice":{"type":"integer"},"price":{"type":"number"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"shopInfo":{"properties":{"name":{"type":"string"},"products":{"type":"integer"},"rating":{"type":"number"},"sellerId":{"type":"string"},"sold":{"type":"integer"}},"type":"object"},"skus":{"items":{"properties":{"id":{"type":"string"},"inStock":{"type":"boolean"},"price":{"type":"number"},"variant":{"type":"string"}},"type":"object"},"type":"array"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"creatorId":{"type":"string"},"creatorName":{"type":"string"},"durationSec":{"type":"number"},"earnsCommission":{"type":"boolean"},"likes":{"type":"integer"},"posted":{"type":"string"},"videoId":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · page","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"page","x-mcp-tool":"product"}},"/v1/products/{id}/analysis":{"get":{"description":"This route: selling-point highlights and attributes Shop Analytics extracts for the product.\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_analysis","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"analysis":{"attributes":[{"key":"Skin Type","value":"All Skin Types"},{"key":"Region Of Origin","value":"US"},{"key":"Product Form","value":"Liquid"}],"highlights":[{"key_word":"Lasting Hydration","region_text":"Lasting Hydration: Lips stay soft, smooth, and quenched for hours."},{"key_word":"High-Shine Finish","region_text":"High-Shine Finish: Glossy, light-catching lips that feel luxurious."},{"key_word":"Instant Relief","region_text":"Instant Relief: Dry, chapped lips feel soothed from the first swipe."}]},"dataEnd":"2026-10-28","id":"1731896769144001226","market":"US","notes":["Market US (United States)."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"analysis":{"properties":{"attributes":{"items":{"properties":{"key":{"type":"string"},"value":{"type":"string"}},"type":"object"},"type":"array"},"highlights":{"items":{"properties":{"key_word":{"type":"string"},"region_text":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · analysis","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"analysis","x-mcp-tool":"product"}},"/v1/products/{id}/conversion":{"get":{"description":"This route: how many creators promote it and what share of them made sales.\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_conversion","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"conversion":{"creatorConversionRatio":0.47589952477936187,"creatorNum":1473},"creatorConversionPercent":47.6,"creatorConversionRatio":0.47589952477936187,"creators":1473,"dataEnd":"2026-10-28","id":"1731896769144001226","market":"US","notes":["Market US (United States).","creatorConversionRatio is the source's share of the creators promoting this product who made a sale in the window, as a fraction (0.59 means 59%)."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"conversion":{"properties":{"creatorConversionRatio":{"type":"number"},"creatorNum":{"type":"integer"}},"type":"object"},"creatorConversionPercent":{"type":"number"},"creatorConversionRatio":{"type":"number"},"creators":{"type":"integer"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · conversion","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"conversion","x-mcp-tool":"product"}},"/v1/products/{id}/creators":{"get":{"description":"This route: creators selling it, ranked, with revenue.\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_creators","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":20,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"id":"1731896769144001226","items":[{"followers":23600,"handle":"therealsiahhh","id":"6790832707742417925","live_revenue":"$0.00","nickname":"Shopping is my therapy","revenue":"$58.12k","sale":"7.27k","video_revenue":"$58.12k"},{"followers":19400,"handle":"xoxopeta","id":"7384276485555094570","live_revenue":"$0.00","nickname":"Peta🎀","revenue":"$37.02k","sale":"4.63k","video_revenue":"$37.02k"},{"followers":17400,"handle":"swishybeauty","id":"6672578604607685638","live_revenue":"$0.00","nickname":"swishybeauty","revenue":"$36.01k","sale":"4.5k","video_revenue":"$36.01k"}],"market":"US","next":"eyJwYWdlIjoyLCJzaXplIjoyMH0","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjoyMH0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"live_revenue":{"type":"string"},"nickname":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"video_revenue":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · creators","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"creators","x-mcp-tool":"product"}},"/v1/products/{id}/related":{"get":{"description":"This route: products TikTok shows as related.\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_related","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":false,"page":"related","products":[{"brand":"Truly Beauty","currency":"USD","discount":"52%","id":"1731896769144001226","originalPrice":29,"price":13.92,"rating":4.5,"reviews":14778,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":153728,"title":"Hydrating Lip Gloss - High Shine \u0026 Tinted, Infused with Hyaluronic Acid, Jojoba Oil \u0026 Shea Butter","url":"https://shop.tiktok.com/us/pdp/hydrating-lip-gloss-high-shine-tinted-hyaluronic-acid/1731896769144001226"},{"brand":"Colourpop Cosmetics LLC","currency":"USD","id":"1730162690572390449","price":12.99,"rating":4.8,"reviews":4092,"sellerId":"7495294719207180337","shop":"ColourPop Cosmetics","sold":45759,"title":"ColourPop Fresh Kiss Glossy Balm - Peptides \u0026 Hyaluronic Acid","url":"https://shop.tiktok.com/us/pdp/glossy-lip-balm-by-colourpop-fresh-kiss-with-peptides-hyaluronic-acid/1730162690572390449"},{"brand":"Laneige","currency":"USD","id":"1729424048269136205","price":24.7,"rating":4.8,"reviews":2000,"sellerId":"7495286718562273613","shop":"Laneige US","sold":6367,"title":"Laneige Lip Glowy Balm, Hydrating and Glossy Tinted Lip Care with Shea Butter, Korean Skincare, Lightweight Moisturizer","url":"https://shop.tiktok.com/us/pdp/lip-glowy-balm-by-laneige-us-moisture-rich-hydrating-treatment/1729424048269136205"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"page":{"type":"string"},"products":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"discount":{"type":"string"},"id":{"type":"string"},"originalPrice":{"type":"integer"},"price":{"type":"number"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · related","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"related","x-mcp-tool":"product"}},"/v1/products/{id}/review-insights":{"get":{"description":"This route: AI summary of reviews: pain points, praise, use cases (by_sku splits by variant).\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_review_insights","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"method=review_insights: split insights by SKU.","in":"query","name":"by_sku","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"dataEnd":"2026-10-28","id":"1731896769144001226","insights":{"badRate":"11.0%","commentSummary":"This lip gloss is praised for its hydrating, non-sticky texture, beautiful range of colors, high shine, and appealing packaging. Many users highlight its smooth application and lightweight feel. However, a significant number of customers are dissatisfied with the product quantity, noting that tubes …","goodRate":"89.0%","painPoints":[{"point":"Tube is half-empty or missing product","quotes":[{"date":"2026/04/10","rating":"1.0","sku":"Coco Cloud","text":"I don't know if it's air in the tube that prevents them from filling the tube but I feel like I got robbed! The tube is already small but its only filled half way. My lips did feel moisturized...they felt wet! 0 out of 10. I do NOT recommen..."},{"date":"2026/04/10","rating":"1.0","sku":"Soft Serve","text":"I don't know if it's air in the tube that prevents them from filling the tube but I feel like I got robbed! The tube is already small but its only filled half way. My lips did feel moisturized...they felt wet! 0 out of 10! I do NOT recommen..."}],"rate":"28.33%","reviews":17},{"point":"Short wear time / doesn't last","quotes":[{"date":"2026/04/13","rating":"5.0","sku":"Coco Cloud","text":"Goes on real cute but for some reason I have reapply often even though it's thick."},{"date":"2026/04/13","rating":"5.0","sku":"Vanilla Baby","text":"Goes on real cute but for some reason I have reapply often even though it's thick."}],"rate":"18.33%","reviews":11},{"point":"Product leaks or explodes upon opening","quotes":[{"date":"2026/04/13","rating":"1.0","sku":"Coco Cloud","text":"Lip gloss exploded the minute I opened it up. Lip gloss went everywhere. I will definitely not purchase again."},{"date":"2026/04/13","rating":"1.0","sku":"Glazed Donut","text":"This literally exploded when I opened it. The lip gloss went everywhere. Will not purchase again. I ordered 4 and they all did this!"}],"rate":"15.0%","reviews":9}],"positivePoints":[{"point":"Very hydrating and moisturizing","quotes":[{"date":"2026/04/10","rating":"5.0","sku":"Vanilla Baby","text":"This gloss is amazing! It is so hydrating and makes my lips feel great. I want to get every one they have now."},{"date":"2026/04/11","rating":"5.0","sku":"Glazed Donut","text":"This is my new favorite lip gloss. The color is sheer and beautiful, but the best is how it feels. It's not at all sticky and feels so hydrating. I'm ordering more."}],"rate":"22.47%","reviews":20},{"point":"Not sticky","quotes":[{"date":"2026/04/14","rating":"5.0","sku":"Coco Cloud","text":"Great gloss. Very shiney and not sticky"},{"date":"2026/04/14","rating":"5.0","sku":"Coco Cloud","text":"Love these! Not sticky at all"}],"rate":"20.22%","reviews":18},{"point":"Beautiful color options","quotes":[{"date":"2026/04/11","rating":"5.0","sku":"Soft Serve","text":"Love this color!! Perfect for my work desk! So soft !"},{"date":"2026/04/11","rating":"5.0","sku":"Glazed Donut","text":"Love this gloss and the color is gorgeous!"}],"rate":"17.98%","reviews":16}],"productRating":null,"skuNames":["Vanilla Baby","Coco Cloud","Glazed Donut"],"usageFrequency":[{"point":"Multiple times a day","quotes":[{"date":"2026/04/11","rating":"5.0","sku":"Soft Serve","text":"These are really amazing. They are really hydrating with a pop of color. I have one on my desk and apply several times throughout the day."}],"rate":"33.33%","reviews":1},{"point":"All the time","quotes":[{"date":"2026/04/11","rating":"5.0","sku":"Soft Serve","text":"Beautiful color and doesn't run! I'm keeping some of this stuff on hand at all times!"}],"rate":"33.33%","reviews":1},{"point":"Every day","quotes":[{"date":"2026/04/06","rating":"5.0","sku":"Soft Serve","text":"The color is so subtle and the gloss is thick and moisturizing. I like this gloss a lot and use it every day. I’d like to try other colors."}],"rate":"33.33%","reviews":1}],"usageLocation":[{"point":"At work/desk","quotes":[{"date":"2026/04/13","rating":"5.0","sku":"Soft Serve","text":"Love! The colors great and it so cute at my desk .😊"},{"date":"2026/04/11","rating":"5.0","sku":"Soft Serve","text":"Love this color!! Perfect for my work desk! So soft !"}],"rate":"66.67%","reviews":2},{"point":"On the go/portable","quotes":[{"date":"2026/04/08","rating":"5.0","sku":"Soft Serve","text":"Absolutely love it !!!! I added my own charm accessory to it now I can attach it to my keys and take it anywhere. The color shade is so beautiful and very nourishing on the lips. 💞"}],"rate":"33.33%","reviews":1}],"usageScenarios":[{"point":"Daily lip care and hydration","quotes":[{"date":"2026/04/11","rating":"5.0","sku":"Soft Serve","text":"These are really amazing. They are really hydrating with a pop of color. I have one on my desk and apply several times throughout the day."},{"date":"2026/04/06","rating":"5.0","sku":"Soft Serve","text":"The color is so subtle and the gloss is thick and moisturizing. I like this gloss a lot and use it every day. I’d like to try other colors."}],"rate":"41.67%","reviews":5},{"point":"Gifting","quotes":[{"date":"2026/04/12","rating":"5.0","sku":"Glazed Donut","text":"Gorgeous! My daughter loves it. Gifted to her for Easter."},{"date":"2026/04/05","rating":"5.0","sku":"Glazed Donut","text":"This is a great luxurious product with luxury packaging so makes a great gift. I definitely recommend!!"}],"rate":"25.0%","reviews":3},{"point":"For work or on desk","quotes":[{"date":"2026/04/11","rating":"5.0","sku":"Soft Serve","text":"Love this color!! Perfect for my work desk! So soft !"},{"date":"2026/04/13","rating":"5.0","sku":"Soft Serve","text":"Love! The colors great and it so cute at my desk .😊"}],"rate":"16.67%","reviews":2}]},"market":"US","notes":["Market US (United States)."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"dataEnd":{"type":"string"},"id":{"type":"string"},"insights":{"properties":{"badRate":{"type":"string"},"commentSummary":{"type":"string"},"goodRate":{"type":"string"},"painPoints":{"items":{"properties":{"point":{"type":"string"},"quotes":{"items":{"properties":{"date":{"type":"string"},"rating":{"type":"string"},"sku":{"type":"string"},"text":{"type":"string"}},"type":"object"},"type":"array"},"rate":{"type":"string"},"reviews":{"type":"integer"}},"type":"object"},"type":"array"},"positivePoints":{"items":{"properties":{"point":{"type":"string"},"quotes":{"items":{"properties":{"date":{"type":"string"},"rating":{"type":"string"},"sku":{"type":"string"},"text":{"type":"string"}},"type":"object"},"type":"array"},"rate":{"type":"string"},"reviews":{"type":"integer"}},"type":"object"},"type":"array"},"productRating":{"type":"null"},"skuNames":{"items":{"type":"string"},"type":"array"},"usageFrequency":{"items":{"properties":{"point":{"type":"string"},"quotes":{"items":{"properties":{"date":{"type":"string"},"rating":{"type":"string"},"sku":{"type":"string"},"text":{"type":"string"}},"type":"object"},"type":"array"},"rate":{"type":"string"},"reviews":{"type":"integer"}},"type":"object"},"type":"array"},"usageLocation":{"items":{"properties":{"point":{"type":"string"},"quotes":{"items":{"properties":{"date":{"type":"string"},"rating":{"type":"string"},"sku":{"type":"string"},"text":{"type":"string"}},"type":"object"},"type":"array"},"rate":{"type":"string"},"reviews":{"type":"integer"}},"type":"object"},"type":"array"},"usageScenarios":{"items":{"properties":{"point":{"type":"string"},"quotes":{"items":{"properties":{"date":{"type":"string"},"rating":{"type":"string"},"sku":{"type":"string"},"text":{"type":"string"}},"type":"object"},"type":"array"},"rate":{"type":"string"},"reviews":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · review_insights","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"review_insights","x-mcp-tool":"product"}},"/v1/products/{id}/reviews":{"get":{"description":"This route: public reviews.\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_reviews","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=reviews: all (default), with_media or verified.","in":"query","name":"filter","required":false,"schema":{"enum":["all","with_media","verified"],"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=reviews: jump to this page (1-100).","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=reviews: recommended (default) or newest.","in":"query","name":"sort","required":false,"schema":{"enum":["recommended","newest"],"type":"string"}},{"description":"method=reviews: star filter when filter=all.","in":"query","name":"stars","required":false,"schema":{"enum":["all","5","4","3","2","1"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJwYWdlX3N0YXJ0IjoyfQ","page":"reviews","reviews":[{"country":"US","id":"7689521632322307854","images":4,"posted":"2026-09-25T17:11:15Z","rating":5,"reviewer":"T**s C**","text":"The color pigment and texture is amazing.  My favorite New lipgloss to wear.   And keep in my purse to grab. Go get yours now!","variant":"Vanilla Baby","verifiedPurchase":true},{"country":"US","id":"7689520290272118542","images":4,"posted":"2026-09-25T17:06:03Z","rating":5,"reviewer":"T**s C**","text":"Shipping was FREE and FAST! The product and packaging was just as described so run don’t walk to purchase.  Already ordered my second batch of lipglosses.","variant":"Glazed Donut","verifiedPurchase":true},{"country":"US","id":"7627673224491321102","images":4,"posted":"2026-04-12T01:08:26Z","rating":5,"reviewer":"J**8","text":"They  both smell great . Coco cloud it Glades on smoothly. The shine is given rich glass . An number  It not sticky at all","variant":"Coco Cloud","verifiedPurchase":true}],"source":"https://shop.tiktok.com/us/pdp/1731896769144001226","totalReviews":14794},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlX3N0YXJ0IjoyfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"page":{"type":"string"},"reviews":{"items":{"properties":{"country":{"type":"string"},"id":{"type":"string"},"images":{"type":"integer"},"posted":{"type":"string"},"rating":{"type":"integer"},"reviewer":{"type":"string"},"text":{"type":"string"},"variant":{"type":"string"},"verifiedPurchase":{"type":"boolean"}},"type":"object"},"type":"array"},"source":{"type":"string"},"totalReviews":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · reviews","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"reviews","x-mcp-tool":"product"}},"/v1/products/{id}/sales":{"get":{"description":"This route: revenue, units, video/LIVE/showcase split, creator count, conversion (ids: up to 20 products).\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_sales","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"method=sales only: up to 20 product ids in one call.","in":"query","name":"ids","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"creatorConversion":{"creatorConversionRatio":0.47589952477936187,"creatorNum":1473},"currency":"USD","dataEnd":"2026-10-28","id":"1731896769144001226","market":"US","notes":["Market US (United States): amounts are in USD.","Part of this answer is missing because the data source did not answer: the Shop Analytics data source could not answer this request"],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"creatorConversionRatio":0.47589952477936187,"day_live_revenue":"$185.43","day_revenue":"$10.19k","day_sale":"1.27k","day_shopping_mall_revenue":"$4.00","day_video_revenue":"$10.00k","live_revenue":"$5.19k","original_live_revenue":5192,"original_revenue":285280,"original_shopping_mall_revenue":112,"original_video_revenue":279976,"related_creator_count":702,"revenue":"$285.28k","sale":"35.66k","shopping_mall_revenue":"$112.00","unit_price":"$8.00","video_revenue":"$279.98k"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"creatorConversion":{"properties":{"creatorConversionRatio":{"type":"number"},"creatorNum":{"type":"integer"}},"type":"object"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"creatorConversionRatio":{"type":"number"},"day_live_revenue":{"type":"string"},"day_revenue":{"type":"string"},"day_sale":{"type":"string"},"day_shopping_mall_revenue":{"type":"string"},"day_video_revenue":{"type":"string"},"live_revenue":{"type":"string"},"original_live_revenue":{"type":"integer"},"original_revenue":{"type":"integer"},"original_shopping_mall_revenue":{"type":"integer"},"original_video_revenue":{"type":"integer"},"related_creator_count":{"type":"integer"},"revenue":{"type":"string"},"sale":{"type":"string"},"shopping_mall_revenue":{"type":"string"},"unit_price":{"type":"string"},"video_revenue":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · sales","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"sales","x-mcp-tool":"product"}},"/v1/products/{id}/skus":{"get":{"description":"This route: sales by variant (SKU).\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_skus","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"1731896769144001226","market":"US","notes":["Market US (United States): amounts are in USD."],"skus":{"skus":[{"price_val":"$13.92","sales_proportion":0.3527,"sku_id":"1731896802257769162","sku_name":"Shade:Soft Serve","stock":29142,"stock_share_proportion":0.5678},{"price_val":"$13.92","sales_proportion":0.2488,"sku_id":"1731896802257834698","sku_name":"Shade:Glazed Donut","stock":926,"stock_share_proportion":0.018},{"price_val":"$13.92","sales_proportion":0.2156,"sku_id":"1731896802257900234","sku_name":"Shade:Vanilla Baby","stock":20765,"stock_share_proportion":0.4046}],"updated_at":"2026-09-24"},"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"skus":{"properties":{"skus":{"items":{"properties":{"price_val":{"type":"string"},"sales_proportion":{"type":"number"},"sku_id":{"type":"string"},"sku_name":{"type":"string"},"stock":{"type":"integer"},"stock_share_proportion":{"type":"number"}},"type":"object"},"type":"array"},"updated_at":{"type":"string"}},"type":"object"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · skus","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"skus","x-mcp-tool":"product"}},"/v1/products/{id}/trend":{"get":{"description":"This route: daily revenue and units (up to ~13 months).\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_trend","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"coverage":{"days":30,"daysWithSales":28,"firstDayWithSales":"2026-09-29"},"currency":"USD","dataEnd":"2026-10-28","id":"1731896769144001226","market":"US","notes":["Market US (United States): amounts are in USD."],"series":[{"creatorConversionRatio":0.2676923076923077,"live_revenue":120,"partition_day":"2026-09-29","revenue":4760,"sale":595,"unit_price":8,"video_revenue":4640},{"creatorConversionRatio":0,"live_revenue":0,"partition_day":"2026-09-30","revenue":0,"sale":0,"unit_price":8,"video_revenue":0},{"creatorConversionRatio":0,"live_revenue":0,"partition_day":"2026-10-01","revenue":0,"sale":0,"unit_price":8,"video_revenue":0}],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"revenue":285280,"units":35660},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"coverage":{"properties":{"days":{"type":"integer"},"daysWithSales":{"type":"integer"},"firstDayWithSales":{"type":"string"}},"type":"object"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"series":{"items":{"properties":{"creatorConversionRatio":{"type":"number"},"live_revenue":{"type":"integer"},"partition_day":{"type":"string"},"revenue":{"type":"integer"},"sale":{"type":"integer"},"unit_price":{"type":"integer"},"video_revenue":{"type":"integer"}},"type":"object"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"revenue":{"type":"integer"},"units":{"type":"integer"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · trend","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"trend","x-mcp-tool":"product"}},"/v1/products/{id}/video-sales":{"get":{"description":"This route: videos selling it, with revenue.\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_video_sales","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":20,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"id":"1731896769144001226","items":[{"ad":1,"ads":1,"ai_video":0,"content_type":"video","create_time":"2026/09/29 17:49:11","description":"Obsessed with this #lipgloss #drylips #lipcombo ","duration":"37s","id":"7691077500054637838","original_duration":37.867,"revenue":"$24.90k","sale":"3.11k","views":"3.42m"},{"ad":1,"ads":1,"ai_video":0,"content_type":"video","create_time":"2026/09/21 22:58:40","description":"Now this is how you do a high shine gloss!😍🤏🏽🫦✨#trulylipgloss #trulybeauty #lipgloss #tiktokshopstockup ","duration":"42s","id":"7688188610041957662","original_duration":42.9,"revenue":"$23.14k","sale":"2.89k","views":"3.3m"},{"ad":1,"ads":1,"ai_video":0,"content_type":"video","create_time":"2026/09/28 22:42:36","description":"","duration":"41s","id":"7690782072524393759","original_duration":41.145,"revenue":"$20.91k","sale":"2.61k","views":"3.3m"}],"market":"US","next":"eyJwYWdlIjoyLCJzaXplIjoyMH0","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjoyMH0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"ad":{"type":"integer"},"ads":{"type":"integer"},"ai_video":{"type":"integer"},"content_type":{"type":"string"},"create_time":{"type":"string"},"description":{"type":"string"},"duration":{"type":"string"},"id":{"type":"string"},"original_duration":{"type":"number"},"revenue":{"type":"string"},"sale":{"type":"string"},"views":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · video_sales","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"video_sales","x-mcp-tool":"product"}},"/v1/products/{id}/videos":{"get":{"description":"This route: the videos on the product page (first page only).\n\nEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {\"id\":\"1732052189676081387\",\"method\":\"trend\",\"window\":\"90d\"}, {\"ids\":[\"1729...\",\"1731...\"],\"method\":\"sales\",\"region\":\"DE\"}.","operationId":"GET_products_id_videos","parameters":[{"description":"Product id (products[].id) or a TikTok Shop product link.","example":"1731896769144001226","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":false,"page":"product_videos","source":"pdp","videos":[{"caption":"The definition of a high shine gloss!😍🤏🏽🫦#trulylipgloss #trulybeauty #tiktokshopstockup #tiktokshopcreatorpicks #tiktokshopmothersday","creatorId":"7384276485555094570","creatorName":"Peta🎀","durationSec":32.2,"earnsCommission":true,"likes":72013,"posted":"2026-04-30T04:39:25Z","videoId":"7634407159618489630","views":6015574},{"caption":"shade: soft serve 🎀🍦 extra hydration with hyaluronic acid! 💦 @Truly Beauty #hyaluronicacid #lipgloss #lipcare #lipessentials #lippies","creatorId":"6807303228855305221","creatorName":"leah ♡","durationSec":16.973,"earnsCommission":true,"likes":66363,"posted":"2025-12-14T08:40:54Z","videoId":"7583630601534672158","views":2922982},{"caption":"Trulys LIP GLOSS 💋✨ I need every single shade #tiktokshopcreatorpicks #tiktokshopmemorialday #ttsverticalpro #trulybeauty #lipgloss @Truly Beauty","creatorId":"6813360351690949637","creatorName":"ChavonSade🦋","durationSec":18.134,"earnsCommission":true,"likes":69809,"posted":"2026-05-11T17:30:44Z","videoId":"7638687816909671694","views":5151748}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"page":{"type":"string"},"source":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"creatorId":{"type":"string"},"creatorName":{"type":"string"},"durationSec":{"type":"number"},"earnsCommission":{"type":"boolean"},"likes":{"type":"integer"},"posted":{"type":"string"},"videoId":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop product · videos","tags":["product"],"x-credits":1,"x-example-params":{"id":"1731896769144001226"},"x-mcp-method":"videos","x-mcp-tool":"product"}},"/v1/reference/ad-regions":{"get":{"description":"This route: EU/UK regions the Ad Library covers.\n\nStatic lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields. Example: {\"method\":\"sales_filters\"}.","operationId":"GET_reference_ad_regions","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"code":0,"config_str":"FZWGxCEeVtiU4fNV9B3CI522OLi2P4B4TaUW+whWxOQ70wLG+tY0oT7fE6p0hZzG0gBjaSse9lpeOnImxViOSJA6YRzW5N2ZWPBkBC9PKOzGEj1J1zrz2V+iRuMKwXAiH5l7GX0jxlSK1nodWP+wvlkIpbC/wVZ+s5zqCeXyxBCC+UgmrIwivNHoXRhoMwYLrZMePDMSU3a/vKfnMHGwfJHi4yYCT9v4nQ==","regions":[{"id":"AT","name":"Austria"},{"id":"BE","name":"Belgium"},{"id":"BG","name":"Bulgaria"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"code":{"type":"integer"},"config_str":{"type":"string"},"regions":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Reference lists · ad_regions","tags":["reference"],"x-credits":1,"x-mcp-method":"ad_regions","x-mcp-tool":"reference"}},"/v1/reference/creative-markets":{"get":{"description":"This route: Creative Partner markets and dates.\n\nStatic lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields. Example: {\"method\":\"sales_filters\"}.","operationId":"GET_reference_creative_markets","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"countries":["CNOB","TH","ID"],"end":"2026-10-05T00:00:00Z","endUnix":1791158400,"start":"2025-07-05T00:00:00Z","startUnix":1751673600},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"countries":{"items":{"type":"string"},"type":"array"},"end":{"type":"string"},"endUnix":{"type":"integer"},"start":{"type":"string"},"startUnix":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Reference lists · creative_markets","tags":["reference"],"x-credits":1,"x-mcp-method":"creative_markets","x-mcp-tool":"reference"}},"/v1/reference/csi-channels":{"get":{"description":"This route: demand_find_topics feeds and trending categories.\n\nStatic lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields. Example: {\"method\":\"sales_filters\"}.","operationId":"GET_reference_csi_channels","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"channels":[{"categories":["Fashion","Food","Gaming"],"channel_key":"FOR_YOU","languages":["ar","de","en"],"name":"Suggeriti","tabDetails":[{"endpoint":"comprehensive","key":"ALL","name":"Tutti","queryKey":"all"},{"endpoint":"comprehensive","key":"CONTENT_GAP","name":"Diversità di contenuti","queryKey":"content_gap"},{"endpoint":"comprehensive","key":"SEARCHES_BY_FOLLOWERS","name":"Ricerche dei follower","queryKey":"follower_searched"}],"tabs":["ALL","CONTENT_GAP","SEARCHES_BY_FOLLOWERS"]},{"channel_key":"TRENDING","name":"Di tendenza","tabDetails":[{"endpoint":"trending","key":"ALL","name":"Tutti","queryKey":"all"},{"endpoint":"trending","key":"FASHION","name":"Moda","queryKey":"Fashion"},{"endpoint":"trending","key":"FOOD","name":"Cibo","queryKey":"Food"}],"tabs":["ALL","FASHION","FOOD"]}],"trendingCategories":["all","Fashion","Food"]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"channels":{"items":{"properties":{"categories":{"items":{"type":"string"},"type":"array"},"channel_key":{"type":"string"},"languages":{"items":{"type":"string"},"type":"array"},"name":{"type":"string"},"tabDetails":{"items":{"properties":{"endpoint":{"type":"string"},"key":{"type":"string"},"name":{"type":"string"},"queryKey":{"type":"string"}},"type":"object"},"type":"array"},"tabs":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"trendingCategories":{"items":{"type":"string"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Reference lists · csi_channels","tags":["reference"],"x-credits":1,"x-mcp-method":"csi_channels","x-mcp-tool":"reference"}},"/v1/reference/csi-languages":{"get":{"description":"This route: language codes for demand_find_topics.\n\nStatic lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields. Example: {\"method\":\"sales_filters\"}.","operationId":"GET_reference_csi_languages","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"languages":[{"id":"ar","name":"العربية"},{"id":"de","name":"Deutsch"},{"id":"en","name":"English"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"languages":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Reference lists · csi_languages","tags":["reference"],"x-credits":1,"x-mcp-method":"csi_languages","x-mcp-tool":"reference"}},"/v1/reference/explore-categories":{"get":{"description":"This route: category ids for video_feed method=explore.\n\nStatic lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields. Example: {\"method\":\"sales_filters\"}.","operationId":"GET_reference_explore_categories","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"categories":[{"id":120,"name":"All"},{"id":119,"name":"Singing \u0026 Dancing"},{"id":104,"name":"Comedy"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"categories":{"items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Reference lists · explore_categories","tags":["reference"],"x-credits":1,"x-mcp-method":"explore_categories","x-mcp-tool":"reference"}},"/v1/reference/live-gifts":{"get":{"description":"This route: LIVE gifts and their coin prices.\n\nStatic lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields. Example: {\"method\":\"sales_filters\"}.","operationId":"GET_reference_live_gifts","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"gifts":[{"coins":1,"combo":true,"id":"1347121","name":"Mirwas Beat"},{"coins":1,"combo":true,"id":"1374221","name":"Eye for an Eye"},{"coins":1,"combo":true,"id":"1167779","name":"Mantap"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"gifts":{"items":{"properties":{"coins":{"type":"integer"},"combo":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Reference lists · live_gifts","tags":["reference"],"x-credits":1,"x-mcp-method":"live_gifts","x-mcp-tool":"reference"}},"/v1/reference/sales-filters":{"get":{"description":"This route: every Shop Analytics filter, its values and sort fields.\n\nStatic lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields. Example: {\"method\":\"sales_filters\"}.","operationId":"GET_reference_sales_filters","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"category":"product_top_selling and creator_top_selling take category (name or id, levels 1-3, up to 5) with or without a keyword; find names with category_trends method=tree.","market":"US by default; region picks any of US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX, PL, IT, NL, IE (call shop_regions for currency, language and tier)","order":"order=desc (default) or asc on the ranking tools; asc lists the lowest first among matching rows.","tools":{"category_trends":"method=list ranks categories by revenue; level keeps one category level.","creator_top_selling":{"filters":[{"argument":"revenue","meaning":"Revenue the creator drove in the market's currency over the window, e.g. \u003e10000.","values":"range: a-b, \u003ca or \u003eb"},{"argument":"followers","meaning":"Followers, e.g. 50000-500000.","values":"range: a-b, \u003ca or \u003eb"},{"argument":"engagement","meaning":"Video engagement rate percent, e.g. \u003e8.","values":"range: a-b, \u003ca or \u003eb"}],"sort":["followers","growth","revenue"]},"live_top_selling":"Top 10 by revenue for the window; no filters or sort.","product_top_selling":{"filters":[{"argument":"revenue","meaning":"Revenue in the market's currency over the window: a-b, \u003ca or \u003eb, e.g. 1000-10000.","values":"range: a-b, \u003ca or \u003eb"},{"argument":"units","meaning":"Units sold over the window, e.g. 500-5000 or \u003e10000.","values":"range: a-b, \u003ca or \u003eb"},{"argument":"revenue_growth","meaning":"Revenue growth vs the previous equal window, percent, e.g. \u003e30.","values":"range: a-b, \u003ca or \u003eb"}],"sort":["creators","growth","price"]},"shop_top_selling":{"filters":[{"argument":"revenue","meaning":"Shop revenue in the market's currency over the window, e.g. \u003e100000.","values":"range: a-b, \u003ca or \u003eb"},{"argument":"revenue_growth","meaning":"Revenue growth percent vs the previous window, e.g. \u003e30.","values":"range: a-b, \u003ca or \u003eb"},{"argument":"price","meaning":"Average selling price in the market's currency, e.g. 20-100.","values":"range: a-b, \u003ca or \u003eb"}],"sort":["growth","revenue","units"]},"video_top_selling":"Top 10 by revenue for the window; no filters or sort."},"window":"7d, 30d, 90d, 180d, 365d, or start/end (YYYY-MM-DD). Data ends about 2 days before today."},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"category":{"type":"string"},"market":{"type":"string"},"order":{"type":"string"},"tools":{"properties":{"category_trends":{"type":"string"},"creator_top_selling":{"properties":{"filters":{"items":{"properties":{"argument":{"type":"string"},"meaning":{"type":"string"},"values":{"type":"string"}},"type":"object"},"type":"array"},"sort":{"items":{"type":"string"},"type":"array"}},"type":"object"},"live_top_selling":{"type":"string"},"product_top_selling":{"properties":{"filters":{"items":{"properties":{"argument":{"type":"string"},"meaning":{"type":"string"},"values":{"type":"string"}},"type":"object"},"type":"array"},"sort":{"items":{"type":"string"},"type":"array"}},"type":"object"},"shop_top_selling":{"properties":{"filters":{"items":{"properties":{"argument":{"type":"string"},"meaning":{"type":"string"},"values":{"type":"string"}},"type":"object"},"type":"array"},"sort":{"items":{"type":"string"},"type":"array"}},"type":"object"},"video_top_selling":{"type":"string"}},"type":"object"},"window":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Reference lists · sales_filters","tags":["reference"],"x-credits":1,"x-mcp-method":"sales_filters","x-mcp-tool":"reference"}},"/v1/search/creators":{"get":{"description":"This route: accounts matching keyword.\n\nSearches TikTok accounts by keyword (name, handle or niche), as TikTok's account search returns them now, with follower bounds, verified-only and sorting applied to the page. Not a sales ranking (use creator_top_selling). Example: {\"keyword\":\"skincare\",\"min_followers\":10000,\"sort\":\"followers\"}.","operationId":"GET_search_creators","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Search phrase, e.g. 'lip oil'.","example":"lip oil","in":"query","name":"keyword","required":true,"schema":{"type":"string"}},{"description":"Results per page. Max 20. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Maximum followers. 0 = none.","in":"query","name":"max_followers","required":false,"schema":{"type":"integer"}},{"description":"Minimum followers. 0 = none.","in":"query","name":"min_followers","required":false,"schema":{"type":"integer"}},{"description":"relevance (default), followers or likes.","in":"query","name":"sort","required":false,"schema":{"enum":["relevance","followers","likes"],"type":"string"}},{"description":"Keep only verified accounts.","in":"query","name":"verified_only","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"creators":[{"followers":54911,"following":28,"handle":"lipoil417","id":"6865315608574854146","likes":472040,"nickname":"ลิปออยฮัปเตงงง(55K)🌷","secUid":"MS4wLjABAAAAIH8mpvc810ovJRZSVLgv-XFx3QLJW0PL5bj4kc-VwbVFEbrMcwtUsMyIk3B8iT9-","url":"https://www.tiktok.com/@lipoil417","verified":true,"videos":186},{"followers":499138,"following":311,"handle":"eb.bahboh","id":"6825796908113150981","likes":18588205,"nickname":"เต๋าชอบทาLip Oil Everyskin","secUid":"MS4wLjABAAAAnM1MVJtXef0fO5ajr4ujQH6M91KOOd8GMKcaE9ed-N-fN10e40IRkPBrLrqslVPC","url":"https://www.tiktok.com/@eb.bahboh","verified":true,"videos":1654},{"followers":642,"following":591,"handle":"mylipoil","id":"6641452638477697025","likes":22168,"nickname":"♡Lip oil♡","secUid":"MS4wLjABAAAAtxW2_Ld0rDOEv11Rz-tr_iMBm2g2_6U7-OtIKrfd_3mInZcy7SoPoHuDj_OIB2Bu","url":"https://www.tiktok.com/@mylipoil","verified":true,"videos":47}],"hasMore":true,"next":"eyJjdXJzb3IiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2MzVFNjRGQ0MzRkM5NTc3RkEzOUQyNCJ9","retrievedCount":3},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2MzVFNjRGQ0MzRkM5NTc3RkEzOUQyNCJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"creators":{"items":{"properties":{"followers":{"type":"integer"},"following":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"likes":{"type":"integer"},"nickname":{"type":"string"},"secUid":{"type":"string"},"url":{"type":"string"},"verified":{"type":"boolean"},"videos":{"type":"integer"}},"type":"object"},"type":"array"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"retrievedCount":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Search TikTok accounts","tags":["creator_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"","x-mcp-tool":"creator_search"}},"/v1/search/hashtags":{"get":{"description":"This route: hashtags matching keyword.\n\nFinds hashtags by keyword, with total views and video counts for each. Pass a hashtag's id to hashtag for its videos and related tags. Example: {\"keyword\":\"fitness\"}.","operationId":"GET_search_hashtags","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Search phrase, e.g. 'lip oil'.","example":"lip oil","in":"query","name":"keyword","required":true,"schema":{"type":"string"}},{"description":"Results per page. Max 50. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"hashtags":[{"id":"19957680","name":"lipoil","url":"https://www.tiktok.com/tag/lipoil","videos":788416,"views":11473297599},{"id":"1643439800933382","name":"lipoils","url":"https://www.tiktok.com/tag/lipoils","videos":77196,"views":1105123774},{"id":"1676866847720454","name":"lipoil💋","url":"https://www.tiktok.com/tag/lipoil💋","videos":649,"views":4702098}],"next":"eyJjdXJzb3IiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2NTVCMzMwODE0MjE0MDBGOTg2ODY0RSJ9"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2NTVCMzMwODE0MjE0MDBGOTg2ODY0RSJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"next":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find hashtags","tags":["hashtag_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"","x-mcp-tool":"hashtag_search"}},"/v1/search/lives":{"get":{"description":"This route: LIVE rooms matching keyword.\n\nFinds TikTok LIVE broadcasts on now by keyword, with viewers and whether the room sells Shop products. Pass a room id to live. Not a sales ranking (use live_top_selling). Example: {\"keyword\":\"skincare\"}.","operationId":"GET_search_lives","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Search phrase, e.g. 'lip oil'.","example":"lip oil","in":"query","name":"keyword","required":true,"schema":{"type":"string"}},{"description":"Results per page. Max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"feedback_type":"live","global_doodle_config":{"disable_inner_flow":true,"feedback_survey":[{"feedback_type":"live","long_stress_info":null,"multiple_choices":[{"key":"Dislike","value":"Dislike"},{"key":"Unrelated content","value":"Unrelated content"},{"key":"Language issues","value":"Language issues"}],"send_us_multiple_choices":null}],"hide_results":false,"hit_dolphin":false,"hit_shark":false,"keyword":"lip oil","new_source":"switch_tab","search_channel":"musically_live","tns_search_result":"Pass"},"guide_search_words":null,"hasMore":false,"rooms":[{"creator":{"handle":"mirthandmayhemapothecary","id":"6674289300136510470","nickname":"Mae✨Mirth \u0026 Mayhem Apothecary✨","secUid":"MS4wLjABAAAAYw1mF-k-heabSeLK8lspoY3Xc00YOLHWLFnZHdFqZPA0SBt7eId4jSd3uIwnk9GR"},"likes":1805,"live":true,"roomId":"7702602665781005070","started":"2026-10-30T23:13:34Z","title":"Lip gloss and jewelry!","url":"https://www.tiktok.com/@mirthandmayhemapothecary/live","viewers":14},{"creator":{"handle":"maknzperfumes","id":"7281875170079638571","nickname":"MAKNZ","secUid":"MS4wLjABAAAAVmdAbRxbNMd8OTpVYAzbGO9Lef-ghmqR6GprCVHaKjRfN3MAbRjnu8xFSb4JgEIm"},"likes":5415,"live":true,"roomId":"7702558024967899918","shopping":true,"started":"2026-10-30T20:20:38Z","title":"OIL BASED BY JASMINE","url":"https://www.tiktok.com/@maknzperfumes/live","viewers":5},{"creator":{"handle":"drixelyyy","id":"6780994045612229637","nickname":"Dri•xely🌺🫧","secUid":"MS4wLjABAAAAcQpHjinDtXzD-DiBVd4vU4uYIUlNk71_TiIWnOeTLksQMxMn3nebNKx5mcrqPuLk"},"likes":7712,"live":true,"roomId":"7702596084547259149","shopping":true,"started":"2026-10-30T22:48:00Z","title":"🚨DIFFUSER OIL RESTOCK 🥰‼️","url":"https://www.tiktok.com/@drixelyyy/live","viewers":6}],"search_id":"u.2026103023270001AF2C7F8351C72F0BE1","version":"v2"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"feedback_type":{"type":"string"},"global_doodle_config":{"properties":{"disable_inner_flow":{"type":"boolean"},"feedback_survey":{"items":{"properties":{"feedback_type":{"type":"string"},"long_stress_info":{"type":"null"},"multiple_choices":{"items":{"properties":{"key":{"type":"string"},"value":{"type":"string"}},"type":"object"},"type":"array"},"send_us_multiple_choices":{"type":"null"}},"type":"object"},"type":"array"},"hide_results":{"type":"boolean"},"hit_dolphin":{"type":"boolean"},"hit_shark":{"type":"boolean"},"keyword":{"type":"string"},"new_source":{"type":"string"},"search_channel":{"type":"string"},"tns_search_result":{"type":"string"}},"type":"object"},"guide_search_words":{"type":"null"},"hasMore":{"type":"boolean"},"rooms":{"items":{"properties":{"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"likes":{"type":"integer"},"live":{"type":"boolean"},"roomId":{"type":"string"},"started":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"viewers":{"type":"integer"}},"type":"object"},"type":"array"},"search_id":{"type":"string"},"version":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Search LIVE now","tags":["live_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"","x-mcp-tool":"live_search"}},"/v1/search/photos":{"get":{"description":"This route: photo carousel posts.\n\nSearches TikTok posts by keyword, as TikTok's own search returns them now: views, likes, comments, shares, saves, creator, hashtags, sound and linked Shop products. Not a sales ranking (use video_top_selling). Example: {\"keyword\":\"home gym\",\"sort\":\"most_liked\",\"date\":\"month\"}.","operationId":"GET_search_photos","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Search phrase, e.g. 'lip oil'.","example":"lip oil","in":"query","name":"keyword","required":true,"schema":{"type":"string"}},{"description":"Results per page. videos and photos max 20, all max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJvZmZzZXQiOjMsInNlYXJjaF9pZCI6InUudy4yMDI2MTAzMDIzMjYyMkJFMkJDQkVDOTVFRTY4MkVEQzJEIn0","search_id":"u.w.20261030232622BE2BCBEC95EE682EDC2D","videos":[{"caption":"What’s your favorite lip oil? Comment below! 👇 💋 Top 10 Lip Oils 🥇 Clarins Lip Comfort Oil * Nourishes \u0026 hydrates * Non-sticky * Glossy finish * Comfortable all-day wear 🥈 Dior Addict Lip Glow Oil * Hydrating * High-shine finish * Color-enhancing * Smooth, non-sticky feel 🥉 NYX Fat …","comments":3,"creator":{"followers":60,"handle":"glow4girlz","id":"7629889741245269006","nickname":"glow4girlz","secUid":"MS4wLjABAAAA6vRpwfgqZVdysM-l_JvHnpTwd_r-2Rita6Gz8hQTozEs1ApCOCVKi8Cy-O33Q7eF"},"hashtags":[{"id":"5391","name":"makeup"},{"id":"44367","name":"top10"},{"id":"19957680","name":"lipoil"}],"id":"7670279717978737933","imageCount":1,"language":"en","likes":314,"photoPost":true,"posted":"2026-08-04T20:43:07Z","saves":171,"shares":35,"sound":{"author":"Doja Cat","id":"6976278887063898114","title":"Woman"},"url":"https://www.tiktok.com/@glow4girlz/photo/7670279717978737933","views":44000},{"caption":"No one talks about these lip oils!! Romand makes such glossy and juicy lippies #romand #kbeauty #lipoil #lipgloss #juicy","comments":18,"creator":{"followers":95300,"handle":"beansforfun","id":"6754991130918142978","nickname":"Jeslyn | Beansforfun","secUid":"MS4wLjABAAAAr3p5L2z_a84fx3Vs8EDWP8rDO7XsoOuyZrt2nrLKEWePYkRuGsOiH9rEKz-9cY4x"},"hashtags":[{"id":"16975188","name":"romand"},{"id":"1589191","name":"kbeauty"},{"id":"19957680","name":"lipoil"}],"id":"7670927766337981704","imageCount":6,"language":"en","likes":2853,"photoPost":true,"posted":"2026-08-06T14:37:37Z","saves":712,"shares":140,"sound":{"author":"m.i.n.d.i07","id":"7545216806445763329","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@beansforfun/photo/7670927766337981704","views":61600},{"caption":"#creatorsearchinsights #lipglossviral #viral #lipgloss","comments":12,"creator":{"followers":659,"handle":"pinkparcell","id":"7505429985601373190","nickname":"Pink parcel 💗","secUid":"MS4wLjABAAAAYsd8sRbLqH8blS5ZJ8BX-gb4v3_tjMTnM3mgyqDEVIubIQNl2i_J73PiAcDTBfrg"},"hashtags":[{"id":"7340824418278440993","name":"creatorsearchinsights"},{"id":"1661882308538374","name":"lipglossviral"},{"id":"20884","name":"viral"}],"id":"7676880875610524948","imageCount":5,"language":"un","likes":190,"photoPost":true,"posted":"2026-08-22T15:38:41Z","saves":47,"shares":47,"sound":{"author":"Veloura","id":"7425224534448966405","original":true,"title":"suara asli - 𝟑𝟎𝟑 𝐍𝐨𝐚.`𖤐"},"url":"https://www.tiktok.com/@pinkparcell/photo/7676880875610524948","views":14400}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjMsInNlYXJjaF9pZCI6InUudy4yMDI2MTAzMDIzMjYyMkJFMkJDQkVDOTVFRTY4MkVEQzJEIn0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"search_id":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"imageCount":{"type":"integer"},"language":{"type":"string"},"likes":{"type":"integer"},"photoPost":{"type":"boolean"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Search TikTok videos · photos","tags":["video_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"photos","x-mcp-tool":"video_search"}},"/v1/search/places":{"get":{"description":"Finds TikTok places (businesses, venues, landmarks) by keyword, each with its poi id, name, category, address, city, country and tagged video count. Pass a poi id to the place tool (method=detail, videos or reviews).","operationId":"GET_search_places","parameters":[{"description":"Places per page.","in":"query","name":"count","required":false,"schema":{"default":10,"type":"integer"}},{"description":"full adds TikTok's raw payload (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Place or business term, e.g. 'coffee shop'.","example":"lip oil","in":"query","name":"keyword","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"places":[{"address":"3939 S Interstate 35, San Marcos, United States","category":"Beauty Salon","country":"US","id":"20319181072627620","lat":29.831224,"lng":-97.983594,"name":"Clarins","url":"https://www.tiktok.com/place/-20319181072627620","videos":1},{"address":"4620 71st St #30, Lubbock, TX 79424, USA","category":"Hair Salon","country":"US","hours":"09:00 - 18:00","id":"21568226335734203","lat":33.529574,"lng":-101.911819,"name":"Glam LAB","tags":["Boho Braids","Braids Specialist","Locks Styling"],"url":"https://www.tiktok.com/place/-21568226335734203","videos":21},{"address":"Vicinale Saguerra 998, 74020 Taranto, Italy","country":"IT","id":"21568226329628837","lat":40.36815,"lng":17.330194,"name":"Imoil","url":"https://www.tiktok.com/place/-21568226329628837"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"places":{"items":{"properties":{"address":{"type":"string"},"category":{"type":"string"},"country":{"type":"string"},"id":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"},"name":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Place / POI search","tags":["place_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil"},"x-mcp-method":"","x-mcp-tool":"place_search"}},"/v1/search/sounds":{"get":{"description":"This route: sounds matching keyword.\n\nFinds TikTok sounds by keyword, or lists TikTok's hot sounds, beats and licensed music. Pass a sound id to sound for its videos. Example: {\"keyword\":\"sped up\"} or {\"method\":\"hot\"}.","operationId":"GET_search_sounds","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=keyword: search phrase.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Results per page. Max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"ad_info":{},"feedback_type":"music","global_doodle_config":{"display_filter_bar":1,"enable_music_mix_rank":1,"feedback_survey":[{"feedback_type":"music","long_stress_info":null,"multiple_choices":[{"key":"Dislike","value":"Dislike"},{"key":"Unrelated result","value":"Unrelated result"},{"key":"No original version","value":"No original version"}],"send_us_multiple_choices":null}],"hide_results":false,"hit_dolphin":false,"hit_shark":false,"keyword":"lip oil","new_source":"normal_search","search_channel":"musically_music","tns_search_result":"Pass"},"hasMore":true,"next":"eyJjdXJzb3IiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2NDdGNjcxQUI5OTlGOTQ1MjRCNzNEQyJ9","qc":"","search_id":"u.20261030232647F671AB999F94524B73DC","sounds":[{"album":"INTRAVENOSA","author":"Mellysa Catty \u0026 xTurbo","durationSec":16,"id":"7551425165536643088","title":"Lip Oil","url":"https://www.tiktok.com/music/-7551425165536643088","videos":2},{"author":"Lipi","commercialUse":true,"durationSec":15,"id":"7379968945522739984","original":true,"title":"original sound - tahaminalipi","url":"https://www.tiktok.com/music/-7379968945522739984","videos":12373},{"album":"Forever with You","author":"SebaLazi","durationSec":60,"id":"7478886011436894225","title":"Lipsi","url":"https://www.tiktok.com/music/-7478886011436894225","videos":676}],"version":"v2"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2NDdGNjcxQUI5OTlGOTQ1MjRCNzNEQyJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"ad_info":{"type":"object"},"feedback_type":{"type":"string"},"global_doodle_config":{"properties":{"display_filter_bar":{"type":"integer"},"enable_music_mix_rank":{"type":"integer"},"feedback_survey":{"items":{"properties":{"feedback_type":{"type":"string"},"long_stress_info":{"type":"null"},"multiple_choices":{"items":{"properties":{"key":{"type":"string"},"value":{"type":"string"}},"type":"object"},"type":"array"},"send_us_multiple_choices":{"type":"null"}},"type":"object"},"type":"array"},"hide_results":{"type":"boolean"},"hit_dolphin":{"type":"boolean"},"hit_shark":{"type":"boolean"},"keyword":{"type":"string"},"new_source":{"type":"string"},"search_channel":{"type":"string"},"tns_search_result":{"type":"string"}},"type":"object"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"qc":{"type":"string"},"search_id":{"type":"string"},"sounds":{"items":{"properties":{"album":{"type":"string"},"author":{"type":"string"},"durationSec":{"type":"integer"},"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"type":"array"},"version":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find sounds · keyword","tags":["sound_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"keyword","x-mcp-tool":"sound_search"}},"/v1/search/top":{"get":{"description":"This route: mixed results (often empty).\n\nSearches TikTok posts by keyword, as TikTok's own search returns them now: views, likes, comments, shares, saves, creator, hashtags, sound and linked Shop products. Not a sales ranking (use video_top_selling). Example: {\"keyword\":\"home gym\",\"sort\":\"most_liked\",\"date\":\"month\"}.","operationId":"GET_search_top","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Search phrase, e.g. 'lip oil'.","example":"lip oil","in":"query","name":"keyword","required":true,"schema":{"type":"string"}},{"description":"Results per page. videos and photos max 20, all max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"ad_info":{},"components":null,"cursor":10,"data":[{"aweme_info":{"caption":"the shiniest lips on the internet  @NOONI #noonipartner    #beauty #glitterlips #lipoil #kbeauty","comments":20,"creator":{"followers":2414965,"handle":"ingaterner","id":"6915470077362865158","nickname":"Inga Terner","secUid":"MS4wLjABAAAAj3-0_ug3CN2zVQW1fOIuVgtFq37iFz2-aQNDN9VLKT0Xa1rcEfAAybaLMhLsXCIu"},"durationSec":18.067,"hashtags":[{"id":"7305074851570516011","name":"noonipartner"},{"id":"5393","name":"beauty"},{"id":"206503","name":"glitterlips"}],"id":"7691522530129022221","language":"en","likes":1049,"posted":"2026-10-01T02:36:03Z","saves":207,"shares":39,"sound":{"author":"JERI","id":"7139362230881094442","original":true,"title":"ariana grande . ill do it"},"url":"https://www.tiktok.com/@ingaterner/video/7691522530129022221","views":22632},"card_profile":{},"doc_id":7691522530129022000,"doc_type":183,"feedback_type":"video","preload_img":{"urls":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d175ab4ba1c1fbe4052c7496d8840d43~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.video_user_cover\u0026dr=9640\u0026idc=useast8\u0026ps=13740610\u0026refresh_token=9de3c320\u0026shcp=34ff8df6\u0026shp=d05b14bd\u0026t=4d5b0474\u0026x-expires=1793487600\u0026x-signat…","https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oACiExyxEG3CJSXBM9GBfBdIOIAiAAuwAJO1IY~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_general.video_cover\u0026dr=9638\u0026idc=useast8\u0026ps=13740610\u0026refresh_token=24cf0b6a\u0026shcp=9b759fb9\u0026shp=c1333099\u0026t=4d5b0474\u0026x-expires=1793422800\u0026x-signatu…"]},"provider_doc_id_str":"7691522530129022221","search_aweme_info":{"has_creation_intention":false},"type":1},{"aweme_info":{"caption":"Look at that shimmer ✨👀 Trying three of the @NOONI Shimmer Lip Oils! The glossy finish + pearly shimmer when it hits the light is SO pretty! Which shade is your favorite? 💕 Find the product link in my bio! 🛍️💋 #makeup #glitterlips #holidaymakeup #glittermakeup #lipoil","comments":5,"creator":{"followers":76430,"handle":"idareen_","id":"7326533081505268742","nickname":"Makeup Tutorials | Reviews","secUid":"MS4wLjABAAAA7HdIDExKBSFp2H-MZCodVA6uWfnp8HCQpm8gawqQ9EPAW5X28Q0Zufzrkc01Nzx1"},"durationSec":30.603,"hashtags":[{"id":"5391","name":"makeup"},{"id":"206503","name":"glitterlips"},{"id":"38970494","name":"holidaymakeup"}],"id":"7699530652789656853","language":"en","likes":194,"place":{"id":"21568298460213102","name":"Toronto"},"posted":"2026-10-22T16:31:26Z","saves":50,"shares":29,"sound":{"author":"Makeup Tutorials | Reviews","id":"7699530698348710662","original":true,"title":"original sound - idareen_"},"url":"https://www.tiktok.com/@idareen_/video/7699530652789656853","views":7573},"card_profile":{},"doc_id":7699530652789657000,"doc_type":183,"feedback_type":"video","preload_img":{"urls":["https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oMjDZD3fA4AIgAlVZH4LISJtEEeenAtaTAGOIG~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_general.video_cover\u0026dr=9638\u0026idc=useast8\u0026ps=13740610\u0026refresh_token=de71ab19\u0026shcp=9b759fb9\u0026shp=c1333099\u0026t=4d5b0474\u0026x-expires=1793422800\u0026x-signature=Qm…","https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/c92773dcaa403c655eee2b06a9f91047~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.video_user_cover\u0026dr=9640\u0026idc=useast8\u0026ps=13740610\u0026refresh_token=acf1db85\u0026shcp=34ff8df6\u0026shp=d05b14bd\u0026t=4d5b0474\u0026x-expires=1793487600\u0026x-signature=…"]},"provider_doc_id_str":"7699530652789656853","search_aweme_info":{"has_creation_intention":false},"type":1},{"aweme_info":{"caption":"The best glow hack is using my @COVERGIRL giant oil stick on my cheeks and lips for the most natural glow and juicy lips ✨✨#covergirlpartner #lipoil #glowymakeup #covergirl #easybreezybeautiful","comments":18,"creator":{"followers":241016,"handle":"dr.reemabassoumi","id":"6784073999514633221","nickname":"Reema Bassoumi","secUid":"MS4wLjABAAAAeLRb7xzOBeIgFxaPZ-ekk6hemAlA1ydV0wRUsDP6R0A_Oz3yGCibAumQoPHmYGiV"},"durationSec":32.767,"hashtags":[{"id":"1656922045513734","name":"covergirlpartner"},{"id":"19957680","name":"lipoil"},{"id":"1596648442656774","name":"glowymakeup"}],"id":"7692913287326878990","language":"en","likes":4906,"posted":"2026-10-04T20:32:42Z","saves":1442,"shares":1141,"sound":{"author":"Reema Bassoumi","id":"7692913303533718286","original":true,"title":"original sound - dr.reemabassoumi"},"url":"https://www.tiktok.com/@dr.reemabassoumi/video/7692913287326878990","views":143651},"card_profile":{},"doc_id":7692913287326879000,"doc_type":183,"feedback_type":"video","preload_img":{"urls":["https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fe5451cffbaee341a0596fcfca62b0f8~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.video_user_cover\u0026dr=9640\u0026idc=useast8\u0026ps=13740610\u0026refresh_token=a945aa25\u0026shcp=34ff8df6\u0026shp=d05b14bd\u0026t=4d5b0474\u0026x-expires=1793487600\u0026x-signat…","https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ogfhDfhoIELkQebIEAVAFEFFIWjWAA9cGHgAAl~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_general.video_cover\u0026dr=9638\u0026idc=useast8\u0026ps=13740610\u0026refresh_token=e5b5b465\u0026shcp=9b759fb9\u0026shp=c1333099\u0026t=4d5b0474\u0026x-expires=1793422800\u0026x-signatu…"]},"provider_doc_id_str":"7692913287326878990","search_aweme_info":{"has_creation_intention":false},"type":1}],"global_doodle_config":{"ab_params":{"user_relation_ship":"1"},"can_pull_refresh":true,"disable_reorder":0,"display_filter_bar":1,"ecom_api_version":"","ecom_search_info":{"query_addr_intent":{"query_addr_intent":false,"query_addr_intent_creator":false,"query_addr_intent_shop":false}},"enable_multi_search":false,"feedback_survey":[{"feedback_type":"activity_banner","long_stress_info":null,"multiple_choices":[{"key":"Unrelated content","value":"Unrelated content"},{"key":"Outdated content","value":"Outdated content"},{"key":"Unhelpful image or caption","value":"Unhelpful image or caption"}],"send_us_multiple_choices":null},{"feedback_type":"activity_match","long_stress_info":null,"multiple_choices":[{"key":"Unrelated content","value":"Unrelated content"},{"key":"Outdated content","value":"Outdated content"},{"key":"Unhelpful match data","value":"Unhelpful match data"}],"send_us_multiple_choices":null},{"feedback_type":"activity_title","long_stress_info":null,"multiple_choices":[{"key":"Unrelated content","value":"Unrelated content"},{"key":"Outdated content","value":"Outdated content"},{"key":"Inappropriate content","value":"Inappropriate content"}],"send_us_multiple_choices":null}],"has_ecom_intent":true,"hide_results":false,"hit_dolphin":false,"hit_shark":false,"keyword":"lip oil","new_source":"recom_search","original_ecom_intent":3,"prefetch_degrade_level":1,"search_channel":"musically_general","search_intent":{},"show_video_research_tab_list":false,"tns_search_result":"Pass"},"has_more":true,"headers":[],"prefer_layout":"double_column","qc":"","result_status":4,"search_id":"u.20261030232623A68179925CD016394128","version":"v1"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"ad_info":{"type":"object"},"components":{"type":"null"},"cursor":{"type":"integer"},"data":{"items":{"properties":{"aweme_info":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"number"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"card_profile":{"type":"object"},"doc_id":{"type":"integer"},"doc_type":{"type":"integer"},"feedback_type":{"type":"string"},"preload_img":{"properties":{"urls":{"items":{"type":"string"},"type":"array"}},"type":"object"},"provider_doc_id_str":{"type":"string"},"search_aweme_info":{"properties":{"has_creation_intention":{"type":"boolean"}},"type":"object"},"type":{"type":"integer"}},"type":"object"},"type":"array"},"global_doodle_config":{"properties":{"ab_params":{"properties":{"user_relation_ship":{"type":"string"}},"type":"object"},"can_pull_refresh":{"type":"boolean"},"disable_reorder":{"type":"integer"},"display_filter_bar":{"type":"integer"},"ecom_api_version":{"type":"string"},"ecom_search_info":{"properties":{"query_addr_intent":{"properties":{"query_addr_intent":{"type":"boolean"},"query_addr_intent_creator":{"type":"boolean"},"query_addr_intent_shop":{"type":"boolean"}},"type":"object"}},"type":"object"},"enable_multi_search":{"type":"boolean"},"feedback_survey":{"items":{"properties":{"feedback_type":{"type":"string"},"long_stress_info":{"type":"null"},"multiple_choices":{"items":{"properties":{"key":{"type":"string"},"value":{"type":"string"}},"type":"object"},"type":"array"},"send_us_multiple_choices":{"type":"null"}},"type":"object"},"type":"array"},"has_ecom_intent":{"type":"boolean"},"hide_results":{"type":"boolean"},"hit_dolphin":{"type":"boolean"},"hit_shark":{"type":"boolean"},"keyword":{"type":"string"},"new_source":{"type":"string"},"original_ecom_intent":{"type":"integer"},"prefetch_degrade_level":{"type":"integer"},"search_channel":{"type":"string"},"search_intent":{"type":"object"},"show_video_research_tab_list":{"type":"boolean"},"tns_search_result":{"type":"string"}},"type":"object"},"has_more":{"type":"boolean"},"headers":{"type":"array"},"prefer_layout":{"type":"string"},"qc":{"type":"string"},"result_status":{"type":"integer"},"search_id":{"type":"string"},"version":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Search TikTok videos · all","tags":["video_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"all","x-mcp-tool":"video_search"}},"/v1/search/videos":{"get":{"description":"This route: video posts.\n\nSearches TikTok posts by keyword, as TikTok's own search returns them now: views, likes, comments, shares, saves, creator, hashtags, sound and linked Shop products. Not a sales ranking (use video_top_selling). Example: {\"keyword\":\"home gym\",\"sort\":\"most_liked\",\"date\":\"month\"}.","operationId":"GET_search_videos","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"method=videos: only posts from this window (default any).","in":"query","name":"date","required":false,"schema":{"enum":["any","day","week","month","half_year"],"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Search phrase, e.g. 'lip oil'.","example":"lip oil","in":"query","name":"keyword","required":true,"schema":{"type":"string"}},{"description":"Results per page. videos and photos max 20, all max 30. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=videos: relevance (default), most_liked or newest.","in":"query","name":"sort","required":false,"schema":{"enum":["relevance","most_liked","newest"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJvZmZzZXQiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2MjBEQTUwODYxOTJERDYwMjNENTg2NSJ9","videos":[{"caption":"the shiniest lips on the internet  @NOONI #noonipartner    #beauty #glitterlips #lipoil #kbeauty","comments":20,"creator":{"followers":2415482,"handle":"ingaterner","id":"6915470077362865158","nickname":"Inga Terner","secUid":"MS4wLjABAAAAj3-0_ug3CN2zVQW1fOIuVgtFq37iFz2-aQNDN9VLKT0Xa1rcEfAAybaLMhLsXCIu"},"durationSec":18.067,"hashtags":[{"id":"7305074851570516011","name":"noonipartner"},{"id":"5393","name":"beauty"},{"id":"206503","name":"glitterlips"}],"id":"7691522530129022221","language":"en","likes":1049,"posted":"2026-10-01T02:36:03Z","saves":207,"shares":39,"sound":{"author":"JERI","id":"7139362230881094442","original":true,"title":"ariana grande . ill do it"},"url":"https://www.tiktok.com/@ingaterner/video/7691522530129022221","views":22632},{"caption":"Fall lip oil check! The color, the shine, the vibes. #FallLipOil #FallMakeup #AutumnBeauty #LipOil #GlossyLips","comments":24,"creator":{"followers":1330988,"handle":"hannah_tyre27","id":"6944438159117157381","nickname":"🩷Hannah Tyre 🩷","secUid":"MS4wLjABAAAAjER9oaswmE4V_19vFf0ZexBBTeyJ9Y7xvNk1Kz8QGq1VWbLuO90e78JG09GnkDty"},"durationSec":51.667,"hashtags":[{"id":"7151573380594925611","name":"falllipoil"},{"id":"739483","name":"fallmakeup"},{"id":"4933088","name":"autumnbeauty"}],"id":"7699874217633828110","language":"en","likes":549,"posted":"2026-10-23T14:45:09Z","saves":30,"shares":22,"sound":{"author":"🩷Hannah Tyre 🩷","id":"7699874343160974094","original":true,"title":"original sound - hannah_tyre27"},"url":"https://www.tiktok.com/@hannah_tyre27/video/7699874217633828110","views":5107},{"caption":"💋 Labios hidratados, brillantes y con efecto juicy ✨💖 ¡Un must-have de e.l.f. que necesitas en tu makeup bag! @e.l.f. Cosmetics  #elfcosmetics #LipOil #TikTokShopFinds #BeautyFinds","comments":7,"creator":{"followers":1702,"handle":"ashleysdiary.23","id":"6803053233713382406","nickname":"ashleysdiary.23","secUid":"MS4wLjABAAAAuyCq8DeJjMA6wrlhd2TZ2x3sPlA1W88B0oEG9C4GtKav_zxam7uVz1qlHN-UgJai"},"durationSec":18.167,"hashtags":[{"id":"3745016","name":"elfcosmetics"},{"id":"19957680","name":"lipoil"},{"id":"7062156700811264026","name":"tiktokshopfinds"}],"id":"7701578410455272734","language":"es","likes":22,"posted":"2026-10-28T15:30:00Z","products":[{"id":"1731834431818338595","name":"e.l.f Lip Oil","sellerId":"7494913857786775843","title":"e.l.f. Glow Reviver Plumping Lip Oil, Ultra-Glossy Nourishing Lipgloss with Cooling Tingle \u0026 Fresh Minty Scent for Plumped-Up Pout 7.6mL"}],"saves":4,"shares":0,"sound":{"author":"Muspace Lofi","id":"7142926872781817858","title":"Natural Emotions"},"url":"https://www.tiktok.com/@ashleysdiary.23/video/7701578410455272734","views":433}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjMsInNlYXJjaF9pZCI6InUuMjAyNjEwMzAyMzI2MjBEQTUwODYxOTJERDYwMjNENTg2NSJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"number"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Search TikTok videos · videos","tags":["video_search"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":"3"},"x-mcp-method":"videos","x-mcp-tool":"video_search"}},"/v1/searches":{"get":{"description":"This route: topics matching keyword.\n\nFinds what people search on TikTok (Creator Search Insights). Each topic has queryId, searchVolume (TikTok's 7-day popularity figure, never a monthly count), videoCount (0 = content gap) and a daily trend. Use for demand, content gaps and trend research. Pass a topic's queryId to demand_topic for charts, audience and related searches. Example: {\"keyword\":\"protein snacks\"} or {\"method\":\"feed\",\"channel\":\"content_gap\"}.","operationId":"GET_searches","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=search: phrase to match, e.g. 'bicep workouts'.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"method=search or feed: language code from reference method=csi_languages, e.g. en.","in":"query","name":"language","required":false,"schema":{"type":"string"}},{"description":"Results per page. Max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"channel":"search","hasMore":true,"next":"eyJvZmZzZXQiOjN9","tab":"SEARCH","topics":[{"category":"Fashion \u003e Fashion Tutorials","popularity":77,"queryId":"7661799877281595413","queryText":"what to look for in a lip oil","searchVolume":384507,"trend7d":[286756,201899,179210],"videoCount":0},{"category":"Fashion \u003e Fashion Products \u003e Beauty and Skin Care Products \u003e Beauty Products","popularity":72,"queryId":"41561603","queryText":"Best lip oil","searchVolume":189105,"trend7d":[185907,210094,137831],"videoCount":1113},{"category":"Fashion \u003e Fashion Products \u003e Beauty and Skin Care Products \u003e Beauty Products","popularity":40,"queryId":"7411340654124498950","queryText":"lip oils for lips","searchVolume":3799,"trend7d":[4099,3499,2999],"videoCount":1168}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"channel":{"type":"string"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"tab":{"type":"string"},"topics":{"items":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"},"queryId":{"type":"string"},"queryText":{"type":"string"},"searchVolume":{"type":"integer"},"trend7d":{"items":{"type":"integer"},"type":"array"},"videoCount":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find TikTok search topics · search","tags":["demand_find_topics"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"search","x-mcp-tool":"demand_find_topics"}},"/v1/searches/feed":{"get":{"description":"This route: a ready-made list (channel).\n\nFinds what people search on TikTok (Creator Search Insights). Each topic has queryId, searchVolume (TikTok's 7-day popularity figure, never a monthly count), videoCount (0 = content gap) and a daily trend. Use for demand, content gaps and trend research. Pass a topic's queryId to demand_topic for charts, audience and related searches. Example: {\"keyword\":\"protein snacks\"} or {\"method\":\"feed\",\"channel\":\"content_gap\"}.","operationId":"GET_searches_feed","parameters":[{"description":"method=feed: which list. suggested, content_gap (high demand, few videos), or a category.","in":"query","name":"channel","required":false,"schema":{"enum":["suggested","content_gap","lifestyle","fashion","food","sports","tourism","gaming","science"],"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=search or feed: language code from reference method=csi_languages, e.g. en.","in":"query","name":"language","required":false,"schema":{"type":"string"}},{"description":"Results per page. Max 20. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJvZmZzZXQiOjN9","tab":"ALL","topics":[{"category":"TikTok's Featured Content \u003e Others TikTok and Video Contents","popularity":2,"queryId":"7637721127158022164","queryText":"views and likes","searchVolume":99,"trend7d":[99,299,99],"videoCount":194769},{"category":"Local Life \u003e Leisure and Entertainment \u003e Other Leisure and Entertainment Venues","popularity":93,"queryId":"7693004027847507989","queryText":"lucki complex con","searchVolume":34704706,"trend7d":[0,0,0],"videoCount":228448},{"category":"TikTok's Featured Content \u003e Stories/Posting Captions","popularity":72,"queryId":"7478520405142011910","queryText":"#relate","searchVolume":180718,"trend7d":[3000,700,54105],"videoCount":166276}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"tab":{"type":"string"},"topics":{"items":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"},"queryId":{"type":"string"},"queryText":{"type":"string"},"searchVolume":{"type":"integer"},"trend7d":{"items":{"type":"integer"},"type":"array"},"videoCount":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find TikTok search topics · feed","tags":["demand_find_topics"],"x-credits":1,"x-example-params":{"limit":"3"},"x-mcp-method":"feed","x-mcp-tool":"demand_find_topics"}},"/v1/searches/trending":{"get":{"description":"This route: trending searches, optionally by category.\n\nFinds what people search on TikTok (Creator Search Insights). Each topic has queryId, searchVolume (TikTok's 7-day popularity figure, never a monthly count), videoCount (0 = content gap) and a daily trend. Use for demand, content gaps and trend research. Pass a topic's queryId to demand_topic for charts, audience and related searches. Example: {\"keyword\":\"protein snacks\"} or {\"method\":\"feed\",\"channel\":\"content_gap\"}.","operationId":"GET_searches_trending","parameters":[{"description":"method=trending: category tab (default all).","in":"query","name":"category","required":false,"schema":{"enum":["all","Fashion","Food","Sports","Tourism","Gaming","Science"],"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. Max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"channel":"trending","hasMore":true,"next":"eyJvZmZzZXQiOjN9","tab":"all","topics":[{"category":"Sports \u003e Physical Sports \u003e Sports News \u003e Other Sports News","popularity":93,"queryId":"7701568755255476244","queryText":"gabriel penalty miss ballon dor","searchVolume":33137737,"trend7d":[0,0,0],"videoCount":0},{"category":"Entertainment \u003e Celebrity Entertainment \u003e Celebrity Gossips \u003e Celebrity Gossip News","popularity":92,"queryId":"7690715705234161684","queryText":"taylor swift weddings photos","searchVolume":25630078,"trend7d":[1692253,593303,222388],"videoCount":100},{"category":"Sports \u003e Physical Sports \u003e Sports Competitions \u003e Ball Games","popularity":92,"queryId":"7687094461397991444","queryText":"arsenal vs fleetwood","searchVolume":23658364,"trend7d":[300,300,100],"videoCount":0}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"channel":{"type":"string"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"tab":{"type":"string"},"topics":{"items":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"},"queryId":{"type":"string"},"queryText":{"type":"string"},"searchVolume":{"type":"integer"},"trend7d":{"items":{"type":"integer"},"type":"array"},"videoCount":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find TikTok search topics · trending","tags":["demand_find_topics"],"x-credits":1,"x-example-params":{"limit":3},"x-mcp-method":"trending","x-mcp-tool":"demand_find_topics"}},"/v1/searches/{id}":{"get":{"description":"This route: searchVolume, trend, category, top countries.\n\nEverything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos. Popularity values are TikTok's readings: never add days together or call them monthly searches. Example: {\"id\":\"7261...\",\"method\":\"popularity\",\"days\":\"180\",\"countries\":[\"US\"]}.","operationId":"GET_searches_id","parameters":[{"description":"queryId from demand_find_topics. Not a video id or keyword.","example":"7637721127158022164","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"topCountries":[{"country_code":"PH","country_name":"Philippines"},{"country_code":"ID","country_name":"Indonesia"},{"country_code":"NG","country_name":"Nigeria"}],"topic":{"category":"TikTok's Featured Content \u003e Others TikTok and Video Contents","popularity":2,"queryId":"7637721127158022164","queryText":"views and likes","searchVolume":99,"trend7d":[99,299,99],"videoCount":194769},"usesInsightsVideoEndpoint":false},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"topCountries":{"items":{"properties":{"country_code":{"type":"string"},"country_name":{"type":"string"}},"type":"object"},"type":"array"},"topic":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"},"queryId":{"type":"string"},"queryText":{"type":"string"},"searchVolume":{"type":"integer"},"trend7d":{"items":{"type":"integer"},"type":"array"},"videoCount":{"type":"integer"}},"type":"object"},"usesInsightsVideoEndpoint":{"type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok search topic · detail","tags":["demand_topic"],"x-credits":1,"x-example-params":{"id":"7637721127158022164"},"x-mcp-method":"detail","x-mcp-tool":"demand_topic"}},"/v1/searches/{id}/audience":{"get":{"description":"This route: age, gender and location of searchers.\n\nEverything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos. Popularity values are TikTok's readings: never add days together or call them monthly searches. Example: {\"id\":\"7261...\",\"method\":\"popularity\",\"days\":\"180\",\"countries\":[\"US\"]}.","operationId":"GET_searches_id_audience","parameters":[{"description":"queryId from demand_find_topics. Not a video id or keyword.","example":"7637721127158022164","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"method=popularity or audience: window in days (default 30).","in":"query","name":"days","required":false,"schema":{"enum":["7","30","60","180"],"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"age":[{"category":"total","popularity":96667},{"category":"25-34","popularity":32190},{"category":"18-24","popularity":26891}],"gender":[{"category":"total","popularity":96669},{"category":"unknown","popularity":50284},{"category":"male","popularity":24492}],"location":[{"category":"total","popularity":96586},{"category":"Indonesia","popularity":12896},{"category":"Pakistan","popularity":10696}],"summary":{"age":"25-34","gender":"unknown","location":"Indonesia"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"age":{"items":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"}},"type":"object"},"type":"array"},"gender":{"items":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"}},"type":"object"},"type":"array"},"location":{"items":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"}},"type":"object"},"type":"array"},"summary":{"properties":{"age":{"type":"string"},"gender":{"type":"string"},"location":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok search topic · audience","tags":["demand_topic"],"x-credits":1,"x-example-params":{"id":"7637721127158022164"},"x-mcp-method":"audience","x-mcp-tool":"demand_topic"}},"/v1/searches/{id}/guidance":{"get":{"description":"This route: TikTok's suggested hooks, hashtags and outlines (often unavailable).\n\nEverything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos. Popularity values are TikTok's readings: never add days together or call them monthly searches. Example: {\"id\":\"7261...\",\"method\":\"popularity\",\"days\":\"180\",\"countries\":[\"US\"]}.","operationId":"GET_searches_id_guidance","parameters":[{"description":"queryId from demand_find_topics. Not a video id or keyword.","example":"7637721127158022164","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"available":false,"message":"TikTok reports that content guidance is not generated for this CSI topic yet. No guidance is available in this response."},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"available":{"type":"boolean"},"message":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok search topic · guidance","tags":["demand_topic"],"x-credits":1,"x-example-params":{"id":"7637721127158022164"},"x-mcp-method":"guidance","x-mcp-tool":"demand_topic"}},"/v1/searches/{id}/popularity":{"get":{"description":"This route: daily popularity chart, worldwide or per country.\n\nEverything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos. Popularity values are TikTok's readings: never add days together or call them monthly searches. Example: {\"id\":\"7261...\",\"method\":\"popularity\",\"days\":\"180\",\"countries\":[\"US\"]}.","operationId":"GET_searches_id_popularity","parameters":[{"description":"queryId from demand_find_topics. Not a video id or keyword.","example":"7637721127158022164","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"method=popularity: country codes to break out, e.g. [\"US\",\"GB\"]. Omit for worldwide.","in":"query","name":"countries","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"method=popularity or audience: window in days (default 30).","in":"query","name":"days","required":false,"schema":{"enum":["7","30","60","180"],"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"series":[{"country":"global","points":[{"date":"2026-09-30","popularity":1481},{"date":"2026-10-01","popularity":1093},{"date":"2026-10-02","popularity":701}]}],"windowDays":30},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"series":{"items":{"properties":{"country":{"type":"string"},"points":{"items":{"properties":{"date":{"type":"string"},"popularity":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"windowDays":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok search topic · popularity","tags":["demand_topic"],"x-credits":1,"x-example-params":{"id":"7637721127158022164"},"x-mcp-method":"popularity","x-mcp-tool":"demand_topic"}},"/v1/searches/{id}/related":{"get":{"description":"This route: related searches with their searchVolume.\n\nEverything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos. Popularity values are TikTok's readings: never add days together or call them monthly searches. Example: {\"id\":\"7261...\",\"method\":\"popularity\",\"days\":\"180\",\"countries\":[\"US\"]}.","operationId":"GET_searches_id_related","parameters":[{"description":"queryId from demand_find_topics. Not a video id or keyword.","example":"7637721127158022164","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. method=related max 20; method=videos max 20. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJvZmZzZXQiOjN9","topics":[{"category":"Fashion \u003e Fashion Tutorials \u003e Beauty and Skin Care Tutorials \u003e Beauty Tutorials","popularity":4,"queryId":"7482230116668489734","queryText":"Make. Up","searchVolume":199,"trend7d":[0,199,99],"videoCount":8549},{"category":"Science and Technology \u003e Internet \u003e Internet Entrepreneurship Knowledge \u003e Self-Media Operation Knowledge","popularity":72,"queryId":"7417365957699534853","queryText":"More likes","searchVolume":181454,"trend7d":[124737,176552,44413],"videoCount":408803},{"category":"Science and Technology \u003e Internet \u003e Internet Entrepreneurship Knowledge \u003e Self-Media Operation Knowledge","popularity":65,"queryId":"7411340955263123461","queryText":"more views","searchVolume":50974,"trend7d":[121239,2898,12693],"videoCount":29439}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"topics":{"items":{"properties":{"category":{"type":"string"},"popularity":{"type":"integer"},"queryId":{"type":"string"},"queryText":{"type":"string"},"searchVolume":{"type":"integer"},"trend7d":{"items":{"type":"integer"},"type":"array"},"videoCount":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok search topic · related","tags":["demand_topic"],"x-credits":1,"x-example-params":{"id":"7637721127158022164","limit":3},"x-mcp-method":"related","x-mcp-tool":"demand_topic"}},"/v1/searches/{id}/related-queries":{"get":{"description":"This route: follow-up searches TikTok links to it.\n\nEverything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos. Popularity values are TikTok's readings: never add days together or call them monthly searches. Example: {\"id\":\"7261...\",\"method\":\"popularity\",\"days\":\"180\",\"countries\":[\"US\"]}.","operationId":"GET_searches_id_related_queries","parameters":[{"description":"queryId from demand_find_topics. Not a video id or keyword.","example":"7637721127158022164","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"queries":[]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"queries":{"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok search topic · related_queries","tags":["demand_topic"],"x-credits":1,"x-example-params":{"id":"7637721127158022164"},"x-mcp-method":"related_queries","x-mcp-tool":"demand_topic"}},"/v1/searches/{id}/videos":{"get":{"description":"This route: videos TikTok shows for the topic.\n\nEverything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos. Popularity values are TikTok's readings: never add days together or call them monthly searches. Example: {\"id\":\"7261...\",\"method\":\"popularity\",\"days\":\"180\",\"countries\":[\"US\"]}.","operationId":"GET_searches_id_videos","parameters":[{"description":"queryId from demand_find_topics. Not a video id or keyword.","example":"7637721127158022164","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. method=related max 20; method=videos max 20. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJvZmZzZXQiOjN9","topicQueryId":"7637721127158022164","topicQueryText":"views and likes","videos":[{"caption":"going viral does NOT have to be super complicated!! #iwanttogoviral #howtogoviralontiktok #howtogoviraltips #tiktokgrowth","comments":55778,"creator":{"followers":18459,"handle":"thelifeofjftb","id":"6895909988976395270","nickname":"jenny","secUid":"MS4wLjABAAAAdhjwJHeb-b3JtDSrR-E8hiKgVLnfHukcHXlpylkukO23nDO8Pgib43DTfy9kayiV"},"durationSec":89.634,"hashtags":[{"id":"85581100","name":"iwanttogoviral"},{"id":"1645041228246018","name":"howtogoviralontiktok"},{"id":"1661640432713733","name":"howtogoviraltips"}],"id":"7516402158825196846","language":"en","likes":200636,"posted":"2025-06-16T04:39:53Z","saves":78023,"shares":75002,"sound":{"author":"jenny","id":"7516402224461892395","original":true,"title":"original sound - thelifeofjftb"},"url":"https://www.tiktok.com/@thelifeofjftb/video/7516402158825196846","views":2086466},{"caption":"The views may be low but unfortunately I’ve already decided I’m famous 😭😂 #TikTokHumor #SmallCreator #MainCharacterEnergy #ForYou #KeepPosting","comments":8422,"creator":{"followers":2868,"handle":"thehouseofsamuel","id":"7605020458355196941","nickname":"The House Of Samuel","secUid":"MS4wLjABAAAAoJkre_H8s5vnyPV8BRX1hTk1-vrY-VkKYFvBTKCAh3Q2vlpwN80nZL0hHlhtldNA"},"durationSec":6.547,"hashtags":[{"id":"1589764631152642","name":"tiktokhumor"},{"id":"1609436969656325","name":"smallcreator"},{"id":"1665817412595717","name":"maincharacterenergy"}],"id":"7693916067256749343","language":"en","likes":157523,"posted":"2026-10-07T13:24:33Z","saves":22839,"shares":8585,"sound":{"author":"AngieBLoveee🇺🇸","id":"7414631646038625066","original":true,"title":"Imma keep posting"},"url":"https://www.tiktok.com/@thehouseofsamuel/video/7693916067256749343","views":1088039},{"caption":"Here’s how to use the new algorithm to get more likes and views on your posts! #creatorsearchinsights  #howtogoviral","comments":283,"creator":{"followers":154056,"handle":"beckett_cj","id":"7471419225988236334","nickname":"Beckett CJ","secUid":"MS4wLjABAAAAwnFwtUWXMkbHwZB7aKcCFKjdg6eGpv7h3mrjqad3HMrtjm2zXL0DZ4IHUB0cXWLp"},"durationSec":78.668,"hashtags":[{"id":"7340824418278440993","name":"creatorsearchinsights"},{"id":"1620762388052997","name":"howtogoviral"}],"id":"7623207520521194765","language":"en","likes":2068,"posted":"2026-03-31T00:18:50Z","saves":979,"shares":332,"sound":{"author":"Beckett CJ","id":"7623207565551209229","original":true,"title":"original sound - beckett_cj"},"url":"https://www.tiktok.com/@beckett_cj/video/7623207520521194765","views":32180}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"topicQueryId":{"type":"string"},"topicQueryText":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"number"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok search topic · videos","tags":["demand_topic"],"x-credits":1,"x-example-params":{"id":"7637721127158022164","limit":"3"},"x-mcp-method":"videos","x-mcp-tool":"demand_topic"}},"/v1/shops/top":{"get":{"description":"This route: shops ranked by sales.\n\n[Shop Analytics] TikTok Shop sellers ranked by estimated sales over a date range: revenue, units, growth, average price, and revenue split across own accounts, affiliates and the mall. keyword = a shop or brand name, matched loosely, e.g. 'medicube'; not a product type. For the shops behind a product type or category, rank products with product_top_selling, then product method=page on the top items gives their sellerId. Without a keyword: the top 10 shops for the most recent days (about 6). type=brands lists the top 10 brands. No category scope for shops. Up to 100 rows per page with cursor paging, about 500 rows per keyword. sort: revenue, units or growth; order=asc lists lowest first. Filters: revenue, growth, price, revenue source, seller type. region picks the market (default US). Examples: {\"keyword\":\"medicube\",\"window\":\"90d\"}, {\"type\":\"brands\",\"region\":\"GB\"}.","operationId":"GET_shops_top","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"A shop or brand NAME, matched loosely against shop names, e.g. 'medicube'. It does not match product types: 'skincare' finds shops with that word in their name. For the shops behind a product type or category, rank products with product_top_selling (category or a product keyword), call product method=page on the top items for their sellerId, then use shop or call this tool with the brand names found. If keyword is omitted, the result is the top 10 shops for the most recent days (about 6), whatever window is set: pass a shop or brand name when the user wants more than 10 rows or a specific window.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Results per page. Max 100 per page; pass next as cursor for the following page. Up to about 500 rows per keyword. Without a keyword: 10 rows. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"desc (default, highest first) or asc (lowest first among the matching rows; pair it with a revenue or units filter to skip dead listings). Applies with a keyword.","in":"query","name":"order","required":false,"schema":{"enum":["desc","asc"],"type":"string"}},{"description":"Filter. Average selling price in the market's currency, e.g. 20-100.","in":"query","name":"price","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Filter. Shop revenue in the market's currency over the window, e.g. \u003e100000.","in":"query","name":"revenue","required":false,"schema":{"type":"string"}},{"description":"Filter. Revenue growth percent vs the previous window, e.g. \u003e30.","in":"query","name":"revenue_growth","required":false,"schema":{"type":"string"}},{"description":"Filter. Main revenue source: own accounts, affiliates, or the mall.","in":"query","name":"revenue_source","required":false,"schema":{"enum":["SELF_ACCOUNTS","AFFILIATE","SHOPPING_MALL"],"type":"string"}},{"description":"Filter. BRAND or RETAILER.","in":"query","name":"seller_type","required":false,"schema":{"enum":["BRAND","RETAILER"],"type":"string"}},{"description":"Ranking metric: growth, revenue, units. Default revenue. growth favours brand-new items (shown as \u003e999.9%); pair it with a revenue or units filter. Applies with a keyword.","in":"query","name":"sort","required":false,"schema":{"enum":["growth","revenue","units"],"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"shops (default) or brands (the top 10 brands for the most recent days; keyword, filters and sort do not apply).","in":"query","name":"type","required":false,"schema":{"enum":["shops","brands"],"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":3,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"items":[{"affiliate_revenue":"$192.14k","id":"7495499730147969966","is_full_service":0,"live_revenue":"$38.81k","main_category":"{\"pri_main_category\":[\"601450\"],\"sec_main_category\":[\"601450-856208\"],\"ter_main_category\":[\"601450-856208-856080\"]}","name":"Eternal Perfume Oils","region":"US","revenue":"$225.43k","revenue_grouping_rate":"7.3%","revenue_trend":[6719.6,6453.8,5580.2],"sale":4036,"self_promotion_revenue":"$626.06","seller_type":"BRAND","shopping_mall_revenue":"$32.66k","showcase_revenue":"$39.67k","total":500,"unit_price":"$55.85","video_revenue":"$146.95k"},{"affiliate_revenue":"$32.13k","id":"7495638404827024204","is_full_service":0,"live_revenue":"$13.74k","main_category":"{\"pri_main_category\":[\"601450\"],\"sec_main_category\":[\"601450-848648\"],\"ter_main_category\":[\"601450-848648-601534\"]}","name":"The Lip Bar","region":"US","revenue":"$45.24k","revenue_grouping_rate":"-18.3%","revenue_trend":[690,1138,1264],"sale":2784,"self_promotion_revenue":"$8.10k","seller_type":"BRAND","shopping_mall_revenue":"$5.02k","showcase_revenue":"$7.76k","total":500,"unit_price":"$16.25","video_revenue":"$23.73k"},{"affiliate_revenue":"$13.63k","id":"8651629413806347145","is_full_service":1,"live_revenue":"$2.46k","main_category":"{\"pri_main_category\":[\"601152\"],\"sec_main_category\":[\"601152-842888\"],\"ter_main_category\":[\"601152-842888-601262\"]}","name":"KISSLIP","region":"US","revenue":"$40.99k","revenue_grouping_rate":"8.8%","revenue_trend":[685.4420000000001,828.409,1040.042],"sale":3185,"self_promotion_revenue":"$1.88k","seller_type":"RETAILER","shopping_mall_revenue":"$25.48k","showcase_revenue":"$34.26k","total":500,"unit_price":"$12.87","video_revenue":"$4.27k"}],"keyword":"lip oil","market":"US","next":"eyJwYWdlIjoyLCJzaXplIjozfQ","notes":["Market US (United States): amounts are in USD."],"see_also":"Pass a row's id (sellerId) to shop: method=sales, trend, products, creators, or store for the live storefront.","sortedBy":"revenue","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totalMatched":500,"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjozfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"items":{"items":{"properties":{"affiliate_revenue":{"type":"string"},"id":{"type":"string"},"is_full_service":{"type":"integer"},"live_revenue":{"type":"string"},"main_category":{"type":"string"},"name":{"type":"string"},"region":{"type":"string"},"revenue":{"type":"string"},"revenue_grouping_rate":{"type":"string"},"revenue_trend":{"items":{"type":"number"},"type":"array"},"sale":{"type":"integer"},"self_promotion_revenue":{"type":"string"},"seller_type":{"type":"string"},"shopping_mall_revenue":{"type":"string"},"showcase_revenue":{"type":"string"},"total":{"type":"integer"},"unit_price":{"type":"string"},"video_revenue":{"type":"string"}},"type":"object"},"type":"array"},"keyword":{"type":"string"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"type":"string"},"sortedBy":{"type":"string"},"source":{"type":"string"},"totalMatched":{"type":"integer"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Top-selling TikTok Shop sellers","tags":["shop_top_selling"],"x-credits":1,"x-example-params":{"keyword":"lip oil","limit":3},"x-mcp-method":"","x-mcp-tool":"shop_top_selling"}},"/v1/shops/{id}":{"get":{"description":"This route: live storefront: rating, sold, followers, products.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=store: store slug if known; looked up when omitted.","in":"query","name":"slug","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJzZWFyY2hfcGFyYW1zIjoiMjBfV3prMU16TXNOall3TURBd01EQXNNVGMxTlRFeU1EVXdPRGMxTml3aU1UY3pNVFl4TWpVNU5UVTVOekU0TlRjek9DSmQifQ","page":"store","products":[{"brand":"Truly Beauty","currency":"USD","id":"1729430515554816714","price":18,"rating":4.2,"reviews":25004,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":219142,"title":"Unicorn Fruit Brightening and Smoothing Deodorant – Aluminum-Free, Fights Odor-Causing Bacteria with Papaya Enzymes \u0026 Mango Butter – Helps Fade Dark Underarm Discoloration – Removes Impurities \u0026 Dead Skin – Sweet Cotton Candy Scent","url":"https://shop.tiktok.com/us/pdp/deodorant-truly-beauty-unicorn-fruit-cotton-candy-scent-for-bright-skin/1729430515554816714"},{"brand":"Truly Beauty","currency":"USD","discount":"52%","id":"1731896769144001226","originalPrice":29,"price":13.92,"rating":4.5,"reviews":14795,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":153731,"title":"Hydrating Lip Gloss - High Shine \u0026 Tinted, Infused with Hyaluronic Acid, Jojoba Oil \u0026 Shea Butter","url":"https://shop.tiktok.com/us/pdp/hydrating-lip-gloss-high-shine-tinted-hyaluronic-acid/1731896769144001226"},{"brand":"Truly Beauty","currency":"USD","id":"1729445990437982922","price":33,"rating":4.5,"reviews":16603,"sellerId":"7495153913553128138","shop":"Truly Beauty","sold":150492,"title":"Soft Serve After Shave Oil – Soothes Razor Burn and Redness with Peptides \u0026 Hyaluronic Acid – Increases Collagen Production – Prevents Ingrowns and Brightens Uneven Skin Tone for Smoother Legs, Underarms \u0026 Pubic Area – Strawberry Vanilla Scent","url":"https://shop.tiktok.com/us/pdp/after-shave-oil-by-truly-beauty-soft-serve-strawberry-vanilla-scent/1729445990437982922"}],"shop":{"name":"Truly Beauty","sellerId":"7495153913553128138"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJzZWFyY2hfcGFyYW1zIjoiMjBfV3prMU16TXNOall3TURBd01EQXNNVGMxTlRFeU1EVXdPRGMxTml3aU1UY3pNVFl4TWpVNU5UVTVOekU0TlRjek9DSmQifQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"page":{"type":"string"},"products":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"id":{"type":"string"},"price":{"type":"integer"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"shop":{"properties":{"name":{"type":"string"},"sellerId":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · store","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"store","x-mcp-tool":"shop"}},"/v1/shops/{id}/affiliate-videos":{"get":{"description":"This route: daily count of new videos affiliates posted for the shop, with a summary.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_affiliate_videos","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"dataEnd":"2026-10-28","id":"7495153913553128138","market":"US","notes":["Market US (United States)."],"series":[{"day":"2026-09-29","newVideos":522},{"day":"2026-09-30","newVideos":873},{"day":"2026-10-01","newVideos":825}],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","summary":{"averagePerDay":711.1,"days":30,"last7Days":4960,"peak":{"day":"2026-10-02","value":906},"previous7Days":4316,"total":21333,"unit":"new affiliate videos"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"series":{"items":{"properties":{"day":{"type":"string"},"newVideos":{"type":"integer"}},"type":"object"},"type":"array"},"source":{"type":"string"},"summary":{"properties":{"averagePerDay":{"type":"number"},"days":{"type":"integer"},"last7Days":{"type":"integer"},"peak":{"properties":{"day":{"type":"string"},"value":{"type":"integer"}},"type":"object"},"previous7Days":{"type":"integer"},"total":{"type":"integer"},"unit":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · affiliate_videos","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"affiliate_videos","x-mcp-tool":"shop"}},"/v1/shops/{id}/creators":{"get":{"description":"This route: affiliate creators selling for it, with revenue.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_creators","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":20,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"id":"7495153913553128138","items":[{"belonged_seller_id":"","creatorDebut":"2025-06-14","creator_type":"INDEPENDENT","followers":37000,"handle":"johatobon3","id":"7098788832553174058","live_count":0,"live_revenue":"$0.00","nickname":"Johana Tobon","product_count":7,"revenue":"$107.74k","sale":6040,"sales_volumn":6040,"signature":"Beauty • Health Creator \n📈 +1.2M Lifetime GMV \n\n\nCollabs: Johanatobon1@hotmail.com","unit_price":17.84,"video_count":83,"video_revenue":"$107.74k"},{"belonged_seller_id":"","creatorDebut":"2024-10-01","creator_type":"INDEPENDENT","followers":15800,"handle":"petitetiramisu","id":"6980982804826375173","live_count":0,"live_revenue":"$0.00","nickname":"petitetiramisu","product_count":1,"revenue":"$62.20k","sale":1885,"sales_volumn":1885,"signature":"🎀PERFUME|MAKEUP|FASHION🎀\n💌 Glowgirlbeautylounge@gmail.com","unit_price":33,"video_count":6,"video_revenue":"$62.20k"},{"belonged_seller_id":"7495466366830020858","creatorDebut":"2021-10-19","creator_type":"INDEPENDENT","followers":23600,"handle":"therealsiahhh","id":"6790832707742417925","live_count":0,"live_revenue":"$0.00","nickname":"Shopping is my therapy","product_count":1,"revenue":"$58.12k","sale":7265,"sales_volumn":7265,"signature":"Email -therealsiahhh47@gmail.com  🥰 HERE TO HELP YOU FIND TRENDING USEFUL PRODUCTS 🫣","unit_price":8,"video_count":176,"video_revenue":"$58.12k"}],"market":"US","next":"eyJwYWdlIjoyLCJzaXplIjoyMH0","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjoyMH0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"belonged_seller_id":{"type":"string"},"creatorDebut":{"type":"string"},"creator_type":{"type":"string"},"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"live_count":{"type":"integer"},"live_revenue":{"type":"string"},"nickname":{"type":"string"},"product_count":{"type":"integer"},"revenue":{"type":"string"},"sale":{"type":"integer"},"sales_volumn":{"type":"integer"},"signature":{"type":"string"},"unit_price":{"type":"number"},"video_count":{"type":"integer"},"video_revenue":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · creators","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"creators","x-mcp-tool":"shop"}},"/v1/shops/{id}/new-affiliates":{"get":{"description":"This route: daily count of new affiliates who started promoting the shop, with a summary.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_new_affiliates","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"dataEnd":"2026-10-28","id":"7495153913553128138","market":"US","notes":["Market US (United States)."],"series":[{"day":"2026-09-29","newAffiliates":885},{"day":"2026-09-30","newAffiliates":1436},{"day":"2026-10-01","newAffiliates":1365}],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","summary":{"averagePerDay":1255,"days":30,"last7Days":8881,"peak":{"day":"2026-09-30","value":1436},"previous7Days":8474,"total":37651,"unit":"new affiliates"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"series":{"items":{"properties":{"day":{"type":"string"},"newAffiliates":{"type":"integer"}},"type":"object"},"type":"array"},"source":{"type":"string"},"summary":{"properties":{"averagePerDay":{"type":"integer"},"days":{"type":"integer"},"last7Days":{"type":"integer"},"peak":{"properties":{"day":{"type":"string"},"value":{"type":"integer"}},"type":"object"},"previous7Days":{"type":"integer"},"total":{"type":"integer"},"unit":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · new_affiliates","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"new_affiliates","x-mcp-tool":"shop"}},"/v1/shops/{id}/new-products":{"get":{"description":"This route: products it launched in the window.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_new_products","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":4,"currency":"USD","dataEnd":"2026-10-28","hasMore":false,"id":"7495153913553128138","items":[{"collect_day":"2026-10-20","id":"1732418744492528330","product_title":"Vanilla Glaze Moisturizing Body Lotion with Peptides, Ceramides, Niacinamide, Squalane \u0026 Hyaluronic Acid, 16 fl oz","revenue":"$84.00","sale":"3","unit_price":"$28.00"},{"collect_day":"2026-10-21","id":"1732776932999598794","product_title":"Brightening Duo - All-Over Body Serum + Targeted Dark Spot Serum Set with Tranexamic Acid, Vitamin C \u0026 4% Niacinamide – Helps Improve the Look of Dark Spots \u0026 Uneven Skin Tone","revenue":"$0.00","sale":"0"},{"collect_day":"2026-10-21","id":"1732776877478941386","product_title":"Hydrating Lip Gloss 2-Pack - Lip Gloss Duo Set, High Shine \u0026 Tinted, Infused with Hyaluronic Acid, Jojoba Oil \u0026 Shea Butter","revenue":"$0.00","sale":"0"}],"market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"collect_day":{"type":"string"},"id":{"type":"string"},"product_title":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"unit_price":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · new_products","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"new_products","x-mcp-tool":"shop"}},"/v1/shops/{id}/products":{"get":{"description":"This route: its products ranked by revenue.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_products","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":20,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"id":"7495153913553128138","items":[{"collect_day":"2025-10-18","id":"1731896769144001226","product_title":"Hydrating Lip Gloss - High Shine \u0026 Tinted, Infused with Hyaluronic Acid, Jojoba Oil \u0026 Shea Butter","revenue":"$285.28k","sale":"35.66k","unit_price":"$8.00"},{"collect_day":"2025-09-27","id":"1731678264099967690","product_title":"The Brightening Body Serum – Targeted Dark Spot Treatment with Vitamin C \u0026 Tranexamic Acid – Corrects Hyperpigmentation, Dark Spots \u0026 Uneven Tone – Boosts Radiance for a Brighter, Youthful-Looking Complexion – Clinical Strength Formula","revenue":"$271.61k","sale":"12.93k","unit_price":"$21.00"},{"collect_day":"2024-01-13","id":"1729430515554816714","product_title":"Unicorn Fruit Brightening and Smoothing Deodorant – Aluminum-Free, Fights Odor-Causing Bacteria with Papaya Enzymes \u0026 Mango Butter – Helps Fade Dark Underarm Discoloration – Removes Impurities \u0026 Dead Skin – Sweet Cotton Candy Scent","revenue":"$187.81k","sale":"15.65k","unit_price":"$12.00"}],"market":"US","next":"eyJwYWdlIjoyLCJzaXplIjoyMH0","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjoyMH0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"collect_day":{"type":"string"},"id":{"type":"string"},"product_title":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"unit_price":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · products","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"products","x-mcp-tool":"shop"}},"/v1/shops/{id}/sales":{"get":{"description":"This route: revenue and units, split by own accounts, affiliates and mall.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_sales","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"7495153913553128138","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"affiliate_percentage":99.48,"affiliate_revenue":"$1.88m","day_affiliate_revenue":"$62.53k","day_other_revenue":"$323.10","day_revenue":"$62.86k","day_sale":"3.51k","day_self_promotion_revenue":"$4.96","day_shopping_mall_revenue":"$323.10","live_revenue":"$487.09k","original_affiliate_revenue":1875836.63,"original_live_revenue":487085.31,"original_revenue":1885678.59,"original_self_promotion_revenue":148.95,"original_shopping_mall_revenue":9693.01,"original_showcase_revenue":9693.01,"original_video_revenue":1388900.27,"other_percentage":0.51,"other_revenue":"$9.69k","revenue":"$1.89m","sale":"105.23k","self_promotion_percentage":0.01,"self_promotion_revenue":"$148.95","shopping_mall_percentage":0.51,"shopping_mall_revenue":"$9.69k","showcase_revenue":"$9.69k","unit_price":"$17.92","video_revenue":"$1.39m"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"affiliate_percentage":{"type":"number"},"affiliate_revenue":{"type":"string"},"day_affiliate_revenue":{"type":"string"},"day_other_revenue":{"type":"string"},"day_revenue":{"type":"string"},"day_sale":{"type":"string"},"day_self_promotion_revenue":{"type":"string"},"day_shopping_mall_revenue":{"type":"string"},"live_revenue":{"type":"string"},"original_affiliate_revenue":{"type":"number"},"original_live_revenue":{"type":"number"},"original_revenue":{"type":"number"},"original_self_promotion_revenue":{"type":"number"},"original_shopping_mall_revenue":{"type":"number"},"original_showcase_revenue":{"type":"number"},"original_video_revenue":{"type":"number"},"other_percentage":{"type":"number"},"other_revenue":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"self_promotion_percentage":{"type":"number"},"self_promotion_revenue":{"type":"string"},"shopping_mall_percentage":{"type":"number"},"shopping_mall_revenue":{"type":"string"},"showcase_revenue":{"type":"string"},"unit_price":{"type":"string"},"video_revenue":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · sales","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"sales","x-mcp-tool":"shop"}},"/v1/shops/{id}/strategy":{"get":{"description":"This route: price bands and sales-channel mix: top affiliates (individuals unnamed) and the shop's own accounts.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_strategy","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"affiliate":[{"creator":"Creator 1","follower_count":37000,"revenue":107745},{"creator":"Creator 2","follower_count":15800,"revenue":62205},{"creator":"Creator 3","follower_count":23600,"revenue":58120}],"currency":"USD","dataEnd":"2026-10-28","id":"7495153913553128138","market":"US","notes":["Market US (United States): amounts are in USD.","Individual affiliate creators are shown as Creator 1, 2, ... with their metrics. Accounts the shop owns (ownAccounts) are named."],"ownAccounts":[{"follower_count":3000000,"handle":"trulybeauty","i18n_follower_count":"3m","i18n_revenue":"$148.95","id":"6752887346621023238","live_revenue":0,"nickname":"Truly Beauty","revenue":148.95,"sale":5,"signature":"Experts in Smooth Skin ✨\nTIKTOK for 10% OFF","video_revenue":148.95}],"pricing":{"product_count":"58","product_counts":[222,222,222],"product_with_sale_count":"49","product_with_sale_counts":[44,2,3],"revenue":"$1.89m","revenues":[58261.27,1843,1506],"sales":[2582,56,46],"unit_price":"$17.92","unit_prices":[22.56,32.91,32.74]},"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"affiliate":{"items":{"properties":{"creator":{"type":"string"},"follower_count":{"type":"integer"},"revenue":{"type":"integer"}},"type":"object"},"type":"array"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"ownAccounts":{"items":{"properties":{"follower_count":{"type":"integer"},"handle":{"type":"string"},"i18n_follower_count":{"type":"string"},"i18n_revenue":{"type":"string"},"id":{"type":"string"},"live_revenue":{"type":"integer"},"nickname":{"type":"string"},"revenue":{"type":"number"},"sale":{"type":"integer"},"signature":{"type":"string"},"video_revenue":{"type":"number"}},"type":"object"},"type":"array"},"pricing":{"properties":{"product_count":{"type":"string"},"product_counts":{"items":{"type":"integer"},"type":"array"},"product_with_sale_count":{"type":"string"},"product_with_sale_counts":{"items":{"type":"integer"},"type":"array"},"revenue":{"type":"string"},"revenues":{"items":{"type":"number"},"type":"array"},"sales":{"items":{"type":"integer"},"type":"array"},"unit_price":{"type":"string"},"unit_prices":{"items":{"type":"number"},"type":"array"}},"type":"object"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · strategy","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"strategy","x-mcp-tool":"shop"}},"/v1/shops/{id}/trend":{"get":{"description":"This route: daily revenue and units (up to ~13 months).\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_trend","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"coverage":{"days":30,"daysWithSales":30,"firstDayWithSales":"2026-09-29"},"currency":"USD","dataEnd":"2026-10-28","id":"7495153913553128138","market":"US","notes":["Market US (United States): amounts are in USD."],"series":[{"affiliate_revenue":57675.27,"partition_day":"2026-09-29","revenue":58261.27,"sale":2582,"self_promotion_revenue":0,"shopping_mall_revenue":586,"unit_price":22.56},{"affiliate_revenue":1843,"partition_day":"2026-09-30","revenue":1843,"sale":56,"self_promotion_revenue":0,"shopping_mall_revenue":0,"unit_price":32.91},{"affiliate_revenue":1506,"partition_day":"2026-10-01","revenue":1506,"sale":46,"self_promotion_revenue":0,"shopping_mall_revenue":0,"unit_price":32.74}],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"revenue":1885679,"units":105234},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"coverage":{"properties":{"days":{"type":"integer"},"daysWithSales":{"type":"integer"},"firstDayWithSales":{"type":"string"}},"type":"object"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"series":{"items":{"properties":{"affiliate_revenue":{"type":"number"},"partition_day":{"type":"string"},"revenue":{"type":"number"},"sale":{"type":"integer"},"self_promotion_revenue":{"type":"integer"},"shopping_mall_revenue":{"type":"integer"},"unit_price":{"type":"number"}},"type":"object"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"revenue":{"type":"integer"},"units":{"type":"integer"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · trend","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"trend","x-mcp-tool":"shop"}},"/v1/shops/{id}/videos":{"get":{"description":"This route: videos selling its products, with revenue.\n\nEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {\"id\":\"7495514739648989419\",\"method\":\"new_affiliates\",\"window\":\"30d\"}.","operationId":"GET_shops_id_videos","parameters":[{"description":"Seller id (sellerId on products and stores).","example":"7495153913553128138","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":20,"currency":"USD","dataEnd":"2026-10-28","hasMore":true,"id":"7495153913553128138","items":[{"ad":1,"ai_video":0,"content_type":"video","create_time":"2026/10/20 21:55:00","description":"strawberries  #aftershaveoil #razorbumpsolutions #femininehygieneproducts #trulyaftershaveoil ","duration":"41s","handle":"petitetiramisu","id":"7698933706576137485","original_duration":41.167,"product_ids":["1729445990437982922"],"revenue":"$35.51k","sale":1076,"uid":"6980982804826375173","views":"3.6m"},{"ad":1,"ai_video":0,"content_type":"video","create_time":"2026/09/29 17:49:11","description":"Obsessed with this #lipgloss #drylips #lipcombo ","duration":"37s","handle":"swishybeauty","id":"7691077500054637838","original_duration":37.867,"product_ids":["1731896769144001226"],"revenue":"$24.90k","sale":3113,"uid":"6672578604607685638","views":"3.42m"},{"ad":1,"ai_video":0,"content_type":"video","create_time":"2026/09/21 22:58:40","description":"Now this is how you do a high shine gloss!😍🤏🏽🫦✨#trulylipgloss #trulybeauty #lipgloss #tiktokshopstockup ","duration":"42s","handle":"xoxopeta","id":"7688188610041957662","original_duration":42.9,"product_ids":["1731896769144001226"],"revenue":"$23.14k","sale":2892,"uid":"7384276485555094570","views":"3.3m"}],"market":"US","next":"eyJwYWdlIjoyLCJzaXplIjoyMH0","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJwYWdlIjoyLCJzaXplIjoyMH0"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"ad":{"type":"integer"},"ai_video":{"type":"integer"},"content_type":{"type":"string"},"create_time":{"type":"string"},"description":{"type":"string"},"duration":{"type":"string"},"handle":{"type":"string"},"id":{"type":"string"},"original_duration":{"type":"number"},"product_ids":{"items":{"type":"string"},"type":"array"},"revenue":{"type":"string"},"sale":{"type":"integer"},"uid":{"type":"string"},"views":{"type":"string"}},"type":"object"},"type":"array"},"market":{"type":"string"},"next":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok Shop seller · videos","tags":["shop"],"x-credits":1,"x-example-params":{"id":"7495153913553128138"},"x-mcp-method":"videos","x-mcp-tool":"shop"}},"/v1/sounds/beats":{"get":{"description":"This route: recommended beats.\n\nFinds TikTok sounds by keyword, or lists TikTok's hot sounds, beats and licensed music. Pass a sound id to sound for its videos. Example: {\"keyword\":\"sped up\"} or {\"method\":\"hot\"}.","operationId":"GET_sounds_beats","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. Max 30. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"from_recommend":true,"hasMore":false,"sounds":[{"album":"Cute","author":"CLOUDEE","commercialUse":true,"durationSec":60,"id":"7284220358223005697","title":"Cute","url":"https://www.tiktok.com/music/-7284220358223005697","videos":577480},{"author":"Stacey🦋","commercialUse":true,"durationSec":35,"id":"7702366598140676886","original":true,"title":"original sound - stacey.shops","url":"https://www.tiktok.com/music/-7702366598140676886","videos":1},{"author":"Eirini ✨","commercialUse":true,"durationSec":7,"id":"7702130662115166979","original":true,"title":"original sound - _eirinikatsigianni","url":"https://www.tiktok.com/music/-7702130662115166979"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"from_recommend":{"type":"boolean"},"hasMore":{"type":"boolean"},"sounds":{"items":{"properties":{"album":{"type":"string"},"author":{"type":"string"},"commercialUse":{"type":"boolean"},"durationSec":{"type":"integer"},"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find sounds · beats","tags":["sound_search"],"x-credits":1,"x-example-params":{"limit":3},"x-mcp-method":"beats","x-mcp-tool":"sound_search"}},"/v1/sounds/hot":{"get":{"description":"This route: currently hot original sounds.\n\nFinds TikTok sounds by keyword, or lists TikTok's hot sounds, beats and licensed music. Pass a sound id to sound for its videos. Example: {\"keyword\":\"sped up\"} or {\"method\":\"hot\"}.","operationId":"GET_sounds_hot","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. Max 30. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"from_recommend":true,"hasMore":true,"next":"eyJjdXJzb3IiOjN9","sounds":[{"album":"Cute","author":"CLOUDEE","commercialUse":true,"durationSec":60,"id":"7284220358223005697","title":"Cute","url":"https://www.tiktok.com/music/-7284220358223005697","videos":577480},{"author":"naran sitaula","commercialUse":true,"durationSec":21,"id":"7702238644861553411","original":true,"title":"original sound - naran.sitaula","url":"https://www.tiktok.com/music/-7702238644861553411","videos":1},{"album":"Do Not Give Up Easily","author":"Gareta Johan","durationSec":45,"id":"7609944367696906257","title":"Do Not Give Up Easily","url":"https://www.tiktok.com/music/-7609944367696906257","videos":19337}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"from_recommend":{"type":"boolean"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"sounds":{"items":{"properties":{"album":{"type":"string"},"author":{"type":"string"},"commercialUse":{"type":"boolean"},"durationSec":{"type":"integer"},"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find sounds · hot","tags":["sound_search"],"x-credits":1,"x-example-params":{"limit":3},"x-mcp-method":"hot","x-mcp-tool":"sound_search"}},"/v1/sounds/licensed":{"get":{"description":"This route: licensed tracks cleared for use.\n\nFinds TikTok sounds by keyword, or lists TikTok's hot sounds, beats and licensed music. Pass a sound id to sound for its videos. Example: {\"keyword\":\"sped up\"} or {\"method\":\"hot\"}.","operationId":"GET_sounds_licensed","parameters":[{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. Max 30. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":false,"sounds":[{"author":"Galantis","durationSec":18,"id":"6575698583637461761","title":"Love On Me","url":"https://www.tiktok.com/music/-6575698583637461761","videos":1441190},{"album":"One Call Away","author":"Charlie Puth","durationSec":41,"id":"6353936740163521282","title":"One Call Away","url":"https://www.tiktok.com/music/-6353936740163521282","videos":3602251},{"album":"SQUARE UP","author":"BLACKPINK","durationSec":18,"id":"6569011430538873607","original":true,"title":"Forever Young","url":"https://www.tiktok.com/music/-6569011430538873607","videos":704647}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"sounds":{"items":{"properties":{"author":{"type":"string"},"durationSec":{"type":"integer"},"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Find sounds · licensed","tags":["sound_search"],"x-credits":1,"x-example-params":{"limit":3},"x-mcp-method":"licensed","x-mcp-tool":"sound_search"}},"/v1/sounds/{id}":{"get":{"description":"This route: title, author, duration, original or licensed, post count.\n\nOne TikTok sound (id = sound id from any post or sound_search, or a sound link): detail or the videos using it. Example: {\"id\":\"7012...\",\"method\":\"videos\"}.","operationId":"GET_sounds_id","parameters":[{"description":"Sound id (sound.id on a post) or a TikTok sound link.","example":"7139362230881094442","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"author":"JERI","commercialUse":true,"durationSec":40,"id":"7139362230881094442","original":true,"title":"ariana grande . ill do it","url":"https://www.tiktok.com/music/-7139362230881094442","videos":37373},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"author":{"type":"string"},"commercialUse":{"type":"boolean"},"durationSec":{"type":"integer"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"},"url":{"type":"string"},"videos":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One sound · detail","tags":["sound"],"x-credits":1,"x-example-params":{"id":"7139362230881094442"},"x-mcp-method":"detail","x-mcp-tool":"sound"}},"/v1/sounds/{id}/videos":{"get":{"description":"This route: videos using the sound.\n\nOne TikTok sound (id = sound id from any post or sound_search, or a sound link): detail or the videos using it. Example: {\"id\":\"7012...\",\"method\":\"videos\"}.","operationId":"GET_sounds_id_videos","parameters":[{"description":"Sound id (sound.id on a post) or a TikTok sound link.","example":"7139362230881094442","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. Max 50. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"can_pin_video":false,"hasMore":true,"need_lazy_loading":false,"next":"eyJjdXJzb3IiOiIxMiJ9","version":"v2","videos":[{"caption":"ariana grande - ill do it x the light is coming #arianator #ariana #heidimontag #music #fyp #remix #mashup","comments":334,"creator":{"handle":"princesstar101","id":"6546365462278575104","nickname":"JERI","secUid":"MS4wLjABAAAA2S0o_ga6XnDO0O9EIB13PxSS5v0MJIewfBPq2FWHO6PirmDwcPNrqyvOwqPtg_Cv"},"durationSec":41.12,"hashtags":[{"id":"28006","name":"arianator"},{"id":"12326","name":"ariana"},{"id":"730612","name":"heidimontag"}],"id":"7139362264565501226","language":"en","likes":30956,"posted":"2022-09-04T03:31:54Z","saves":16384,"shares":683,"sound":{"author":"JERI","id":"7139362230881094442","original":true,"title":"ariana grande . ill do it"},"url":"https://www.tiktok.com/@princesstar101/video/7139362264565501226","views":673675},{"caption":"Amber is the best","comments":187,"creator":{"handle":"heidimontag","id":"114703556082917376","nickname":"heidimontag","secUid":"MS4wLjABAAAAr_d_sgXvtLe_VPVE1-toCiS8hgaBFNbytBBh77sqTSfMiXDXOhH9W5fKDdbstpsY","verified":true},"durationSec":13.258,"id":"6896945616031632646","language":"en","likes":6166,"posted":"2020-11-19T21:12:05Z","saves":1387,"shares":106,"sound":{"author":"Heidi Montag","id":"238606941294632960","title":"I'll Do It"},"url":"https://www.tiktok.com/@heidimontag/video/6896945616031632646","views":507712},{"caption":"Its a twin thingy yall  😂🥰 #twintelepathy","comments":5128,"creator":{"handle":"razzi_boo","id":"7169714537069888554","nickname":"Londyn \u0026 LaWayne","secUid":"MS4wLjABAAAAJXx1DxOntxKrJdIZw_SivXtPH7Kj_ZNMu59w52z3875Op3xh4rJvWeAdsZHvGZAS"},"durationSec":30.367,"hashtags":[{"id":"638669","name":"twintelepathy"}],"id":"7354772929457966382","language":"en","likes":1372006,"posted":"2024-04-06T15:15:49Z","saves":93108,"shares":38731,"sound":{"author":"JERI","id":"7139362230881094442","original":true,"title":"ariana grande . ill do it"},"url":"https://www.tiktok.com/@razzi_boo/video/7354772929457966382","views":18229626}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOiIxMiJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"can_pin_video":{"type":"boolean"},"hasMore":{"type":"boolean"},"need_lazy_loading":{"type":"boolean"},"next":{"type":"string"},"version":{"type":"string"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"number"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One sound · videos","tags":["sound"],"x-credits":1,"x-example-params":{"id":"7139362230881094442","limit":"3"},"x-mcp-method":"videos","x-mcp-tool":"sound"}},"/v1/storefront/category-page":{"get":{"description":"This route: a category page (category_id + slug).\n\nWhat a shopper sees on TikTok Shop (US store) right now: search results, keyword and category pages, deals and flash sales. Returns price, discount, displayed units sold, rating and shop. Displayed sold counts are lifetime and broad single-word searches can return only a short fallback list, so this is not a sales ranking: use product_top_selling for best sellers. Example: {\"keyword\":\"lip oil\",\"sort\":\"best_sellers\"}.","operationId":"GET_storefront_category_page","parameters":[{"description":"method=category_page: category id from relatedCategories.","example":"601450","in":"query","name":"category_id","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=keyword_page: slug from relatedSearches (e.g. lip-oils); method=category_page: category slug.","in":"query","name":"slug","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"category":{"id":"601450","name":"Beauty \u0026 Personal Care","slug":"c"},"component_names":["user_info","page_header","bread_crumbs"],"hasMore":true,"page":"category","products":[{"brand":"Gurunanda","currency":"USD","id":"1729388303591248135","price":19.49,"rating":4.4,"reviews":97948,"sellerId":"7495134783373216007","shop":"GuruNanda LLC","sold":1536366,"title":"GuruNanda Whitening Strips, 7-day treatment (7 Packets - 2 Strips per pack) - Non-Slip, Dry Strip Technology","url":"https://shop.tiktok.com/us/pdp/whitening-strips-by-gurunanda-for-sensitive-teeth-7-day-treatment-kit/1729388303591248135"},{"brand":"Mad Rabbit","currency":"USD","id":"1729386349123571788","price":26,"rating":4.5,"reviews":1145,"sellerId":"7495157675807574092","shop":"Mad Rabbit","sold":9929,"title":"Mad Rabbit Tattoo Balm \u0026 Aftercare Cream- Color Enhancement that Revives Old Tattoos, Hydrates New Tattoos, Made With Clean Ingredients + Petroleum Free, Daily Tattoo Lotion Moisturizer \u0026 Brightener","url":"https://shop.tiktok.com/us/pdp/tattoo-balm-by-mad-rabbit-clean-vegan-aftercare-for-new-old-tattoos/1729386349123571788"},{"brand":"tarte","currency":"USD","discount":"50%","id":"1729417067781002172","originalPrice":93.6,"price":46.8,"rating":4.5,"reviews":13033,"sellerId":"7495150597721263036","shop":"Tarte Cosmetics","sold":228876,"title":"tarte sculpt tape \u0026 blush tape duo - blush and bronzer","url":"https://shop.tiktok.com/us/pdp/sculpt-tape-blush-tape-duo-by-tarte-cosmetics-for-defined-cheeks/1729417067781002172"}],"source":"https://shop.tiktok.com/us/c/c/601450"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"category":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"component_names":{"items":{"type":"string"},"type":"array"},"hasMore":{"type":"boolean"},"page":{"type":"string"},"products":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"id":{"type":"string"},"price":{"type":"number"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Browse TikTok Shop now · category_page","tags":["shop_browse"],"x-credits":1,"x-example-params":{"category_id":"601450"},"x-mcp-method":"category_page","x-mcp-tool":"shop_browse"}},"/v1/storefront/deals":{"get":{"description":"This route: the deals feed.\n\nWhat a shopper sees on TikTok Shop (US store) right now: search results, keyword and category pages, deals and flash sales. Returns price, discount, displayed units sold, rating and shop. Displayed sold counts are lifetime and broad single-word searches can return only a short fallback list, so this is not a sales ranking: use product_top_selling for best sellers. Example: {\"keyword\":\"lip oil\",\"sort\":\"best_sellers\"}.","operationId":"GET_storefront_deals","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"component_names":["user_info","page_header","bread_crumbs"],"hasMore":true,"next":"eyJjdXJzb3IiOjQxfQ","page":"deals","path":"deals/recommended-for-you","products":[{"brand":"ZUY","currency":"USD","discount":"33%","id":"1732013337089577703","originalPrice":35.99,"price":23.99,"rating":4.7,"reviews":5520,"sellerId":"7496301427006606055","shop":"ZUY US","sold":42272,"title":"Unisex Zip Up Jackets Vintage Washed Coat Streetwear Hoodies Unisex Soft Material Casual Fashion Essential Tops for Men Day Womenswear","url":"https://shop.tiktok.com/us/pdp/vintage-washed-zip-up-jacket-unisex-soft-material-casual-style/1732013337089577703"},{"brand":"Whyte","currency":"USD","discount":"51%","id":"1731573006366183970","originalPrice":42.99,"price":20.88,"rating":3.6,"reviews":855,"sellerId":"7495999835031243298","shop":"WHYTE","sold":20445,"title":"Whyte Purple Teeth Whitening Powder, Nano Hydroxyapate, PAP+, Xylitol. Sulfate Free Formula - Mint Flavor","url":"https://shop.tiktok.com/us/pdp/purple-teeth-whitening-powder-brighter-smile-today/1731573006366183970"},{"brand":"TIRTIR","currency":"USD","discount":"27%","id":"1732154203314098778","originalPrice":30,"price":21.83,"rating":4.6,"reviews":1887,"sellerId":"7495857443730262618","shop":"TIRTIR Inc.","sold":16270,"title":"[TIRTIR Official] Seal the Deal Long-Wear Makeup Finishing Mist Setㅣ Mask Fit Waterproof Setting Spray 80ml \u0026 Mask Fit Makeup Fixer 80ml","url":"https://shop.tiktok.com/us/pdp/tirtir-official-long-wear-makeup-finishing-mist-set-80ml/1732154203314098778"}],"source":"https://shop.tiktok.com/us/deals/recommended-for-you"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjQxfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"component_names":{"items":{"type":"string"},"type":"array"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"page":{"type":"string"},"path":{"type":"string"},"products":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"discount":{"type":"string"},"id":{"type":"string"},"originalPrice":{"type":"number"},"price":{"type":"number"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Browse TikTok Shop now · deals","tags":["shop_browse"],"x-credits":1,"x-mcp-method":"deals","x-mcp-tool":"shop_browse"}},"/v1/storefront/flash-sales":{"get":{"description":"This route: flash sales.\n\nWhat a shopper sees on TikTok Shop (US store) right now: search results, keyword and category pages, deals and flash sales. Returns price, discount, displayed units sold, rating and shop. Displayed sold counts are lifetime and broad single-word searches can return only a short fallback list, so this is not a sales ranking: use product_top_selling for best sellers. Example: {\"keyword\":\"lip oil\",\"sort\":\"best_sellers\"}.","operationId":"GET_storefront_flash_sales","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"component_names":["user_info","page_header","bread_crumbs"],"hasMore":true,"next":"eyJleGNsdWRlX3Byb2R1Y3RfaWRzIjpbIjE3MzI1Mzg2OTk2ODMwNDEzMTUiLCIxNzMyNTY2NTY1MDA3ODIzNjIyIiwiMTczMTc0MjU5OTU4NDE5MDg4NSIsIjE3MzIyNDQyODk3MDU5MDY3NTEiLCIxNzMxOTc3OTgwNzkzOTUwODE1IiwiMTcyOTc2ODYxMDIxMDA5MTc3MiIsIjE3MzE2NzYzMTU2MDYyOTA4NDkiLCIxNzI5NTk0MjQ2OTQ3NjM5NTc4IiwiMTcyOTQwNjc2NjE3MDAxODc2MiIsIjE3…","page":"flash_sales","path":"deals/flash-sales","products":[{"brand":"Aoqta","currency":"USD","discount":"37%","id":"1732538699683041315","originalPrice":29.96,"price":19.01,"rating":4.6,"reviews":20,"sellerId":"7496222237926983715","shop":"Aoqta","sold":239,"title":"Aoqta Women’s 2-Piece Yoga Athletic Sportswear Set - Square Neck Long Sleeve Top, High Waist Butt Lifting Flared Pants, Machine Washable Workout Sets Women for Gym,sohochic","url":"https://shop.tiktok.com/us/pdp/aoqta-womens-2-piece-quick-dry-gym-set-yoga-dance-wear/1732538699683041315"},{"brand":"MAGIC JOHN","currency":"USD","discount":"50%","id":"1732566565007823622","originalPrice":11.96,"price":5.98,"rating":4.5,"reviews":234,"sellerId":"7495468182119418630","shop":"MAGIC JOHN","sold":5545,"title":"MAGIC JOHN MagicView Ultra-Slim Scratch Resistant Privacy/HD Glass Screen Protector for iPhone 18/17/16/15 Series, 2-Pack Phone Accessories, 0.33mm, No Black Border, Auto Dust Removal, Easy Installation, Case-Friendly, Anti-Peek Privacy Screen Protector,","url":"https://shop.tiktok.com/us/pdp/magic-john-screen-protector-for-iphone-17-16-15-2-pack-0-33mm/1732566565007823622"},{"brand":"YCZ","currency":"USD","discount":"50%","id":"1731742599584190885","originalPrice":53.88,"price":26.99,"rating":4.7,"reviews":1230,"sellerId":"7495623134499408293","shop":"Y CZ","sold":8155,"title":"[YCZ] Men's Midnight Marine EDP Cologne, 2×50mL/1.7oz Aquatic Marine \u0026 Citrus Woody Perfume for Adults, Captivating Scent, Long-Lasting Luxurious Fragrance for Dates \u0026 Summer Use,familyfun","url":"https://shop.tiktok.com/us/pdp/2-pack-unisex-eau-de-parfum-100ml-ocean-fresh-scent/1731742599584190885"}],"source":"https://shop.tiktok.com/us/deals/flash-sales"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJleGNsdWRlX3Byb2R1Y3RfaWRzIjpbIjE3MzI1Mzg2OTk2ODMwNDEzMTUiLCIxNzMyNTY2NTY1MDA3ODIzNjIyIiwiMTczMTc0MjU5OTU4NDE5MDg4NSIsIjE3MzIyNDQyODk3MDU5MDY3NTEiLCIxNzMxOTc3OTgwNzkzOTUwODE1IiwiMTcyOTc2ODYxMDIxMDA5MTc3MiIsIjE3MzE2NzYzMTU2MDYyOTA4NDkiLCIxNzI5NTk0MjQ2OTQ3NjM5NTc4IiwiMTcyOTQwNjc2NjE3MDAxODc2MiIsIjE3Mjk0NTI1MjQyMDEzNDk1NDQiLCIxNzMwMzAxODgyNTE1MTAwNTk4IiwiMTczMjE1MjA5MzY3MzQ5MzQyOSIsIjE3MzIxNTg1MDkxMzk0NjQ0NTIiLCIxNzI5NDgzMTcyNTEwMTQ0MTgyIiwiMTczMTI2NDYyOTM2NDc4OTMzNiIsIjE3Mjk2NzE4NDY2Mjg3MjUxNTciLCIxNzMxMzk3NTAwNjU0MzU4NjI3IiwiMTczMDM4MTExNDAyMjg1ODk2OSIsIjE3Mjk0MjA0NTE4NDY3MjI0NDIiLCIxNzI5NzEyMDIyMDYwODMwNzgyIiwiMTczMjU3NjQyMDY3Mzc4NjcxNiIsIjE3MzEyMjU2OTQ3NjY4NjI1MzIiLCIxNzMyMzA2ODIzODE4OTQwODMzIiwiMTczMTc0OTg3MjUxNzYxNjM4MCIsIjE3MzI0MjQxMTI0NDIxNTEyNDkiLCIxNzI5NzQ3NTA4Mzk0OTU1MjE0IiwiMTczMDU1NTY4Mzk1Mjg5MDYxNyIsIjE3MzIxMzY1MzY3Mzk1MTcwMDMiLCIxNzI5NDQ4MzIwNDgyNTEzNDUwIiwiMTczMjIyMjY2MjEyOTQ1NTM2MCIsIjE3MzIwOTQwNjQ4Mzk1MjkxOTEiLCIxNzMyMzY4NDk2MDgzOTY0NjU3IiwiMTczMjI4OTU5MzgxOTEwNzU2NCIsIjE3Mjk3MzUzNDY4NTcxNTI4MjMiLCIxNzMyNDAyMjIxMjA3NDI1ODE4IiwiMTczMjM2NTQ0MjEzMjg0MDUyNSIsIjE3MzI0NDM0MTg4NTE2NDMzOTkiLCIxNzMyMDc2Mzk0NjY4NjU5NDI0IiwiMTcyOTQwNjk2MzYwODAzMjIzNyIsIjE3MzE2MDUxMDYxNjAyNzYxMTAiLCIxNzI5NDc2Mzk0MTgxMDM5MjY0IiwiMTcyOTYyNzUyMzkzNTA4MDYwMyIsIjE3Mjk0ODg3NTgzMzUzNzkyMDgiLCIxNzMyMjgzOTkyMjA1MjY3Mzc3IiwiMTcyOTQ4ODY5NjkyMDkzODI0OCJdLCJvZmZzZXQiOjQ1fQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"component_names":{"items":{"type":"string"},"type":"array"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"page":{"type":"string"},"path":{"type":"string"},"products":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"discount":{"type":"string"},"id":{"type":"string"},"originalPrice":{"type":"number"},"price":{"type":"number"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Browse TikTok Shop now · flash_sales","tags":["shop_browse"],"x-credits":1,"x-mcp-method":"flash_sales","x-mcp-tool":"shop_browse"}},"/v1/storefront/keyword-page":{"get":{"description":"This route: an SEO keyword page (slug).\n\nWhat a shopper sees on TikTok Shop (US store) right now: search results, keyword and category pages, deals and flash sales. Returns price, discount, displayed units sold, rating and shop. Displayed sold counts are lifetime and broad single-word searches can return only a short fallback list, so this is not a sales ranking: use product_top_selling for best sellers. Example: {\"keyword\":\"lip oil\",\"sort\":\"best_sellers\"}.","operationId":"GET_storefront_keyword_page","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=search or keyword_page: TikTok filter ids from a previous response's filters, e.g. ecom_rating_stat|RATING_4.","in":"query","name":"filters","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=keyword_page: slug from relatedSearches (e.g. lip-oils); method=category_page: category slug.","example":"lip-oil","in":"query","name":"slug","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":true,"next":"eyJvZmZzZXQiOjMwfQ","page":"keyword","products":[{"currency":"USD","discount":"53%","id":"1729500724221286212","originalPrice":14.99,"price":6.99,"rating":4.7,"reviews":490,"sellerId":"7496260439930211140","shop":"PureGlam Lab","sold":2044,"title":"Women's 2-Pcs Natural Lip Care Gift Set - Moisturizing Balm, Lip Oil, Glossy Lipgloss, Gentle Conditioner, Bottle Packaging | Daily Softening | Back-to-School Gift for Personal Use","url":"https://shop.tiktok.com/us/pdp/2-piece-3-in-1-lip-care-set-hydrating-lip-balm-gloss/1729500724221286212"},{"brand":"NOONI","currency":"USD","id":"1729440860171702516","price":15,"rating":4.3,"reviews":35969,"sellerId":"7495586169586223348","shop":"NOONI","sold":346768,"title":"Nooni Korean Apple Lip Oil + Lip Stain | Glossy Lip Stain, Tinting \u0026 Long Lasting, Moisturizing Lip Care (17 options) Hydrate Lipgloss Lipstick Makeup Glossy Hydrating Moisturizer Plump Transfer-proof","url":"https://shop.tiktok.com/us/pdp/apple-lip-oil-by-nooni-moisturizing-tint-softening-care-3-7ml/1729440860171702516"},{"currency":"USD","discount":"38%","id":"1732388535932916327","originalPrice":20.99,"price":12.99,"rating":4.8,"reviews":32,"sellerId":"7494591973747295847","shop":"Kore Mart US","sold":119,"title":"[BUY 3 GET 3 FREE] 6-Count Lip Oil \u0026 Lipgloss Cosmetic Gift Set - Affordable Lip Care Treatment, Hydrates, Moisturizes, Smooths Skin, Anti-Wrinkle, Student-Friendly Beauty Item","url":"https://shop.tiktok.com/us/pdp/moisturizing-clear-lip-gloss-set-6-count-student-friendly/1732388535932916327"}],"relatedCategories":[{"id":"601595","name":"Lip Treatments","slug":"lip-treatments"},{"id":"601534","name":"Lipstick \u0026 Lip Gloss","slug":"lipstick-lip-gloss"},{"id":"601529","name":"Makeup Sets","slug":"makeup-sets"}],"relatedSearches":[{"name":"Lip Therapy","slug":"lip-therapy"},{"name":"oil lipstick","slug":"oil-lipstick"},{"name":"Lip lingerie","slug":"lip-lingerie"}],"shops":[{"name":"NOONI","sellerId":"7495586169586223348"},{"name":"e.l.f. Cosmetics","sellerId":"7494913857786775843"},{"name":"COVERGIRL","sellerId":"7496133101336103678"}],"source":"https://shop.tiktok.com/us/k/lip-oil"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjMwfQ"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"next":{"type":"string"},"page":{"type":"string"},"products":{"items":{"properties":{"currency":{"type":"string"},"discount":{"type":"string"},"id":{"type":"string"},"originalPrice":{"type":"number"},"price":{"type":"number"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"relatedCategories":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"type":"array"},"relatedSearches":{"items":{"properties":{"name":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"type":"array"},"shops":{"items":{"properties":{"name":{"type":"string"},"sellerId":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Browse TikTok Shop now · keyword_page","tags":["shop_browse"],"x-credits":1,"x-example-params":{"slug":"lip-oil"},"x-mcp-method":"keyword_page","x-mcp-tool":"shop_browse"}},"/v1/storefront/page":{"get":{"description":"This route: any other Shop page by path.\n\nWhat a shopper sees on TikTok Shop (US store) right now: search results, keyword and category pages, deals and flash sales. Returns price, discount, displayed units sold, rating and shop. Displayed sold counts are lifetime and broad single-word searches can return only a short fallback list, so this is not a sales ranking: use product_top_selling for best sellers. Example: {\"keyword\":\"lip oil\",\"sort\":\"best_sellers\"}.","operationId":"GET_storefront_page","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=path: any other Shop path, e.g. store/{slug}/{seller_id} or deals/premium-offers.","in":"query","name":"path","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"component_names":["user_info","page_header","campaign_hero_banner"],"hasMore":false,"page":"mall","path":"","products":[{"brand":"Leefar","currency":"USD","discount":"63%","id":"1730743411790877344","originalPrice":34.87,"price":12.89,"rating":4.7,"reviews":2507,"sellerId":"7495951453623650976","shop":"Leefar Supplements","sold":24092,"title":"LeeFar Her Juicy Feminine Probiotics Gummies- All in One Solution with Slippery Elm and Prebiotics\u0026Lactobacillus Probiotic Blend for Women's pH Balance and Dryness - Hawaiian Pineapple Gummies 60 Counts","url":"https://shop.tiktok.com/us/pdp/womens-probiotic-gummies-by-leefar-60-count-with-prebiotics-slippery-elm/1730743411790877344"},{"brand":"YOULUCK","currency":"USD","discount":"56%","id":"1730661941307937028","originalPrice":30.9,"price":13.6,"rating":4.7,"reviews":1700,"sellerId":"7495486250805332228","shop":"YouLuck Beauty","sold":30021,"title":"YOULUCK Velvet Touch Cluster Lashes Kit - 3D False Eyelashes \u0026 Adhesives, Waterproof Dramatic Eyelash Extensions, Ultra-Thin Band, Bond, Seal, Remover, Tweezer, Beginner-Friendly Beauty Cosmetic for Girls,familyfun","url":"https://shop.tiktok.com/us/pdp/youluck-lash-clusters-waterproof-long-lasting-beginner-friendly/1730661941307937028"},{"brand":"Pigeon","currency":"USD","discount":"37%","id":"1732157479503172113","originalPrice":40.99,"price":25.69,"rating":4.8,"reviews":107,"sellerId":"7496091900942912017","shop":"Pigeon USA","sold":2574,"title":"Pigeon Glass Nursing Baby Bottle (Pack of 2) Wide Neck, Anti-Colic, Streamlined Body, Natural Feel, Easy to Clean, (0m+) baby registry essential Heat-Resistant, 5.4 Oz, Includes 2pcs SS Nipples","url":"https://shop.tiktok.com/us/pdp/pigeon-glass-nursing-baby-bottle-pack-of-2-anti-colic-5-4-oz/1732157479503172113"}],"source":"https://shop.tiktok.com/us"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"component_names":{"items":{"type":"string"},"type":"array"},"hasMore":{"type":"boolean"},"page":{"type":"string"},"path":{"type":"string"},"products":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"discount":{"type":"string"},"id":{"type":"string"},"originalPrice":{"type":"number"},"price":{"type":"number"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Browse TikTok Shop now · path","tags":["shop_browse"],"x-credits":1,"x-mcp-method":"path","x-mcp-tool":"shop_browse"}},"/v1/storefront/search":{"get":{"description":"This route: Shop search results.\n\nWhat a shopper sees on TikTok Shop (US store) right now: search results, keyword and category pages, deals and flash sales. Returns price, discount, displayed units sold, rating and shop. Displayed sold counts are lifetime and broad single-word searches can return only a short fallback list, so this is not a sales ranking: use product_top_selling for best sellers. Example: {\"keyword\":\"lip oil\",\"sort\":\"best_sellers\"}.","operationId":"GET_storefront_search","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=search or keyword_page: TikTok filter ids from a previous response's filters, e.g. ecom_rating_stat|RATING_4.","in":"query","name":"filters","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"method=search: product search phrase.","example":"lip oil","in":"query","name":"keyword","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"method=search: best_sellers, newest, price_desc or price_asc (default relevance). The result's sortApplied says whether TikTok sorted the results (tiktok) or only this page was sorted (page).","in":"query","name":"sort","required":false,"schema":{"enum":["best_sellers","newest","price_desc","price_asc"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"filters":[{"group":"Sort by","options":[{"id":"ecom_sold_count","name":"Best sellers"},{"id":"ecom_publish_time","name":"Newest"},{"id":"ecom_price|DESC","name":"Price high to low"}]},{"group":"Promotions","options":[{"id":"ecom_promotion_tag_stat","name":"Deals"},{"id":"ecom_free_shipping_stat","name":"Free Shipping"}]},{"group":"Categories","options":[{"id":"ecom_category_level_two_stat|849160","name":"Bath \u0026 Body Care"},{"id":"ecom_category_level_two_stat|848648","name":"Makeup"},{"id":"ecom_category_level_two_stat|848776","name":"Skincare"}]}],"hasMore":true,"next":"eyJvZmZzZXQiOjMwLCJwYWdlX3Rva2VuIjoiMjAyNjEwMzAyMzI5MjRGQjc0MTlBODFDQjk5MzE4M0U4MiJ9","page":"search","products":[{"brand":"NOONI","currency":"USD","id":"1729440860171702516","price":15,"rating":4.3,"reviews":35969,"sellerId":"7495586169586223348","shop":"NOONI","sold":346768,"title":"Nooni Korean Apple Lip Oil + Lip Stain | Glossy Lip Stain, Tinting \u0026 Long Lasting, Moisturizing Lip Care (17 options) Hydrate Lipgloss Lipstick Makeup Glossy Hydrating Moisturizer Plump Transfer-proof","url":"https://shop.tiktok.com/us/pdp/apple-lip-oil-by-nooni-moisturizing-tint-softening-care-3-7ml/1729440860171702516"},{"brand":"e.l.f.","currency":"USD","id":"1729407202568147235","price":13,"rating":4.8,"reviews":18626,"sellerId":"7494913857786775843","shop":"e.l.f. Cosmetics","sold":228428,"title":"e.l.f. Glow Reviver Lip Oil, Nourishing Lip Oil High-Gloss Finish 0.25 oz (7.6 mL)","url":"https://shop.tiktok.com/us/pdp/glow-reviver-lip-oil-by-e-l-f-cosmetics-hydrating-tinted-formula/1729407202568147235"},{"currency":"USD","id":"1731254660842033551","price":9.99,"rating":4.2,"reviews":8811,"sellerId":"7496154631071304079","shop":"NEOVA","sold":57208,"title":"Moisturizing Lip Balm, 2 Counts/set Hydrating Glossy Lip Glaze Stick Plumping Lip Oil for Girls \u0026 Women, Fall Gift, Christmas Gift, Mother's Day Gift, Lip Stain, Skincare","url":"https://shop.tiktok.com/us/pdp/moisturizing-lip-balm-set-hydrating-glossy-lip-oil-fall-gift/1731254660842033551"}],"relatedCategories":[{"id":"601534","name":"Lipstick \u0026 Lip Gloss","slug":"lipstick-lip-gloss"},{"id":"601595","name":"Lip Treatments","slug":"lip-treatments"},{"id":"601529","name":"Makeup Sets","slug":"makeup-sets"}],"relatedSearches":[{"name":"lip oils","slug":"lip-oils"},{"name":"lip oil vs lip gloss","slug":"lip-oil-vs-lip-gloss"}],"shops":[{"name":"NOONI","sellerId":"7495586169586223348"},{"name":"e.l.f. Cosmetics","sellerId":"7494913857786775843"},{"name":"COVERGIRL","sellerId":"7496133101336103678"}],"source":"https://shop.tiktok.com/us/s?q=lip+oil\u0026source=ecommerce_mall\u0026enter_method=search"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJvZmZzZXQiOjMwLCJwYWdlX3Rva2VuIjoiMjAyNjEwMzAyMzI5MjRGQjc0MTlBODFDQjk5MzE4M0U4MiJ9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"filters":{"items":{"properties":{"group":{"type":"string"},"options":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"page":{"type":"string"},"products":{"items":{"properties":{"brand":{"type":"string"},"currency":{"type":"string"},"id":{"type":"string"},"price":{"type":"integer"},"rating":{"type":"number"},"reviews":{"type":"integer"},"sellerId":{"type":"string"},"shop":{"type":"string"},"sold":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"relatedCategories":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"type":"array"},"relatedSearches":{"items":{"properties":{"name":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"type":"array"},"shops":{"items":{"properties":{"name":{"type":"string"},"sellerId":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Browse TikTok Shop now · search","tags":["shop_browse"],"x-credits":1,"x-example-params":{"keyword":"lip oil"},"x-mcp-method":"search","x-mcp-tool":"shop_browse"}},"/v1/videos/top-selling":{"get":{"description":"This route: top videos by sales.\n\n[Shop Analytics] The top 10 shoppable videos by estimated revenue over a date range, with revenue, units, views, GPM, ad metrics (CPA, ROAS, ad revenue share), whether it is AI-generated, and the creator. This ranking takes no filters; to study one niche, rank its products with product_top_selling, then use product method=video_sales. Pass a row's id to video method=transcript or products. Example: {\"window\":\"7d\"}.","operationId":"GET_videos_top_selling","parameters":[{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"count":10,"currency":"USD","dataEnd":"2026-10-28","hasMore":false,"items":[{"ad":1,"ad2Cost":"$25.73k","ad2Roas":3.69,"ad_cpa":"$82.20","ad_revenue_ratio":"80.00%","ad_view_ratio":"28.88%","ai_video":0,"collect_day":"2026-10-25","content_type":"video","creator_uid":"7408927728046933038","description":"I think there’s a clear winner here 😅 #vacuum #stickvacuum #petallergies #shark #sharkpowerproflex ","duration":"1m 35s","follower_count":"191.3k","gpm":"$51.56","handle":"kid.shops","id":"7700682843906723103","original_duration":95.267,"publish_date":"2026/10/25 15:02:39","revenue":"$118.63k","revenueDiff":11786900,"revenue_grouping_rate":-2.0203332575437685,"revenue_trend":[0,0,379],"sale":313,"views":"2.3m","views_trend":[0,0,1681]},{"ad":1,"ad2Cost":"$23.83k","ad2Roas":3.53,"ad_cpa":"$77.61","ad_revenue_ratio":"72.70%","ad_view_ratio":"22.75%","ai_video":0,"collect_day":"2026-02-17","content_type":"video","creator_uid":"6546693901460832266","description":"Changed my life. ","duration":"2m 41s","follower_count":"5m","gpm":"$42.52","handle":"_jen_hamilton_","id":"7607862589363670285","original_duration":161.767,"publish_date":"2026/02/17 10:53:10","revenue":"$115.74k","revenueDiff":-9613500,"revenue_grouping_rate":-1.9762080055798814,"revenue_trend":[84825,16211,4901],"sale":307,"views":"2.72m","views_trend":[778386,334822,228177]},{"ad":1,"ad2Cost":"$11.08k","ad2Roas":4.1,"ad_cpa":"$1.35","ad_revenue_ratio":"50.33%","ad_view_ratio":"20.70%","ai_video":0,"collect_day":"2026-10-23","content_type":"multi_photo","creator_uid":"7569137951294620685","description":"","duration":"0m","follower_count":"3.19k","gpm":"$10.21","handle":"robertco.yuo","id":"7699847369348713742","original_duration":0,"publish_date":"2026/10/23 09:00:36","revenue":"$90.33k","revenueDiff":-4719000,"revenue_grouping_rate":-1.9624346998710007,"revenue_trend":[11935,32318,24508],"sale":8212,"views":"8.84m","views_trend":[1100000,3300000,2300000]}],"market":"US","notes":["Market US (United States): amounts are in USD.","Without a keyword the data source returns its fixed overall top 10 for the most recent days (window below), whatever window you ask for. Add a keyword to rank more rows over your own window."],"see_also":"Pass a row's id to video: method=detail, transcript, products, sales.","source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":6,"end":"2026-10-28","start":"2026-10-23"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"count":{"type":"integer"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"hasMore":{"type":"boolean"},"items":{"items":{"properties":{"ad":{"type":"integer"},"ad2Cost":{"type":"string"},"ad2Roas":{"type":"number"},"ad_cpa":{"type":"string"},"ad_revenue_ratio":{"type":"string"},"ad_view_ratio":{"type":"string"},"ai_video":{"type":"integer"},"collect_day":{"type":"string"},"content_type":{"type":"string"},"creator_uid":{"type":"string"},"description":{"type":"string"},"duration":{"type":"string"},"follower_count":{"type":"string"},"gpm":{"type":"string"},"handle":{"type":"string"},"id":{"type":"string"},"original_duration":{"type":"number"},"publish_date":{"type":"string"},"revenue":{"type":"string"},"revenueDiff":{"type":"integer"},"revenue_grouping_rate":{"type":"number"},"revenue_trend":{"items":{"type":"integer"},"type":"array"},"sale":{"type":"integer"},"views":{"type":"string"},"views_trend":{"items":{"type":"integer"},"type":"array"}},"type":"object"},"type":"array"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"type":"string"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Top-selling TikTok Shop videos","tags":["video_top_selling"],"x-credits":1,"x-mcp-method":"","x-mcp-tool":"video_top_selling"}},"/v1/videos/{id}":{"get":{"description":"This route: counts, creator, hashtags, sound, place, linked products, caption tracks.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7691522530129022221","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"caption":"the shiniest lips on the internet  @NOONI #noonipartner    #beauty #glitterlips #lipoil #kbeauty","comments":20,"creator":{"handle":"ingaterner","id":"6915470077362865158","nickname":"Inga Terner","secUid":"MS4wLjABAAAAj3-0_ug3CN2zVQW1fOIuVgtFq37iFz2-aQNDN9VLKT0Xa1rcEfAAybaLMhLsXCIu"},"durationSec":18,"hashtags":[{"id":"7305074851570516011","name":"noonipartner"},{"id":"5393","name":"beauty"},{"id":"206503","name":"glitterlips"}],"id":"7691522530129022221","language":"en","likes":1049,"posted":"2026-10-01T02:36:03Z","saves":207,"shares":39,"sound":{"author":"JERI","id":"7139362230881094442","original":true,"title":"ariana grande . ill do it"},"url":"https://www.tiktok.com/@ingaterner/video/7691522530129022221","views":22632},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"integer"},"hashtags":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"id":{"type":"string"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · detail","tags":["video"],"x-credits":1,"x-example-params":{"id":"7691522530129022221"},"x-mcp-method":"detail","x-mcp-tool":"video"}},"/v1/videos/{id}/captions":{"get":{"description":"This route: one caption file as WebVTT (subtitle_url, or the video id: English track first).\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_captions","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=captions: a caption URL from method=detail (captions[].url).","in":"query","name":"subtitle_url","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record."},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · captions","tags":["video"],"x-credits":1,"x-mcp-method":"captions","x-mcp-tool":"video"}},"/v1/videos/{id}/comment-themes":{"get":{"description":"This route: keywords TikTok extracts from the comments, with sample comments.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_comment_themes","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7691522530129022221","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"as_of":"2026-10-30T23:27:21Z","count":2,"has_more":false,"id":"7691522530129022221","items":[{"keyword":"looks amazing","sample_count":1,"samples":[{"date":"2026-10-02","id":"7692112068871275295","likes":1,"text":"Wow looks amazing"}]},{"keyword":"blonde hair","sample_count":1,"samples":[{"date":"2026-10-01","id":"7691593645211861782","likes":1,"text":"Hello There Inga i like very much how are You make-up and how lip-gloss you used in your make-up and she's stay very good and beautiful with your blonde hair Inga"}]}],"notes":["Keywords are TikTok's own extraction from the comments, in TikTok's order; sample_count is how many sample comments TikTok attached, not a total."],"see_also":["video method=comments id=7691522530129022221"],"source":"tiktok_live"},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"id":{"type":"string"},"items":{"items":{"properties":{"keyword":{"type":"string"},"sample_count":{"type":"integer"},"samples":{"items":{"properties":{"date":{"type":"string"},"id":{"type":"string"},"likes":{"type":"integer"},"text":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"notes":{"items":{"type":"string"},"type":"array"},"see_also":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · comment_themes","tags":["video"],"x-credits":1,"x-example-params":{"id":"7691522530129022221"},"x-mcp-method":"comment_themes","x-mcp-tool":"video"}},"/v1/videos/{id}/comments":{"get":{"description":"This route: top-level comments.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_comments","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7691522530129022221","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. comments and replies max 50, similar max 30; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","example":"3","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"method=comments: relevant (TikTok's order, default) or newest.","in":"query","name":"sort","required":false,"schema":{"enum":["relevant","newest"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"comments":[{"author":{"handle":"analuaviibe","nickname":"analuaviibe","secUid":"MS4wLjABAAAAgRqViSgAlnNZEzweJCo2ZHj8OIbUh6d7yCY1Vgw_UgHF0NZ8dTLMQMTQFs9gcxHD"},"id":"7693243163997602574","likes":0,"posted":"2026-10-05T17:53:31Z","replies":1,"text":"Did you use another product before the lip oil?"},{"author":{"handle":"tarapr1","nickname":"TaraPrit","secUid":"MS4wLjABAAAA5hvN8SlYQnPwFtES0p2gdlguyyFfsgq47T4roayZCqRQ6U-QuP4CUHtwRkMjCLqE"},"id":"7698536869424726785","likes":0,"posted":"2026-10-20T00:15:26Z","text":"All of those colours r so pretty!!!"},{"author":{"handle":"kc90887","nickname":"KC","secUid":"MS4wLjABAAAADAQWZ7VS3fs6sc1XqTuGaIl2F2ZuuEa5EKnnz73HyexjS69Ydy7VjObJJDbmEDiG"},"id":"7701658459657306912","likes":0,"posted":"2026-10-28T10:08:41Z","text":"Hammer geile Frau 😍🤗"}],"hasMore":true,"next":"eyJjdXJzb3IiOjN9","total":20},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"},"next_cursor":"eyJjdXJzb3IiOjN9"},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"comments":{"items":{"properties":{"author":{"properties":{"handle":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"id":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"replies":{"type":"integer"},"text":{"type":"string"}},"type":"object"},"type":"array"},"hasMore":{"type":"boolean"},"next":{"type":"string"},"total":{"type":"integer"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · comments","tags":["video"],"x-credits":1,"x-example-params":{"id":"7691522530129022221","limit":"3"},"x-mcp-method":"comments","x-mcp-tool":"video"}},"/v1/videos/{id}/comments/{comment_id}/replies":{"get":{"description":"This route: replies to one comment (comment_id).\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_comments_comment_id_replies","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7691522530129022221","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"method=replies: the comment id from method=comments.","example":"7701885045296956174","in":"path","name":"comment_id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. comments and replies max 50, similar max 30; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"comments":[],"hasMore":false},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"comments":{"type":"array"},"hasMore":{"type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · replies","tags":["video"],"x-credits":1,"x-example-params":{"comment_id":"7701885045296956174","id":"7691522530129022221"},"x-mcp-method":"replies","x-mcp-tool":"video"}},"/v1/videos/{id}/product-trend":{"get":{"description":"This route: daily sales of the video's products.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_product_trend","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7700682843906723103","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. comments and replies max 50, similar max 30; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","daily":[{"ad":0,"adTotalCost":0,"adTotalRoas":0,"ad_revenue_ratio":0,"ad_view_ratio":0,"new_followers":0,"partition_day":"2026-09-29","revenue":0,"sale":0,"views":0},{"ad":0,"adTotalCost":0,"adTotalRoas":0,"ad_revenue_ratio":0,"ad_view_ratio":0,"new_followers":0,"partition_day":"2026-09-30","revenue":0,"sale":0,"views":0},{"ad":0,"adTotalCost":0,"adTotalRoas":0,"ad_revenue_ratio":0,"ad_view_ratio":0,"new_followers":0,"partition_day":"2026-10-01","revenue":0,"sale":0,"views":0}],"dataEnd":"2026-10-28","id":"7700682843906723103","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"daily":{"items":{"properties":{"ad":{"type":"integer"},"adTotalCost":{"type":"integer"},"adTotalRoas":{"type":"integer"},"ad_revenue_ratio":{"type":"integer"},"ad_view_ratio":{"type":"integer"},"new_followers":{"type":"integer"},"partition_day":{"type":"string"},"revenue":{"type":"integer"},"sale":{"type":"integer"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · product_trend","tags":["video"],"x-credits":1,"x-example-params":{"id":"7700682843906723103"},"x-mcp-method":"product_trend","x-mcp-tool":"video"}},"/v1/videos/{id}/products":{"get":{"description":"This route: products sold through the video, with revenue.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_products","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7700682843906723103","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. comments and replies max 50, similar max 30; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"7700682843906723103","market":"US","notes":["Market US (United States): amounts are in USD."],"products":[{"id":"1732268320365777584","max_price":"$493.99","min_price":"$493.99","partition_day":"2026-10-29","percentage":100,"pri_cate_id":"Household Appliances","product_title":"Shark PowerPro Flex Reveal Plus Cordless Vacuum - IZ382H","revenue":118627,"sale":313,"sec_cate_id":"Home Appliances","ter_cate_id":"Vacuums \u0026 Floor Care"}],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"products":{"items":{"properties":{"id":{"type":"string"},"max_price":{"type":"string"},"min_price":{"type":"string"},"partition_day":{"type":"string"},"percentage":{"type":"integer"},"pri_cate_id":{"type":"string"},"product_title":{"type":"string"},"revenue":{"type":"integer"},"sale":{"type":"integer"},"sec_cate_id":{"type":"string"},"ter_cate_id":{"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · products","tags":["video"],"x-credits":1,"x-example-params":{"id":"7700682843906723103"},"x-mcp-method":"products","x-mcp-tool":"video"}},"/v1/videos/{id}/sales":{"get":{"description":"This route: revenue, units and ad metrics the video drove.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_sales","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7700682843906723103","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. comments and replies max 50, similar max 30; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"ads":{"ad2Cost":"$25.73k","ad2Roas":3.69,"ad_revenue_ratio":"80.00%","ad_view_ratio":"28.88%","video_id":"7700682843906723103"},"currency":"USD","dataEnd":"2026-10-28","id":"7700682843906723103","market":"US","notes":["Market US (United States): amounts are in USD."],"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","totals":{"day_new_followers":"0","day_revenue":"$3.95k","day_sale":"10.43","day_views":"76.7k","new_followers":"0","revenue":"$118.63k","sale":"313","video_id":"7700682843906723103","views":"2.3m"},"window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"ads":{"properties":{"ad2Cost":{"type":"string"},"ad2Roas":{"type":"number"},"ad_revenue_ratio":{"type":"string"},"ad_view_ratio":{"type":"string"},"video_id":{"type":"string"}},"type":"object"},"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"source":{"type":"string"},"totals":{"properties":{"day_new_followers":{"type":"string"},"day_revenue":{"type":"string"},"day_sale":{"type":"string"},"day_views":{"type":"string"},"new_followers":{"type":"string"},"revenue":{"type":"string"},"sale":{"type":"string"},"video_id":{"type":"string"},"views":{"type":"string"}},"type":"object"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · sales","tags":["video"],"x-credits":1,"x-example-params":{"id":"7700682843906723103"},"x-mcp-method":"sales","x-mcp-tool":"video"}},"/v1/videos/{id}/similar":{"get":{"description":"This route: videos TikTok relates to this one.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_similar","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7691522530129022221","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Results per page. comments and replies max 50, similar max 30; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","example":3,"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"hasMore":false,"videos":[{"caption":"no need to overpluck your brows anymore 😌 this gel locks every hair in place and keeps them there all day","comments":26,"creator":{"followers":2400000,"handle":"ingaterner","id":"6915470077362865158","nickname":"Inga Terner","secUid":"MS4wLjABAAAAj3-0_ug3CN2zVQW1fOIuVgtFq37iFz2-aQNDN9VLKT0Xa1rcEfAAybaLMhLsXCIu"},"durationSec":11,"id":"7652228657624272141","isAd":true,"language":"en","likes":4000,"posted":"2026-06-17T05:16:00Z","products":[{"id":"1731195873060032840","name":"The Brow Glue Crazy Lift, Brow","sellerId":"7495306581925726536","title":"The Brow Glue Crazy Lift, Brow Lamination Gel with 16HR Strong Hold \u0026 Built-In Styling Comb, NYX Professional Makeup"}],"saves":638,"shares":109,"sound":{"author":"ky","id":"7574176490877274935","original":true,"title":"original sound"},"url":"https://www.tiktok.com/@ingaterner/video/7652228657624272141","views":137700},{"caption":"@MAC Cosmetics night","comments":7,"creator":{"followers":2400000,"handle":"ingaterner","id":"6915470077362865158","nickname":"Inga Terner","secUid":"MS4wLjABAAAAj3-0_ug3CN2zVQW1fOIuVgtFq37iFz2-aQNDN9VLKT0Xa1rcEfAAybaLMhLsXCIu"},"durationSec":10,"id":"7673769596033191182","language":"en","likes":419,"posted":"2026-08-14T06:25:58Z","saves":31,"shares":1,"sound":{"author":"Trendformusic","id":"7532565244910308102","original":true,"title":"son original"},"url":"https://www.tiktok.com/@ingaterner/video/7673769596033191182","views":8160},{"caption":"my go-to nude shades this summer","comments":11,"creator":{"followers":2400000,"handle":"ingaterner","id":"6915470077362865158","nickname":"Inga Terner","secUid":"MS4wLjABAAAAj3-0_ug3CN2zVQW1fOIuVgtFq37iFz2-aQNDN9VLKT0Xa1rcEfAAybaLMhLsXCIu"},"durationSec":15,"id":"7658093031144295693","isAd":true,"language":"en","likes":403,"posted":"2026-07-03T00:32:32Z","products":[{"id":"1729401426661773360","name":"Lip Gloss","sellerId":"7495171395322742832","title":"Lip Gloss - High-Shine, Vanilla-Scented, Ultra Smooth Gloss with Luminous Finish Matte"}],"saves":101,"shares":5,"sound":{"author":"burner.wave","id":"7633979701119306510","original":true,"title":"burner wave pour it up x all the way turnt up"},"url":"https://www.tiktok.com/@ingaterner/video/7658093031144295693","views":10100}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"hasMore":{"type":"boolean"},"videos":{"items":{"properties":{"caption":{"type":"string"},"comments":{"type":"integer"},"creator":{"properties":{"followers":{"type":"integer"},"handle":{"type":"string"},"id":{"type":"string"},"nickname":{"type":"string"},"secUid":{"type":"string"}},"type":"object"},"durationSec":{"type":"integer"},"id":{"type":"string"},"isAd":{"type":"boolean"},"language":{"type":"string"},"likes":{"type":"integer"},"posted":{"type":"string"},"products":{"items":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"sellerId":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"saves":{"type":"integer"},"shares":{"type":"integer"},"sound":{"properties":{"author":{"type":"string"},"id":{"type":"string"},"original":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"url":{"type":"string"},"views":{"type":"integer"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · similar","tags":["video"],"x-credits":1,"x-example-params":{"id":"7691522530129022221","limit":3},"x-mcp-method":"similar","x-mcp-tool":"video"}},"/v1/videos/{id}/similar-revenue":{"get":{"description":"This route: how similar videos performed.\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_similar_revenue","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7700682843906723103","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Paging: pass the next value from the previous response unchanged. Omit on the first page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).","in":"query","name":"end","required":false,"schema":{"type":"string"}},{"description":"Results per page. comments and replies max 50, similar max 30; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.","in":"query","name":"region","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: custom range start, YYYY-MM-DD.","in":"query","name":"start","required":false,"schema":{"type":"string"}},{"description":"Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.","in":"query","name":"window","required":false,"schema":{"enum":["7d","30d","90d","180d","365d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"currency":"USD","dataEnd":"2026-10-28","id":"7700682843906723103","market":"US","notes":["Market US (United States): amounts are in USD."],"similar":{"revenue":[{"ad":1,"ai_video":0,"content_type":"video","create_time":"2026/10/21 19:35:52","creator_id":"7408927728046933038","description":"Which one do you think? #stickvacuum #petallergies #petparents #shark #sharkpowerproflex ","duration":"1m 22s","handle":"kid.shops","id":"7699268904157334815","music_title":"original sound - kid.shops","original_duration":81.834,"revenue":"$68.98k","sale":182,"views":"1.09m"},{"ad":1,"ai_video":0,"content_type":"video","create_time":"2026/10/25 17:47:08","creator_id":"7275090345011414059","description":"Which cordless vacuum is better? What price they have this one at today you can’t beat it.. #vacuum #cordlessvacuum #stickvacuum #sharkvacuum #cleaning ","duration":"1m 46s","handle":"dealswithty","id":"7700725240166436127","music_title":"original sound","original_duration":106,"revenue":"$65.95k","sale":174,"views":"1.3m"},{"ad":1,"ai_video":0,"content_type":"video","create_time":"2026/10/26 11:22:54","creator_id":"7289195477476262958","description":"Why pay more for a vacuum that does less… when you can pay less for one that does more?🤔 #vacuum #cleaning #petvacuum #sharkpowerproflexreveal ","duration":"1m 34s","handle":"ericsfindss","id":"7700997310842490126","music_title":"original sound","original_duration":94,"revenue":"$38.28k","sale":101,"views":"589.94k"}],"type":"product"},"source":"TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.","window":{"days":30,"end":"2026-10-28","start":"2026-09-29"}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"currency":{"type":"string"},"dataEnd":{"type":"string"},"id":{"type":"string"},"market":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"similar":{"properties":{"revenue":{"items":{"properties":{"ad":{"type":"integer"},"ai_video":{"type":"integer"},"content_type":{"type":"string"},"create_time":{"type":"string"},"creator_id":{"type":"string"},"description":{"type":"string"},"duration":{"type":"string"},"handle":{"type":"string"},"id":{"type":"string"},"music_title":{"type":"string"},"original_duration":{"type":"number"},"revenue":{"type":"string"},"sale":{"type":"integer"},"views":{"type":"string"}},"type":"object"},"type":"array"},"type":{"type":"string"}},"type":"object"},"source":{"type":"string"},"window":{"properties":{"days":{"type":"integer"},"end":{"type":"string"},"start":{"type":"string"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · similar_revenue","tags":["video"],"x-credits":1,"x-example-params":{"id":"7700682843906723103"},"x-mcp-method":"similar_revenue","x-mcp-tool":"video"}},"/v1/videos/{id}/transcript":{"get":{"description":"This route: existing captions as plain text (nothing is transcribed).\n\nEverything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold. Use the post id or link from any other tool. Examples: {\"id\":\"https://vt.tiktok.com/...\",\"method\":\"transcript\"}, {\"id\":\"7694...\",\"method\":\"sales\"}. method=comment_themes lists the keywords TikTok extracts from the comments, each with sample comments. Example: {\"id\":\"7691388445251439924\",\"method\":\"comment_themes\"}.","operationId":"GET_videos_id_transcript","parameters":[{"description":"Video or photo post: a TikTok link (short vm./vt. links work), or the numeric post id (videos[].id). Not needed for method=captions.","example":"7691522530129022221","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"compact (default) returns the useful fields; full adds the full raw record (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"method=transcript: preferred caption language, e.g. en.","in":"query","name":"language","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"available":[],"message":"TikTok has no captions for this video, so there is no transcript. Nothing was transcribed or generated.","noCaptions":true,"segments":[],"text":"","video":{"authorUniqueId":"ingaterner","desc":"the shiniest lips on the internet  @NOONI #noonipartner    #beauty #glitterlips #lipoil #kbeauty ","durationMs":18000,"id":"7691522530129022221","playCount":22632}},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"available":{"type":"array"},"message":{"type":"string"},"noCaptions":{"type":"boolean"},"segments":{"type":"array"},"text":{"type":"string"},"video":{"properties":{"authorUniqueId":{"type":"string"},"desc":{"type":"string"},"durationMs":{"type":"integer"},"id":{"type":"string"},"playCount":{"type":"integer"}},"type":"object"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"One TikTok video · transcript","tags":["video"],"x-credits":1,"x-example-params":{"id":"7691522530129022221"},"x-mcp-method":"transcript","x-mcp-tool":"video"}},"/v1/videos/{video}/giveaway":{"post":{"description":"Draws giveaway winners at random from a video's comments, with optional filters (must_include, unique users, exclude the creator). A seed makes the draw reproducible. Reports how many comments were eligible.","operationId":"POST_videos_video_giveaway","parameters":[{"description":"Post id or full https://www.tiktok.com/@creator/video/\u003cid\u003e URL.","example":"7691522530129022221","in":"path","name":"video","required":true,"schema":{"type":"string"}},{"description":"full adds TikTok's raw payload (large).","in":"query","name":"detail","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Exclude comments by the video's creator.","in":"query","name":"exclude_creator","required":false,"schema":{"default":true,"type":"boolean"}},{"description":"Comments to fetch, in pages of 50.","in":"query","name":"max_comments","required":false,"schema":{"default":300,"type":"integer"}},{"description":"Optional text a comment must contain (case-insensitive), e.g. a hashtag or keyword.","in":"query","name":"must_include","required":false,"schema":{"type":"string"}},{"description":"Optional seed for a reproducible draw. Publish it so anyone can re-run the draw.","in":"query","name":"seed","required":false,"schema":{"type":"string"}},{"description":"Count each commenter once (their earliest fetched comment).","in":"query","name":"unique_users","required":false,"schema":{"default":true,"type":"boolean"}},{"description":"How many winners to draw.","in":"query","name":"winners","required":false,"schema":{"default":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"awemeId":"7691522530129022221","coverage":0.95,"eligible":16,"excluded":{"duplicateUser":3},"fairness":"Only the 19 fetched top-level comments were eligible; replies, hidden, filtered or deleted comments are not included. TikTok returns comments in its own order, so on large videos the fetched set is TikTok's selection, not a random sample of all comments. TikTok reports 20 comments; 19 were fetched.","fetched":19,"pages":1,"random":"crypto/rand (not reproducible; pass seed for a verifiable draw)","rules":{"creatorHandle":"ingaterner","excludeCreator":true,"maxComments":300,"mustInclude":"","uniqueUsers":true,"winners":1},"seed":null,"totalReported":20,"winners":[{"authorNickname":"R.","authorUniqueId":"r9079756","createTime":1791056562,"diggCount":0,"id":"7692529272121000725","isAuthor":false,"text":"😳😳😳"}]},"meta":{"credits_charged":1,"credits_remaining":7906,"request_id":"req_3f9c2a1b7d4e"}},"schema":{"properties":{"data":{"description":"The tool's result. Compact by default; pass detail=full for the complete record.","properties":{"awemeId":{"type":"string"},"coverage":{"type":"number"},"eligible":{"type":"integer"},"excluded":{"properties":{"duplicateUser":{"type":"integer"}},"type":"object"},"fairness":{"type":"string"},"fetched":{"type":"integer"},"pages":{"type":"integer"},"random":{"type":"string"},"rules":{"properties":{"creatorHandle":{"type":"string"},"excludeCreator":{"type":"boolean"},"maxComments":{"type":"integer"},"mustInclude":{"type":"string"},"uniqueUsers":{"type":"boolean"},"winners":{"type":"integer"}},"type":"object"},"seed":{"type":"null"},"totalReported":{"type":"integer"},"winners":{"items":{"properties":{"authorNickname":{"type":"string"},"authorUniqueId":{"type":"string"},"createTime":{"type":"integer"},"diggCount":{"type":"integer"},"id":{"type":"string"},"isAuthor":{"type":"boolean"},"text":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"next_cursor":{"description":"Present when there is another page: pass it back as cursor.","type":"string"}},"required":["data","meta"],"type":"object"}}},"description":"OK. One credit was charged.","headers":{"Request-Id":{"description":"Quote it to support.","schema":{"type":"string"}},"TokConnect-Credits-Charged":{"description":"1 on success, 0 otherwise.","schema":{"type":"integer"}},"TokConnect-Credits-Remaining":{"description":"Credits left this period.","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}},"summary":"Comment giveaway draw","tags":["pick_comment_winners"],"x-credits":1,"x-example-params":{"video":"7691522530129022221"},"x-mcp-method":"","x-mcp-tool":"pick_comment_winners"}}},"security":[{"bearer":[]},{"apiKey":[]}],"servers":[{"description":"Production","url":"https://api.tokconnect.com"}],"tags":[{"description":"TikTok's library of top-performing ads: search by keyword, one ad's detail (countries it ran in, CTR, likes, objective, landing page, video), analysis (TikTok's per-second retention curve and the ad's CTR percentile against other ads), and similar ads.","name":"ad_library","x-displayName":"TikTok top ads library"},{"description":"[Shop Analytics] The top TikTok Shop categories by estimated revenue over the last 7 days of data: revenue, units, growth, revenue per shop, top-3 and top-10 shop share, split by video, LIVE and affiliate.","name":"category_trends","x-displayName":"TikTok Shop category trends"},{"description":"TikTok's own leaderboards.","name":"charts","x-displayName":"TikTok charts"},{"description":"TikTok Creative Center: top videos by market (US, JP, VN, TH, ID), public SEO inspiration lists, and Creative Partner agency leaderboards.","name":"creative_center","x-displayName":"TikTok Creative Center"},{"description":"One creator's public account: profile (followers, likes, bio, Shop seller status; counts are rounded the way the app shows them, so use creator_search with the handle for exact numbers), posts, reposts, liked posts, followers, following, embed posts, playlists and collections.","name":"creator","x-displayName":"One TikTok creator"},{"description":"What a creator sells.","name":"creator_commerce","x-displayName":"A creator's TikTok Shop business"},{"description":"One creator playlist or saved collection (id from creator method=playlists or method=collections): detail or its videos.","name":"creator_playlist","x-displayName":"One playlist or collection"},{"description":"Searches TikTok accounts by keyword (name, handle or niche), as TikTok's account search returns them now, with follower bounds, verified-only and sorting applied to the page.","name":"creator_search","x-displayName":"Search TikTok accounts"},{"description":"[Shop Analytics] Creators (affiliates) ranked by the sales they drove over a date range: revenue, units, followers, engagement, views, trend.","name":"creator_top_selling","x-displayName":"Top-selling TikTok Shop creators"},{"description":"Finds what people search on TikTok (Creator Search Insights).","name":"demand_find_topics","x-displayName":"Find TikTok search topics"},{"description":"Autocomplete and keyword ideas from TikTok and TikTok Shop.","name":"demand_keywords","x-displayName":"Keyword suggestions"},{"description":"Everything about one search topic (id = queryId from demand_find_topics): detail, daily popularity chart, searcher demographics, related searches, TikTok's content guidance and matching videos.","name":"demand_topic","x-displayName":"One TikTok search topic"},{"description":"One hashtag (id from hashtag_search or hashtags[].id on a post): detail, its videos (hot or newest), or related hashtags.","name":"hashtag","x-displayName":"One hashtag"},{"description":"Finds hashtags by keyword, with total views and video counts for each.","name":"hashtag_search","x-displayName":"Find hashtags"},{"description":"One LIVE room (id = room id from live_search or live_top_selling).","name":"live","x-displayName":"One TikTok LIVE"},{"description":"Finds TikTok LIVE broadcasts on now by keyword, with viewers and whether the room sells Shop products.","name":"live_search","x-displayName":"Search LIVE now"},{"description":"[Shop Analytics] The top 10 LIVE broadcasts by estimated revenue over a date range, with host, start and end time, duration, units, GPM and average price.","name":"live_top_selling","x-displayName":"Top-selling TikTok Shop LIVEs"},{"description":"Draws giveaway winners at random from a video's comments, with optional filters (must_include, unique users, exclude the creator).","name":"pick_comment_winners","x-displayName":"Comment giveaway draw"},{"description":"One tagged place: business, venue or landmark (id from place_search, a post's place.id, or a place link): detail, videos tagged there, or TikTok's public reviews.","name":"place","x-displayName":"One place"},{"description":"Finds TikTok places (businesses, venues, landmarks) by keyword, each with its poi id, name, category, address, city, country and tagged video count.","name":"place_search","x-displayName":"Place / POI search"},{"description":"Everything about one TikTok Shop product (id = product id or a Shop product link).","name":"product","x-displayName":"One TikTok Shop product"},{"description":"[Shop Analytics] Products ranked by estimated sales over a date range: revenue, units, video/LIVE/showcase split, growth, price, commission, creators, launch date, daily trend.","name":"product_top_selling","x-displayName":"Top-selling TikTok Shop products"},{"description":"Static lists other tools need: Creator Search Insights channels and languages, Explore category ids, LIVE gift coin prices, Ad Library regions, Creative Partner markets, and the Shop Analytics filters and sort fields.","name":"reference","x-displayName":"Reference lists"},{"description":"Everything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=\u003cshop name\u003e).","name":"shop","x-displayName":"One TikTok Shop seller"},{"description":"What a shopper sees on TikTok Shop (US store) right now: search results, keyword and category pages, deals and flash sales.","name":"shop_browse","x-displayName":"Browse TikTok Shop now"},{"description":"Lists the TikTok Shop markets Shop Analytics covers, with each market's currency, language and tier.","name":"shop_regions","x-displayName":"Shop Analytics markets"},{"description":"[Shop Analytics] TikTok Shop sellers ranked by estimated sales over a date range: revenue, units, growth, average price, and revenue split across own accounts, affiliates and the mall.","name":"shop_top_selling","x-displayName":"Top-selling TikTok Shop sellers"},{"description":"One TikTok sound (id = sound id from any post or sound_search, or a sound link): detail or the videos using it.","name":"sound","x-displayName":"One sound"},{"description":"Finds TikTok sounds by keyword, or lists TikTok's hot sounds, beats and licensed music.","name":"sound_search","x-displayName":"Find sounds"},{"description":"Everything about one video or photo post: detail, comments, replies, caption transcript, similar videos, and [Shop Analytics; region picks the market] the revenue it drove and the products it sold.","name":"video","x-displayName":"One TikTok video"},{"description":"Samples TikTok's own feeds: For You (as a neutral US viewer), Explore categories, and Discover creators/hashtags/sounds.","name":"video_feed","x-displayName":"TikTok feeds"},{"description":"Searches TikTok posts by keyword, as TikTok's own search returns them now: views, likes, comments, shares, saves, creator, hashtags, sound and linked Shop products.","name":"video_search","x-displayName":"Search TikTok videos"},{"description":"[Shop Analytics] The top 10 shoppable videos by estimated revenue over a date range, with revenue, units, views, GPM, ad metrics (CPA, ROAS, ad revenue share), whether it is AI-generated, and the creator.","name":"video_top_selling","x-displayName":"Top-selling TikTok Shop videos"}],"x-tagGroups":[{"name":"Products","tags":["product","product_top_selling"]},{"name":"Shops","tags":["shop","shop_browse","shop_top_selling"]},{"name":"Creators","tags":["creator","creator_commerce","creator_playlist","creator_search","creator_top_selling"]},{"name":"Videos","tags":["video","video_feed","video_search","video_top_selling"]},{"name":"LIVE","tags":["live","live_search","live_top_selling"]},{"name":"Categories","tags":["category_trends"]},{"name":"Charts","tags":["charts"]},{"name":"Ads and Creative Center","tags":["ad_library","creative_center"]},{"name":"Demand and keywords","tags":["demand_find_topics","demand_keywords","demand_topic"]},{"name":"Hashtags and sounds","tags":["hashtag","hashtag_search","sound","sound_search"]},{"name":"Places","tags":["place","place_search"]},{"name":"Helpers","tags":["pick_comment_winners"]},{"name":"Markets and reference","tags":["reference","shop_regions"]}]}