TikTok Shop

TikTok Shop Resolve

Resolve any TikTok Shop URL or share link to a product_id or shop_id, ready to pass to the other TikTok Shop endpoints, plus a canonical https URL for the item. Accepts canonical product and store pages, tiktok.com/view links, affiliate share links, and vt.tiktok.com short links. The app deeplinks TikTok returns internally are never surfaced; the URL in the response is synthesized from the resolved id. Costs 1 credit per request.

POST/api/v1/tiktok-shop/resolve

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

urlstringrequired

A TikTok Shop URL or share link, up to 2000 characters. Accepted forms: shop.tiktok.com/<region>/pdp/... product pages, shop.tiktok.com/<region>/store/... store pages, tiktok.com/view/product/<id>, tiktok.com/view/shop/<id>, affiliate-*.tiktok.com share links, and vt.tiktok.com or tiktok.com/t short links. Anything else answers 400 and is not billed.

Example: https://vt.tiktok.com/ZT2AHoGsE/

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tiktok_shop.resolve(url="https://vt.tiktok.com/ZT2AHoGsE/")
print(results)

Response

"type": "shop",

"product_id": null,

"shop_id": "7495832087428237549",

"url": "https://shop.tiktok.com/us/store/7495832087428237549",

"resolved_by": "share_link"

"response_time": 1120,

"credits_used": 1,

"credits_remaining": 4810

}