AGagentkey
ecommerce/tiktok_shop

List buyer reviews of a TikTok Shop product. Returns a normalized Review page.

Buyer reviews of one product listing on TikTok Shop, by product ID or URL. Normalized to the Review object; page with next_cursor.

Fixed price: 0.2 credits per successful call, whichever provider serves it.

post/v2/ops/ecommerce.tiktok_shop.product.reviews

Request

  • Base URL
    https://api.agentkey.app
  • URL
    https://api.agentkey.app/v2/ops/ecommerce.tiktok_shop.product.reviews
  • Auth
    HTTP bearer

Request body

cursorstring

Opaque pagination cursor from the previous response's next_cursor. Send the same parameters with it.

fieldsstring[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

filter'all' | 'positive' | 'negative' | 'with_images'

all; positive = 5-star only; negative = 1-star only; with_images = reviews carrying photos or video (the upstream filters by exact star).

id_or_urlstring required

Product id, a /product/<id> or /view/product/<id> URL, ?product_id=, or the shop.tiktok.com/<cc>/pdp/<slug>/<id> page the cards link to.

include_rawboolean

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

limitinteger

Maximum number of reviews to return.

providerstring

Shorthand for routing.only = [provider].

region'US' | 'GB' | 'SG' | 'MY' | 'PH' | 'TH' | 'VN' | 'ID'

TikTok Shop market the product is listed in (ISO 3166-1 alpha-2).

sort'latest' | 'top'

latest = newest first; top = most helpful / the platform's default ordering.

Response

Success envelope

credits_chargednumber required

Credits charged for this call (the method's fixed price).

opstring required

Method name.

op_versioninteger required

Method version that served the call.

providerstring required

Provider that actually served the call.

rawunknown
raw_truncatedboolean
request_idstring required

Correlation id; quote it in support requests.

took_msinteger required
unsupported_fieldsstring[] required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

Changes

No recorded changes to this operation across all 1 revision of this API.