# Social Fetch API - Douyin endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 5 documented Douyin operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/douyin/profiles/{secUid} Get Douyin profile Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/douyin/profiles/secuid/get.mdx SDK: client.douyin.getProfile({ secUid: "MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw" }) Parameters: - secUid (required, string) - Douyin's public user id from the profile link, as in douyin.com/user/{secUid}, for example `MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw`. A full profile link or a v.douyin.com short link also works. Outcome field: `data.lookupStatus` in `found`, `private`, `not_found` curl "https://api.socialfetch.dev/v1/douyin/profiles/MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/douyin/profiles/{secUid}/videos List Douyin profile videos Credit cost: 2 credits. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/douyin/profiles/secuid/videos/get.mdx SDK: client.douyin.listProfileVideos({ secUid: "MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw" }) Parameters: - secUid (required, string) - Douyin's public user id from the profile link, as in douyin.com/user/{secUid}, for example `MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw`. A full profile link or a v.douyin.com short link also works. Outcome field: `data.lookupStatus` in `found`, `private`, `not_found` curl "https://api.socialfetch.dev/v1/douyin/profiles/MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw/videos" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/douyin/videos Get Douyin video Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/douyin/videos/get.mdx SDK: client.douyin.getVideo({ url: "https://www.douyin.com/video/7687419490820295970" }) Parameters: - url (required, string) - Link to the Douyin video or photo post, as in https://www.douyin.com/video/7687419490820295970. A share link, a v.douyin.com short link or the numeric id also works. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/douyin/videos?url=https://www.douyin.com/video/7687419490820295970" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/douyin/videos/comments List Douyin video comments Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/douyin/videos/comments/get.mdx SDK: client.douyin.listVideoComments({ url: "https://www.douyin.com/video/7687419490820295970" }) Parameters: - url (required, string) - Link to the Douyin video or photo post, as in https://www.douyin.com/video/7687419490820295970. A share link, a v.douyin.com short link or the numeric id also works. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same video. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/douyin/videos/comments?url=https://www.douyin.com/video/7687419490820295970" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/douyin/trending Get Douyin trending Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/douyin/trending/get.mdx SDK: client.douyin.getTrending() curl "https://api.socialfetch.dev/v1/douyin/trending" \ -H "x-api-key: YOUR_API_KEY"