Search places

search · $0.0040

The Places tab.

POST https://api.sorina.sh/v1/tiktok/search/places

Body

fieldtypewhat it is

keyword string

What to search for.

offset integer?

Where to start. 0 for the first page; then the cursor the last page returned.

count integer?

Page size. Defaults to 20.

search_id string?

Required from the second page on: the first page’s x-tt-logid.

A type written with ? is optional. Unknown fields are rejected rather than ignored, and the whole body is capped at 64 KiB.

Example

curl -X POST https://api.sorina.sh/v1/tiktok/search/places \
  -H "authorization: Bearer $SORINA_KEY" \
  -H 'content-type: application/json' \
  -d '{"keyword":"nasa","offset":0,"count":10}'

What comes back

JSON, and by far the smallest vertical — under 3 KB for one result. The results are nested: poi_info.poi_info, not poi_info itself.

Each place carries poi_id_str, poi_name, poi_type, poi_location as a full street address, lat, lng, video_count, poi_rating, price_level and opening_time.

The distance fields (poi_distance, user_to_poi_distance_*) come back empty. They are computed from the caller’s location, and there is no location to compute from — do not build on them.

cursor is what to send as the next offset; has_more is an integer.

pages on offset

Send the value the previous response returned, not one you counted. Page two and later must also carry the first page's x-tt-logid back as search_id, or the call is refused with 400 search_id_required. Pagination has the rest.

/search/music

/search/photos