TikTok Profiles
TikTok Profiles are public creator or account pages with identity, biographies, avatars, verification and privacy status, and visible follower, following, video, and like totals. These profile signals support creator discovery, audience comparison, partnership research, and directory enrichment.
Features
- Batch username lookupResolve one or more public creator usernames in a single request.
- Normalized username inputsNormalize nasa and @nasa style inputs before profile collection.
- Stable profile identityBuild an identity index from account ID, username, display name, and profile URL.
- Profile and audience fieldsReturn biography, avatar, verification and privacy status, plus follower, following, video, and total-like counts in one record.
- Traceable profile snapshotsTrace every enrichment and recurring snapshot through the submitted input and collected_at.
Parameters
| Parameters | Required | Description |
|---|---|---|
usernames | Required | Required list of public TikTok usernames. Each value may include or omit a leading @. |
How to Use
Start with a creator username list and produce records ready for a directory or CRM.
- Normalize creator-list entries such as nasa and @nasa, then deduplicate them.
- POST the usernames array to /v1/tiktok/profiles and save the returned task_id.
- Poll /v1/tasks/{task_id}. queued and running are normal intermediate states.
- Read data.results.items after success. When has_more is true, continue with next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@tiktok"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Talent directory enrichment: Turn username lists into creator cards with account IDs, avatars, biographies, status, and scale metrics.
- Partnership preparation: Review creator identity, publishing footprint, and audience scale before outreach.
- Creator growth tracking: Save recurring follower, video, and total-like snapshots for a consistent creator cohort.
- Cross-dataset identity matching: Use account IDs to connect creator records with related videos and comments.
Pro Tips
- Use id as the creator key and keep username for search and display.
- Retain the submitted input so every API record maps cleanly back to the source talent list.
- Collect on a fixed cadence and pair each metric snapshot with collected_at.
- Deduplicate on the username after trimming the leading @.
- Combine avatar, display_name, biography, and profile_url into useful creator cards.
- Join related profile, video, and comment records by account ID for a richer creator view.
Related APIs
Use these APIs when you need a different type of public TikTok data.
- TikTok Hashtags API — Collect public videos, creators, media, sound, and engagement for specified hashtags.
- TikTok Comments API — Collect public top-level comments, authors, engagement, mentions, and creator interaction flags.
- TikTok Videos API — Retrieve creator, caption, media, music, tags, mentions, and engagement from video URLs.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Comment Replies API — Collect public replies for a known comment using its TikTok video URL and comment ID, with authors, engagement, timestamps, and parent context.
- TikTok Followers List API — Collect normalized profiles visible in public follower lists, with retained source context and supported metrics.
- TikTok Following List API — Collect public profiles followed by TikTok accounts with normalized identity, biographies, visible metrics, and source-account context.
- TikTok User Videos API — Collect public profile-feed videos by username with captions, creators, media, timestamps, engagement, and source-account context.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Trending Feed API — Collect the current public video feed for a region with creator, caption, cover, timestamp, and visible engagement fields.
- TikTok Video Transcript API — Extract available transcript text, language, format, and source context from public video URLs.