TikTok Shop ID by Share Link

API docs
https://api.sandbase.ai/v1/api/tiktok/shop-web/shop-id-by-share-link

Resolves a TikTok Shop share URL into its corresponding store identifiers. Returns the numeric shop ID and internal store app link using a valid share link.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
1 required · 0 optional

Playground

Input
OutputReady

Your output will appear here

Complete the inputs, then click Run.

API README

TikTok Shop ID by Share Link API

Resolves a TikTok Shop share link into the numeric shop ID and an in-app store link. It needs one input, share_link, which is a TikTok Shop share URL such as https://vt.tiktok.com/ZT2AHoGsE/.

Use cases

  • Convert a shortened shop share URL into a numeric shop_id you can store in a database.
  • Deduplicate shop links collected from different campaigns by comparing their shop_id values.
  • Pull the sellerId out of a shared store link to identify the seller behind it.
  • Turn a share URL into a store ID before you look up that shop's products.

Request

curl -X POST "https://api.sandbase.ai/v1/api/tiktok/shop-web/shop-id-by-share-link" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"share_link": "https://vt.tiktok.com/ZT2AHoGsE/"}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
share_linkstringYesShare link

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "shop_id": "7495832087428237549",
  "shop_link": "snssdk1180://ec/store?sellerId=7495832087428237549&store_page_version=2&trackPar…"
}

Response fields

FieldMeaning
shop_idNumeric ID of the TikTok Shop, returned as a string. It is the same value as sellerId inside shop_link.
shop_linkIn-app deep link to the store page, using the snssdk1180://ec/store scheme. The query string holds sellerId, store_page_version and URL-encoded trackParams.

Notes

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Explore more

Related APIs

All APIs
APIPriceResponse
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON

Questions

FAQ

How do I use the TikTok Shop ID by Share Link API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/shop-web/shop-id-by-share-link with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the TikTok Shop ID by Share Link API cost?

$0.001 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the TikTok Shop ID by Share Link API accept?

Required: share_link (string). The Parameters table and the Playground on this page list every field.

What does the TikTok Shop ID by Share Link API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a TikTok developer account or API key?

No. TikTok Shop ID by Share Link runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.