tiktok.com
TikTok Shop API
Query public TikTok Shop data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Searches for products from the TikTok Shop in 10 countries with prices in local currency, images, reviews, sales, shipping, coupons and promotions when informed by origin. Cost: 5 credits per requisition (one page).
GeckoAPI is independent of TikTok Shop. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search products
tiktok.com:plp
Searches for products from the TikTok Shop in 10 countries with prices in local currency, images, reviews, sales, shipping, coupons and promotions when informed by origin. Cost: 5 credits per requisition (one page).
5 credits per request
Get product details
tiktok.com:pdp
Consult a product from the TikTok Shop in 10 countries by ID or URL: prices, variants, reported stock, images, sales and store evaluation, product reviews, specifications and description when available. Cost: 5 credits per successful request.
5 credits per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Coverage and limitations
Choose BR, MX, JP, ID, MY, PH, SG, TH, VN or FR. Search takes a keyword and pages 1–20; follow hasMore/nextPage. Product details take productId or a full URL. Keep the same region from search to product. Description, reference price and seller ratings may be absent. Invalid upstream products cause extraction errors rather than empty successful products.
The product must belong to the selected country. Prices may include offers and promotions. Reported stock does not guarantee checkout availability. Description and other optional fields may be null; that does not indicate failure when the main product data is available.
Each item is a product with commercial data extracted from the mobile response. Products repeated across blocks and video/live cards are deduplicated by productId. Unavailable fields return null; lists without data return []. Prices are offers shown in search and may depend on coupons or promotions; they are not final checkout prices. The source may require verification. For variant-level prices and stock of a specific product, use TikTok Shop PDP (type=pdp) with the productId returned by this search.
Make your first request
The example uses search products. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target": "tiktok.com",
"type": "plp",
"keyword": "panela antiaderente",
"page": 1,
"region": "BR"
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "7a0c0e3f-7d85-4d9b-a57d-730527fb8f40",
"executionId": "6dfd2e49-e431-4375-8db1-f3b1eeefdf28",
"data": {
"source": "tiktok.com",
"type": "plp",
"query": "panela antiaderente",
"region": "BR",
"currency": "BRL",
"extractedAt": "2026-09-08T16:00:05.414621+00:00",
"page": 1,
"resultsPerPage": 10,
"primaryResults": 10,
"totalResults": null,
"hasMore": true,
"nextPage": 2,
"nextCursor": 10,
"items": [
{
"position": 1,
"productId": "1734492858853524507",
"name": "Jogo De Panelas 10 Peças Antiaderente, Conjunto com, Panela, Caçarola, Frigideira, Fervedor E Utensilios De Nylon, Tampas De Vidro",
"sellerName": "Loja do Chefe",
"shopId": "7494391956289913883",
"price": 154.99,
"displayPrice": "R$154,99",
"currency": "BRL",
"regularPrice": 189.99,
"displayRegularPrice": "R$ 189,99",
"discountPercentage": 18,
"discountText": "18%",
"priceType": "displayed_offer",
"rating": 4.3,
"soldCount": 1912,
"soldCountText": "1.9K sold",
"image": {
"url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/4588128ff7c0438cb61ed7cc9bab5cb6~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
"width": 400,
"height": 400,
"originalWidth": 1254,
"originalHeight": 1254
},
"appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221734492858853524507%22%5D%7D"
},
{
"position": 2,
"productId": "1737092330571728141",
"name": "Conjunto Jogo de Panelas 16 a 24 Antiaderente Teflon Panelas Grande Tampa de Vidro",
"sellerName": "House Home BR",
"shopId": "7494291074663023885",
"price": 229.99,
"displayPrice": "R$229,99",
"currency": "BRL",
"regularPrice": 350,
"displayRegularPrice": "R$ 350,00",
"discountPercentage": 34,
"discountText": "34%",
"priceType": "displayed_offer",
"rating": 4.9,
"soldCount": 1161,
"soldCountText": "1.2K sold",
"image": {
"url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/0f3ce119648245e3a770fc7d654e13c4~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
"width": 400,
"height": 400,
"originalWidth": 1200,
"originalHeight": 1200
},
"appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737092330571728141%22%5D%7D"
}
]
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the TikTok Shop API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.