TikTok Place Detail API

Endpoint facts

Method

GET

API path

/tiktok/mobile/place/detail

Auth

apiKey

Credits

8 credits/request

Charged on

Successful 2xx responses only

Platform

TikTok

Execution

Managed browser rendering where the target needs it

Response schema

#/definitions/tiktokmobile.placeDetailResponseDoc

How this endpoint behaves

One place detail page, keyed by the poi_id the place search endpoint returns. The upstream is TikTok's server-driven UI (slash) service — GET /tiktok/poi/slash/v1 — captured from the running 47.4.3 app when a place card in the search screen's Places tab is opened and reproduced end-to-end against the live gateway. This is the page behind a place card: the header, the top-videos strip, the posts about the place and the review preview.

Frame stream, assembled for you. The upstream answers the same length-prefixed JSON frame stream the streaming search route uses (hex byte length, CRLF, JSON payload, CRLF, 0 terminator). This endpoint assembles all frames: nodes merges every frame's component map (later frames update earlier components), frames keeps the raw ordered frames, layout merges the frame layouts, and page_id is the SDUI page id.

The node map is the page. The measured component names are:

Typed counters lift the node data you page or judge a place by: top_video_count, post_count, post_cursor, has_more_posts, review_count, has_more_reviews.

Device-free. The route is not signature-value gated: the pure-Go placeholder signer returned the same full page (945,190 B with header, videos, posts and review), so the deployment does not need the device-backed signer (TIKTOK_MOBILE_SIGNER_URL) for this endpoint. It does need the api32-normal-useast5.tiktokv.us origin header, which the service sends; without it the gateway answers HTTP 455.

Query parameters:

• poi_id: required. The place id from /api/v1/tiktok/mobile/search/place (poi_info rows).
• review_count: optional. Review-preview size forwarded upstream; default is the app's 20, bounded at 50.
• review_cursor: optional. Review cursor forwarded upstream; default 0.
• merged_count: optional. Posts page size forwarded upstream; default is the app's 9, bounded at 50.
• video_cursor: optional. Top-videos cursor forwarded upstream; default 0.
• enter_from: optional. Analytics origin forwarded upstream; default search_places (the app's value from the Places tab).

Control caveat. The page-size controls are forwarded but are not a hard cap: merged_count=9 returned 5–9 posts and merged_count=3 returned 6, i.e. the server applies its own bounds. Treat the returned counters as the truth for what the page holds.

Measured 2026-10-21 (aggr32-normal.tiktokv.us edge / api32-normal-useast5.tiktokv.us origin):

Example request:

GET /api/v1/tiktok/mobile/place/detail?poi_id=42203861086875992

Example response (truncated):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "poi_id": "42203861086875992",
    "page_id": "100614404",
    "frame_count": 4,
    "nodes": {
      "food_head_info": {
        "data": {
          "poi_name": "Nam Coffee",
          "formatted_address": "304 Ord St, Los Angeles, CA 90012, USA",
          "category_name": "Coffee Shop",
          "recommend_score": {"score": "4.4", "max_score": "5.0", "mentioned_count": "33", "desc": "Good choice"},
          "store_info": {"OpeningHoursForPoiDetail": "Opens 8:00 AM"},
          "location": {"lat": "34.060090", "lng": "-118.239007"}
        }
      },
      "poi_top_videos": {"data": {"item_list": [{"item_type": 1, "aweme_topic_tag_en": "Iced Vietnamese Coffee"}]}},
      "poi_limited_post": {"data": {"item_list": [], "aweme_cursor": 9, "has_more_aweme": 1}},
      "poi_review": {"data": {"reviews": [], "has_more": 0}}
    },
    "top_video_count": 6,
    "post_count": 9,
    "post_cursor": 9,
    "has_more_posts": true,
    "review_count": 3,
    "has_more_reviews": false,
    "host": "aggr32-normal.tiktokv.us"
  }
}

Shared guides

Related