TikTok Profiles API

TikTok Profiles

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

How to Use

Start with a creator username list and produce records ready for a directory or CRM.

1. Normalize creator-list entries such as nasa and @nasa, then deduplicate them.
2. POST the usernames array to /v1/tiktok/profiles and save the returned task_id.
3. Poll /v1/tasks/{task_id}. queued and running are normal intermediate states.
4. 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 true

Best 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