TikTok API | TikTok comments post search creator videos

SocialDataX read-only TikTok API for TikTok comments, post search, post details, comment replies, creator profiles, and TikTok creator videos.

Apify users do not need to configure a SocialDataX API Key. The Actor owner configures SOCIALDATAX_API_KEY as an Apify secret.

Use this Actor when you need TikTok comments, TikTok comment replies, TikTok post search, TikTok creator videos, creator profile data, or structured results exported to Apify Dataset, CSV, Excel, JSON, or API workflows.

User-post rows expose is_pinned (true / false) in Overview and User posts. An omitted field means the API did not provide it. The Actor preserves the returned order and pagination.

Support

If a run fails, you need higher limits, or you want to discuss a bulk data workflow, contact SocialDataX support:

• Website: https://socialdatax.com/ai?from=apify

Operations

• search_users: TikTok user search using keyword, with optional page_token, max_items, and auto_paginate.
• search_suggestions: TikTok keyword suggestions using keyword; returns up to max_items text rows in one request without pagination.
• search_posts: TikTok post search using keyword.
• get_post_detail: TikTok post details using url.
• get_post_comments: TikTok comments using post_id or url.
• get_post_comment_replies: TikTok comment replies using post_id / comment_id.
• get_user_info: TikTok creator profile using tiktok_id or profile_url.
• list_user_posts: TikTok creator videos using tiktok_id or profile_url.

Input tips

• User search returns tiktok_id and profile_url for follow-up profile or content queries; unavailable counts and privacy status may be omitted.

• For TikTok comments, paste a public TikTok post URL into url, or copy post_id from a Dataset row.

• For TikTok comment replies, first run get_post_comments, then copy post_id and top-level comment_id from the same Dataset row.

• For TikTok creator videos, paste a creator profile URL or provide the tiktok_id.

• For post search, use keyword, optional content_type, page_token, max_items, and auto_paginate.

Pagination

Paginated operations use page_token, max_items, and auto_paginate. Each requested page counts as one SocialDataX API request. Results are written to the default Apify Dataset and can be exported as JSON, CSV, Excel / XLSX, or JSONL.

Example input

{
  "operation": "search_posts",
  "keyword": "camping",
  "page_token": "",
  "content_type": "all",
  "max_items": 50,
  "auto_paginate": true
}

Maintainer verification

npm run smoke:live checks one list_user_posts page using the Actor client. Set SOCIALDATAX_API_KEY and exactly one of SOCIALDATAX_SMOKE_TIKTOK_ID or SOCIALDATAX_SMOKE_PROFILE_URL in the environment. This makes one real API request and consumes the key's quota. The check uses the client's 60-second request timeout, disables retries and pagination, and checks up to three generated Dataset rows.

Without a user sample, the command reports skipped (not verified) and sends no request. Missing or non-array items, empty results, missing post_id, and non-boolean is_pinned values fail the check. If is_pinned is omitted, the summary sets pinnedFieldVerified=false and reports a warning; it does not infer false. Output contains counts and field names, not full results. Failures print the error message and return a nonzero exit code without dumping the response body. This local check does not run the cloud Actor or verify Apify billing and Console display.

Billing

Ongoing use requires an Apify paid plan. Free-plan users get a limited SocialDataX API request trial.

Recommended Apify Pay per event setup:

• apify-default-dataset-item: $0.001 / Dataset item
• apify-actor-start: keep Apify default $0.00005
• Pay per event + usage: off