> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/douyin/profiles-secuid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/douyin/profiles-secuid.mdx>

---

# Douyin Profile API

Turn a Douyin profile link into structured JSON with the creator's counts.

`GET /v1/douyin/profiles/MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw` returns `data.profile`: `id` (the numeric user id, the same on every Douyin endpoint), `secUid`, `handle` (the Douyin id), display name, bio, avatar and cover, verification and its label, `ipLocation`, `age` (null when the creator hides it), `isLive`, and `stats` for followers, following, videos and likes.

A private account returns `lookupStatus: private` with its profile, a banned one `isBanned: true` with no counts, and an id that names no account `lookupStatus: not_found`.

## Request

- **Endpoint:** `GET /v1/douyin/profiles/{secUid}`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by user id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/douyin/profiles/secuid/get)
- **Platform page:** [/platforms/douyin](https://www.socialfetch.dev/platforms/douyin)

## FAQ

### Which id do I pass?

The id in the profile link, douyin.com/user/{secUid}, starting MS4wLjABAAAA. The whole link works too.

### What is ipLocation?

The province or country Douyin shows on the profile as the account's IP location, such as 海南.

### Are counts exact?

Yes. They are Douyin's own whole numbers, not the rounded 万 figures the app shows.

### How many credits does a profile lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
