Tiktok

Full Keyword Search

Fetch all possible posts for a given keyword from the Tiktok mobile app search video bar according to filter based on time. This API automatically manages the pagination for our 'Keyword Search' endpoint. This is a convenience endpoint which internally calls the 'Keyword Search' endpoint repeatedly (iterating the cursor) to collect all the posts for a given keyword in one api call.

API Pricing (per request): #returned_posts / 20 units

Try the API

get/tt/keyword/full-search

Request

  • Base URL: https://ensembledata.com/apis
  • URL: https://ensembledata.com/apis/tt/keyword/full-search
  • Auth: none declared

Query parameters

namestring required

The keyword to search.

period'0' | '1' | '7' | '30' | '90' | '180' required

An enumeration.

Only return posts more recent than the given period. The value corresponds to the number of days to filter on.

sorting'0' | '1' | '2'

An enumeration.

The posts are sorted by relevance if sorting=0, by most liked if sorting=1, most recent if sorting=2.

countrystring

Retrieve the posts as if in the specified country (US, FR, UK, DE, etc.)

match_exactlyboolean

Fetch only videos where the input keyword has to be exactly present in the video caption. ATTENTION: If match_exactly=True, the API cost is #returned_posts / 10

tokenstring required

Private token assigned to each client to access the APIs.

Response

Successful Response

unknown required

Changes

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