Search live

search · $0.0040

The LIVE tab.

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

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/live \
  -H "authorization: Bearer $SORINA_KEY" \
  -H 'content-type: application/json' \
  -d '{"keyword":"nasa","offset":0,"count":10}'

What comes back

JSON, around 679 KB for seventeen results. A third container again: results are under data, each element {type, lives}.

data[].lives is a video-shaped object with a room field, and room is where the stream itself lives — viewer counts and stream URLs.

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/photos