TikTok Place Photos API

Endpoint facts

Method

GET

API path

/tiktok/mobile/place/photos

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.placePhotosResponseDoc

How this endpoint behaves

One place's photo album, keyed by the poi_id the place search endpoint returns. The upstream is GET /tiktok/poi/picture_album/v1, captured from the running 47.4.3 app on the place detail screen and reproduced end-to-end against the live gateway. This is the photo tab of the place page: the albums the app groups the place's pictures into, with per-photo attribution.

Album categories, with attribution. categories holds each album tab. A measured category carries name, pic_tab_typecode, pictures (bare image URL lists) and pictures_v2 (the same photos with author attribution, pic_id, source and origin/compressed URL info). For the measured places the photos are Google-places images, and pictures_v2[].author names the contributor (keyword like @Ohhitskel) plus their Google Maps contribution link. photo_count sums the categories' pictures and title is the app's own header (e.g. "Gallery (3)"). category_tab_info is the tab strip the app renders.

One-shot. count and pic_tab_typecode were measured and did not change the page, so the album is returned whole; there is no cursor to page.

Device-free. The pure-Go placeholder signer returned the same album, so a deployment needs TIKTOK_MOBILE_PARAMS but not the device-backed signer (TIKTOK_MOBILE_SIGNER_URL). It answers on the core aggr16-normal.tiktokv.us / api16-normal-useast5.tiktokv.us pair.

Query parameters:

• poi_id: required. The numeric place id from /api/v1/tiktok/mobile/search/place.

Errors:

• 400 — poi_id is missing or not numeric.
• 500 — the upstream failed. Unlike the other two place routes, the album route answers upstream status 4 "Server is currently unavailable" for a nonexistent id (measured), so a bad id surfaces as a 500 here.

Measured 2026-10-21 (placeholder/device-free signer, core pair):

Example request:

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

Example response (truncated):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "poi_id": "42203861086875992",
    "title": "Gallery (3)",
    "categories": [
      {
        "name": "Other",
        "pic_tab_typecode": "080000",
        "pictures": [{"url_list": ["https://lh3.googleusercontent.com/grass-cs/...=s1600-w720"]}],
        "pictures_v2": [
          {
            "pic_id": "19e8e8efc0aecb623c7c9665f5cecec5",
            "source": "google",
            "author": {"keyword": "@Ohhitskel", "link": {"url_list": ["https://maps.google.com/maps/contrib/..."]}},
            "origin_url_info": {"url_list": ["..."]},
            "compressed_url_info": {"url_list": ["..."]}
          }
        ]
      }
    ],
    "category_tab_info": [{"name": "Other", "pic_tab_typecode": "080000"}],
    "photo_count": 3,
    "host": "aggr16-normal.tiktokv.us",
    "fetched_at": "2026-10-21T16:31:40Z"
  }
}

Notes for callers:

• The image URLs are the place provider's own CDN links (Google user content in the measured places); they are not TikTok CDN URLs and can expire, so re-fetch the album rather than persisting a URL long-term.
• photo_count counts pictures when present, falling back to pictures_v2; the two arrays describe the same photos.
• For the rest of the place page use place detail or place info.

Shared guides

Related