douyin/
user-profile

The Douyin User Profile API retrieves one public Douyin profile from a supported profile URL or user identifier, returning normalized identity, biography, images, account flags, and visible counts.

Douyin User Profile API

URL or user ID
Single public profile
Normalized account fields
0.1 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Douyin User Profile

Douyin user profiles are public account surfaces with identity, biography, profile images, verification and privacy signals, plus visible follower, following, and post counts. These fields support account enrichment, identity checks, snapshot monitoring, and comparative profile research.

Douyin User Profile API Features

  • Two supported identifiersResolve one public profile from either a supported Douyin user URL or a user_id that matches the runtime identifier rule.
  • Profile identity and presentationThe Douyin User Profile API returns available profile ID, public URL, username, display name, biography, avatar, cover image, and associated website in one account record.
  • Explicit account state fieldsPreserve available verification and privacy flags as nullable values instead of inferring a state when the public source omits it.
  • Visible profile measurementsNormalize available follower, following, and post counts alongside collected_at for a time-specific view of the public profile.

Douyin User Profile API Parameters

ParametersRequiredDescription
urlRequired (at least one)Provide url or user_id. A non-empty URL must use douyin.com, iesdouyin.com, or a subdomain and include a /user/<identifier> path.
user_idRequired (at least one)Provide user_id or url. user_id accepts 1 to 256 ASCII letters, numbers, colons, underscores, or hyphens and takes precedence if both fields are submitted.

How to Use the Douyin User Profile API

Submit one supported profile identifier to the Douyin User Profile API, track the asynchronous task, and read the normalized account from the stored-result envelope.

  1. Prepare either a full Douyin profile URL with a /user/<identifier> path or a supported public user_id.
  2. POST one identifier to /v1/douyin/user-profile and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the status is succeeded or failed.
  4. Read data.results.items after success; the source lookup produces at most one profile, while the stored result envelope still reports has_more and next_cursor.
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"

# Poll GET /v1/tasks/{task_id}
# Read the normalized account from data.results.items

Douyin User Profile API Use Cases

  • Creator record enrichment: Add available Douyin identity, biography, images, website, account flags, and public counts to an existing creator record.
  • Profile identity checks: Use the Douyin User Profile API to resolve a known profile URL or user identifier into a consistent account object before linking it to an internal entity.
  • Public account comparisons: Compare follower, following, and post counts across separately collected profiles using the same normalized metric keys.
  • Profile snapshot monitoring: Store identity fields and public metrics with collected_at so later tasks remain distinguishable point-in-time observations.

Douyin User Profile API Pro Tips

  • When a canonical user identifier is already available, submit user_id alone; if url and user_id disagree, the provider request uses user_id.
  • Before submitting a URL, verify its hostname and require a /user/<identifier> path so links to videos or other Douyin resources are rejected locally.
  • Expect zero or one source profile record; the task reader's cursor paginates saved SocQ items and cannot request another provider page for this lookup.
  • Treat identity, images, website, account flags, location, and each metric as nullable, and preserve collected_at when comparing repeated snapshots.

Beyond the Douyin User Profile API, use these APIs when you need a different type of public Douyin data.

Explore other platforms

Combine Douyin data with public data from other supported social platforms.

Douyin User Profile API — FAQ

Douyin User Profile API retrieves one public Douyin account from a supported profile URL or user identifier, returning normalized identity, biography, images, account flags, visible counts, and collection time.

Either field satisfies the request requirement. Submit only the identifier you intend to resolve because user_id takes precedence when both values are present.

The parsed hostname must be douyin.com, iesdouyin.com, or a subdomain, and the path must contain /user/ followed by an identifier made of letters, numbers, underscores, or hyphens. Video links and unrelated hosts are rejected.

The account schema can contain profile ID and URL, username, display name, biography, avatar, cover image, website, verification and privacy flags, location, follower count, following count, post count, and collected_at. Optional public fields remain null when no value is available.

No. The provider lookup is a single-detail request that yields at most one source profile; next_cursor and has_more only describe pagination over results already stored by SocQ.

Each successful Douyin User Profile API task has a fixed cost of 0.10 SocQ credits. The charge does not depend on how many optional profile fields are populated.