EveryData platform API
TikTok API
Use TikTok for TikTok videos, creators, comments, hashtags, follower counts, transcripts, and Shop discovery only through the 10 listed contracts, such as `search`, `profile`, `user_videos`, because one view does not inherit another view’s reach.
For matching public results, use TikTok action `search` with `keyword`; for the selected TikTok record, switch to `profile` and `username`, rather than carrying parameters across.
- Endpoint
- POST /api/v1/social
- Capabilities
- 10
- Per 1,000
- $0.556
Available capabilities
Compare the TikTok actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Use | keyword | content_type, min_likes, sort, until | Sync delivery | Catalog values: defaultLimit=10, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · platform |
profileProfiles The TikTok | username | content_type, min_likes, sort, until | Sync delivery | — | $0.56 per 1,000 requests | user_id · username · display_name · bio · url · external_url · follower_count · following_count · like_count · video_count · friend_count · is_verified · is_private · avatar_url · created_at · platform |
user_videosVideos by user Use | username | content_type, min_likes, sort, until | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · platform |
videoVideo details Within TikTok, | url | content_type, min_likes, sort, until | Sync delivery | — | $0.56 per 1,000 requests | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · platform |
commentsComments The | url | content_type, min_likes, sort, until | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · text · author_username · author_id · like_count · reply_count · reply_to_id · is_reply · liked_by_author · pinned_by_author · posted_at · platform |
hashtagHashtag Use the TikTok | hashtag | content_type, keyword, min_likes, sort, until | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · platform |
followersFollowers TikTok | username | channel | Sync delivery | — | $0.56 per 1,000 requests | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
transcriptTranscript Use | url | urls | Sync delivery | — | $0.56 per 1,000 requests | id · url · text · segments · has_transcript · platform |
shop_searchShop product search Use TikTok | keyword | country, page | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · category · shop_name · image_url · platform |
shop_creatorShop creator details The | username | country | Sync delivery | — | $0.56 per 1,000 requests | id · username · url · name · text · avatar_url · country · categories · follower_count · video_count · product_count · sold_count · avg_views · platform |
What does each TikTok action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the TikTok search parameters mean?
Use search to retrieve public TikTok results matching a given keyword. Omission from search results does not confirm non-existence on TikTok. For TikTok search, supply content_type, sort, keyword, min_likes, and until; results include posted_at, author_name, platform, like_count, text, share_count, comment_count, id, view_count, author_username, and url.
keywordRequired- Specifies the search query string for public video searches in the
searchaction. Inshop_search, this searches TikTok Shop products instead, which draw from a distinct dataset. content_typeOptional- Filters results by tab in the
searchaction. Allowed values arevideofor videos,profilefor users, andtopfor top content. Providing this parameter in fixed author, video, or hashtag actions does not guarantee that filtering will take effect, so verify returned response objects and fields after changing tabs.Allowed values:profiletopvideo min_likesOptional- Numeric threshold filtering videos by minimum like count. Designed primarily for video list outputs, this parameter does not filter author follower counts or comment like thresholds, and its applicability to single-video or comment actions is unconfirmed.
sortOptional- Sorts author video lists in the
user_videosaction. Allowed values arenewest,oldest, andpopular. This field maps to author video feeds, and its presence insearch,video,comments, orhashtagschemas does not imply support for equivalent sorting in those contexts.Allowed values:newestoldestpopular untilOptional- Sets an upper date bound for video publication time rather than data ingestion time. Applicability outside author video listing modes is unconfirmed.
What do the TikTok profile parameters mean?
The TikTok profile action retrieves a public profile by username. This record reflects public data and does not verify account ownership, identity, or private access. Call TikTok profile with username, content_type, until, sort, and min_likes; TikTok profile exposes created_at, bio, username, is_verified, friend_count, like_count, display_name, video_count, is_private, avatar_url, external_url, user_id, follower_count, platform, following_count, and url.
usernameRequired- Public TikTok handle, which may optionally include the leading
@. Do not supply DouyinsecUidtokens or full profile URLs. Infollowers, this returns follower counts; inshop_creator, it queries creator e-commerce details for a designated market.TikTok: Differences Between Username and Display NicknameTikTok separates username from nickname: username forms the @ handle and profile URL, while nickname is the display name shown to other users. Changing a username will also change the profile URL.Checked content_typeOptional- Filters results by tab in the
searchaction. Allowed values arevideofor videos,profilefor users, andtopfor top content. Providing this parameter in fixed author, video, or hashtag actions does not guarantee that filtering will take effect, so verify returned response objects and fields after changing tabs.Allowed values:profiletopvideo min_likesOptional- Numeric threshold filtering videos by minimum like count. Designed primarily for video list outputs, this parameter does not filter author follower counts or comment like thresholds, and its applicability to single-video or comment actions is unconfirmed.
sortOptional- Sorts author video lists in the
user_videosaction. Allowed values arenewest,oldest, andpopular. This field maps to author video feeds, and its presence insearch,video,comments, orhashtagschemas does not imply support for equivalent sorting in those contexts.Allowed values:newestoldestpopular untilOptional- Sets an upper date bound for video publication time rather than data ingestion time. Applicability outside author video listing modes is unconfirmed.
What do the TikTok user_videos parameters mean?
Use user_videos to retrieve videos posted by the TikTok account identified by username. Objects not returned by this action remain unknown. For TikTok user_videos, supply min_likes, sort, until, username, and content_type; results include url, id, like_count, share_count, comment_count, author_username, author_name, posted_at, platform, view_count, and text.
usernameRequired- Public TikTok handle, which may optionally include the leading
@. Do not supply DouyinsecUidtokens or full profile URLs. Infollowers, this returns follower counts; inshop_creator, it queries creator e-commerce details for a designated market.TikTok: Differences Between Username and Display NicknameTikTok separates username from nickname: username forms the @ handle and profile URL, while nickname is the display name shown to other users. Changing a username will also change the profile URL.Checked content_typeOptional- Filters results by tab in the
searchaction. Allowed values arevideofor videos,profilefor users, andtopfor top content. Providing this parameter in fixed author, video, or hashtag actions does not guarantee that filtering will take effect, so verify returned response objects and fields after changing tabs.Allowed values:profiletopvideo min_likesOptional- Numeric threshold filtering videos by minimum like count. Designed primarily for video list outputs, this parameter does not filter author follower counts or comment like thresholds, and its applicability to single-video or comment actions is unconfirmed.
sortOptional- Sorts author video lists in the
user_videosaction. Allowed values arenewest,oldest, andpopular. This field maps to author video feeds, and its presence insearch,video,comments, orhashtagschemas does not imply support for equivalent sorting in those contexts.Allowed values:newestoldestpopular untilOptional- Sets an upper date bound for video publication time rather than data ingestion time. Applicability outside author video listing modes is unconfirmed.
What do the TikTok video parameters mean?
Within TikTok, video addresses one public video. Use TikTok video with url; TikTok then selects one public video. Pass min_likes, sort, until, content_type, and url to TikTok video; returned objects expose id, text, view_count, author_username, platform, posted_at, comment_count, share_count, url, like_count, and author_name.
urlRequired- Target TikTok video URL required for
video,comments, andtranscriptactions. Incomments, it retrieves post-level comments where each top-level comment includes at most two replies, without guaranteeing a complete conversation tree. content_typeOptional- Filters results by tab in the
searchaction. Allowed values arevideofor videos,profilefor users, andtopfor top content. Providing this parameter in fixed author, video, or hashtag actions does not guarantee that filtering will take effect, so verify returned response objects and fields after changing tabs.Allowed values:profiletopvideo min_likesOptional- Numeric threshold filtering videos by minimum like count. Designed primarily for video list outputs, this parameter does not filter author follower counts or comment like thresholds, and its applicability to single-video or comment actions is unconfirmed.
sortOptional- Sorts author video lists in the
user_videosaction. Allowed values arenewest,oldest, andpopular. This field maps to author video feeds, and its presence insearch,video,comments, orhashtagschemas does not imply support for equivalent sorting in those contexts.Allowed values:newestoldestpopular untilOptional- Sets an upper date bound for video publication time rather than data ingestion time. Applicability outside author video listing modes is unconfirmed.
What do the TikTok comments parameters mean?
The comments action fetches comments for a TikTok target specified by url. Ensure url matches the documented identifier format. TikTok comments reads content_type, sort, until, url, and min_likes, with author_username, author_id, id, like_count, liked_by_author, pinned_by_author, is_reply, reply_count, reply_to_id, platform, posted_at, and text available in its response.
urlRequired- Target TikTok video URL required for
video,comments, andtranscriptactions. Incomments, it retrieves post-level comments where each top-level comment includes at most two replies, without guaranteeing a complete conversation tree. content_typeOptional- Filters results by tab in the
searchaction. Allowed values arevideofor videos,profilefor users, andtopfor top content. Providing this parameter in fixed author, video, or hashtag actions does not guarantee that filtering will take effect, so verify returned response objects and fields after changing tabs.Allowed values:profiletopvideo min_likesOptional- Numeric threshold filtering videos by minimum like count. Designed primarily for video list outputs, this parameter does not filter author follower counts or comment like thresholds, and its applicability to single-video or comment actions is unconfirmed.
sortOptional- Sorts author video lists in the
user_videosaction. Allowed values arenewest,oldest, andpopular. This field maps to author video feeds, and its presence insearch,video,comments, orhashtagschemas does not imply support for equivalent sorting in those contexts.Allowed values:newestoldestpopular untilOptional- Sets an upper date bound for video publication time rather than data ingestion time. Applicability outside author video listing modes is unconfirmed.
What do the TikTok hashtag parameters mean?
Use the TikTok hashtag action to retrieve a hashtag feed. The hashtag parameter is required, while optional fields serve as filters. TikTok hashtag takes hashtag, keyword, content_type, until, sort, and min_likes and yields url, platform, id, like_count, author_username, posted_at, share_count, comment_count, view_count, text, and author_name.
hashtagRequired- Target hashtag name for the
hashtagaction, with or without the leading#. This parameter filters specifically by hashtag and does not function as an arbitrary full-text search term. content_typeOptional- Filters results by tab in the
searchaction. Allowed values arevideofor videos,profilefor users, andtopfor top content. Providing this parameter in fixed author, video, or hashtag actions does not guarantee that filtering will take effect, so verify returned response objects and fields after changing tabs.Allowed values:profiletopvideo keywordOptional- Specifies the search query string for public video searches in the
searchaction. Inshop_search, this searches TikTok Shop products instead, which draw from a distinct dataset. min_likesOptional- Numeric threshold filtering videos by minimum like count. Designed primarily for video list outputs, this parameter does not filter author follower counts or comment like thresholds, and its applicability to single-video or comment actions is unconfirmed.
sortOptional- Sorts author video lists in the
user_videosaction. Allowed values arenewest,oldest, andpopular. This field maps to author video feeds, and its presence insearch,video,comments, orhashtagschemas does not imply support for equivalent sorting in those contexts.Allowed values:newestoldestpopular untilOptional- Sets an upper date bound for video publication time rather than data ingestion time. Applicability outside author video listing modes is unconfirmed.
What do the TikTok followers parameters mean?
TikTok followers accepts a creator username and returns the public account metrics exposed for that handle. follower_count, following_count, post_count, and like_count form a snapshot, not a follower list or evidence that every audience member is reachable. Call TikTok followers with channel and username; TikTok followers exposes username, like_count, follower_count, connection_count, platform, url, post_count, precision, following_count, and id.
usernameRequired- Public TikTok handle, which may optionally include the leading
@. Do not supply DouyinsecUidtokens or full profile URLs. Infollowers, this returns follower counts; inshop_creator, it queries creator e-commerce details for a designated market.TikTok: Differences Between Username and Display NicknameTikTok separates username from nickname: username forms the @ handle and profile URL, while nickname is the display name shown to other users. Changing a username will also change the profile URL.Checked channelOptional- Compatibility account handle input for the
followersaction. Precedence is lower thanusername. It is not used for TikTok Shop product searches.
What do the TikTok transcript parameters mean?
Use transcript with a TikTok video url to retrieve available transcript text and segments. Availability depends on the source media, and the text is not guaranteed to be human-verified. Use url and urls when calling TikTok transcript; the response contains id, text, has_transcript, url, platform, and segments.
urlRequired- Target TikTok video URL required for
video,comments, andtranscriptactions. Incomments, it retrieves post-level comments where each top-level comment includes at most two replies, without guaranteeing a complete conversation tree. urlsOptional- Array of target video URLs for the
transcriptaction that overrides single-target reads fromurlwhen provided. Because the underlying response contract is single-object, test array batching and response structure compatibility before production use, favoring singleurlrequests when possible.
What do the TikTok shop_search parameters mean?
Use TikTok shop_search with keyword for TikTok shop-product results. TikTok shop_search keeps TikTok field meanings action-specific. Call TikTok shop_search with keyword, page, and country; TikTok shop_search exposes currency, sold_count, url, original_price, rating, rating_scale, price, review_count, platform, shop_name, name, id, image_url, and category.
keywordRequired- Specifies the search query string for public video searches in the
searchaction. Inshop_search, this searches TikTok Shop products instead, which draw from a distinct dataset. countryOptional- Market region code for
shop_searchandshop_creatoractions, defaulting toUSorus. It does not filter creator nationality or platform-wide content location. Refer to current response payloads and directory lists for supported markets. pageOptional- 1-based integer page number for
shop_searchproduct pagination, defaulting to1. It does not paginate video comments or author video lists.
What do the TikTok shop_creator parameters mean?
The shop_creator action retrieves a TikTok shop-creator record using username. Identifiers distinguish records but do not confirm legal identity. Pass country and username to TikTok shop_creator; returned objects expose avg_views, sold_count, avatar_url, platform, name, categories, text, country, url, id, video_count, product_count, username, and follower_count.
usernameRequired- Public TikTok handle, which may optionally include the leading
@. Do not supply DouyinsecUidtokens or full profile URLs. Infollowers, this returns follower counts; inshop_creator, it queries creator e-commerce details for a designated market. countryOptional- Market region code for
shop_searchandshop_creatoractions, defaulting toUSorus. It does not filter creator nationality or platform-wide content location. Refer to current response payloads and directory lists for supported markets.
How to use the TikTok API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"tiktok","action":"search","params":{"keyword":"<keyword>"}}'
TikTok API questions
What can I retrieve with the TikTok API?
Set platform to tiktok. The current catalog lists search, profiles, videos by user, video details, comments, and more. These action names identify different TikTok objects or views; they are not interchangeable search modes.
Which input starts a TikTok `search` request?
Specifies the search query string for public video searches in the search action. In shop_search, this searches TikTok Shop products instead, which draw from a distinct dataset. Send it as keyword inside params.
Which fields can TikTok `search` return?
Its declared schema includes text, author_name, author_username, and like_count. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every TikTok action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.