/v1/tiktok/user/showcase

GET

User Showcase

Get products from a TikTok user's public showcase.

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`handle` The handle of the user	query / required	`string`
`region` Proxy region. Non-US regions are unreliable and may return limited or inconsistent showcase data.	query / optional	`string`
`cursor` The cursor to the next page of products	query / optional	`string`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/tiktok/user/showcase?handle=YOUR_HANDLE' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/tiktok/user/showcase?handle=YOUR_HANDLE", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/tiktok/user/showcase?handle=YOUR_HANDLE",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

productsrequired

array

Array items

object

product_idrequired

string

titlerequired

string

imagerequired

object

heightrequired

integer

widthrequired

integer

urirequired

string

url_listrequired

array

Array items

string

product_price_inforequired

object

sku_idrequired

string

symbol_positionrequired

integer

show_currency_spacerequired

boolean

currency_show_moderequired

integer

currency_namerequired

string

currency_symbolrequired

string

sale_price_decimalrequired

string

origin_price_decimalrequired

string

sale_price_formatrequired

string

origin_price_formatrequired

string

discount_formatrequired

string

discount_decimalrequired

string

single_product_price_formatrequired

string

single_product_price_decimalrequired

string

sale_price_integer_part_formatrequired

string

sale_price_decimal_part_formatrequired

string

decimal_point_symbolrequired

string

promotion_deduction_detailsrequired

object

seller_subtotal_deductionrequired

string

seller_subtotal_deduction_decimalrequired

string

rate_inforequired

object

scorerequired

number

review_countrequired

integer

sold_inforequired

object

sold_countrequired

integer

seller_inforequired

object

seller_idrequired

string

seo_urlrequired

object

updated_atrequired

null

canonical_urlrequired

string

slugrequired

string

typerequired

integer

versionrequired

integer

cursorrequired

string

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited