EveryData · Creator intelligence

Douyin Creator IntelligenceFind creators. Understand performance. Explore products.

Search creators, review profiles and posts, compare audience and Xingtu metrics, and explore products through separate APIs.

Open the Douyin creator workspace →View all APIs

Choose an API by task

See the available data, price, and parameters for each task.

Creator profile

$0.56 per 1,000 requests

profile

Read the public avatar, Douyin ID, display name, bio, and account totals.

Required parameters: user_id · Single object

View response fields (15)

Optional parameters: —

user_id
douyin_id
nickname
bio
url
follower_count
following_count
like_count
video_count
gender
ip_location
is_verified
avatar_url
platform
verify_reason

View API →

Public posts and engagement

$0.56 per 1,000 requests

user_posts

Read public posts, timestamps, and engagement (likes, comments, shares). Douyin does not publish play counts — the play field is always 0 and never means nobody watched; gauge heat by engagement.

Required parameters: user_id · Maximum per call 100 rows

View response fields (18)

Optional parameters: since

id
url
text
media_type
like_count
comment_count
share_count
collect_count
view_count
author_name
author_id
author_douyin_id
author_follower_count
region
posted_at
platform
duration_sec
hashtags

View API →

Creator search

$0.56 per 1,000 requests

creator_search

Discover accounts by keyword and apply the supported filters.

Required parameters: keyword · Maximum per call 20 rows

View response fields (12)

Optional parameters: follower_range, user_type

user_id
douyin_id
nickname
url
avatar_url
follower_count
gender
is_verified
verify_reason
is_live
source_keyword
platform

View API →

Follower and audience distribution

$0.56 per 1,000 requests

creator_audience

Request one supported distribution at a time: gender, age, province, or device price band.

Required parameters: user_id · Single object

View response fields (5)

Optional parameters: dimension

user_id
audience_distribution
audience_tgi
dimension_code
platform

View API →

Follower trend

$0.56 per 1,000 requests

creator_trend

Review available follower changes and trend averages.

Required parameters: user_id · Single object

View response fields (5)

Optional parameters: —

user_id
follower_trend
average_follower_count
dimension_code
platform

View API →

Peer benchmark

$0.56 per 1,000 requests

creator_benchmark

Compare period averages and percentiles.

Required parameters: user_id · Single object

View response fields (12)

Optional parameters: —

user_id
average_post_count
average_comment_count
average_share_count
average_follower_growth
average_like_count
post_count_percentile
comment_count_percentile
share_count_percentile
follower_growth_percentile
like_count_percentile
platform

View API →

Xingtu creator search

$0.56 per 1,000 requests

xingtu_creator_search

Review commercial indices, 30-day ranges, and quotes. Detailed Xingtu lookups use douyin_id.

Required parameters: keyword · Maximum per call 20 rows

View response fields (29)

Optional parameters: —

creator_id
user_id
nickname
follower_count
gender
city
province
creator_score
engagement_rate_30d
expected_play_count
expected_natural_play_count
interaction_median_30d
play_over_rate_30d
follower_growth_30d
follower_growth_rate_15d
content_themes
ecommerce_level
ecommerce_score
gmv_30d_range
gpm_30d_range
average_order_value_30d_range
commercial_index
conversion_index
spread_index
shopping_index
quote_1_20s_cny
quote_20_60s_cny
quote_60s_plus_cny
platform

View API →

Xingtu creator analytics

$0.56 per 1,000 requests

xingtu_creator_analytics

Review categories, themes, and public performance signals for a douyin_id.

Required parameters: douyin_id · Single object

View response fields (15)

Optional parameters: —

creator_id
creator_type
follower_count
average_play_count
city
province
gender
category_id
content_themes
tags
creator_grade
is_xingtu_creator
ecommerce_enabled
lowest_quote_cny
platform

View API →

Xingtu rate card

$0.56 per 1,000 requests

xingtu_rate_card

Review rate tiers grouped by video duration.

Required parameters: douyin_id · Single object

View response fields (3)

Optional parameters: —

creator_id
rate_tiers
platform

View API →

Xingtu creator rankings

$0.56 per 1,000 requests

xingtu_creator_rankings

Choose an industry, board, and period to view ranking scores and ranges.

Required parameters: industry, ranking_type, time_window · Maximum per call 5 rows

View response fields (24)

Optional parameters: —

creator_id
user_id
url
nickname
avatar_url
gender
city
province
follower_count
cpm_cny
completed_order_range
repurchase_rate_range
item_order_rate
average_view_count
industry
rank
previous_rank
ranking_score
is_new
ranking_board
period_days
snapshot_date
source_kind
platform

View API →

Independent product search

$0.56 per 1,000 requests

product_search

Search products, shops, 30-day sales, and commission data by keyword.

Required parameters: keyword · Maximum per call 5 rows

View response fields (25)

Optional parameters: —

product_id
promotion_id
title
url
image_url
white_image_url
price_cny
price_cny_minor
price_label
monthly_sales
good_review_ratio
sales_trend
category_path
category_depth
shop_id
shop_name
shop_logo_url
shop_score
commission_rate_percent
commission_cny
cooperating_creator_count
tags
source_keyword
search_rank
platform

View API →

Product detail and galleries

$0.56 per 1,000 requests

product_detail

Use a numeric product_id to read one product's image carousel, detail images, variants, shop, and public sold snapshot.

Required parameters: product_id · Single object

View response fields (18)

Optional parameters: —

product_id
title
price_cny
discount_price_cny
sales_text
sold_count
shop_id
shop_name
shop_avatar_url
image_url
main_image_urls
detail_image_urls
assurances
shipping_fee_text
shipping_estimate_text
variant_groups
on_sale
platform

View API →

Current live product search

$0.56 per 1,000 requests

live_product_search

Find current live products and their live_room_id by keyword.

Required parameters: keyword · Maximum per call 3 rows

View response fields (10)

Optional parameters: —

product_id
sku_id
title
image_url
price_cny
shop_id
live_room_id
is_live_product
source_keyword
platform

View API →

Each action uses its catalog price and billing rules. Product values keep their source currency.

Data coverage

Review the availability and scope of all 27 data targets.

Data notes

Creator, Xingtu, and product results are separate views. Historical creator-product attribution, exact GMV or ROI, and transaction-buyer profiles are not included.

Creator details

Avatar

Direct

Returns a public avatar URL.

Creator details

Douyin ID

Direct

Kept distinct from internal user IDs and Xingtu creator IDs.

Creator details

Display name and bio

Direct

Returns the public display name and biography.

Creator details

Followers, likes, and post count

Direct

Returns public account totals.

Audience

Gender

Direct

Returns the follower or audience distribution.

Audience

Age

Direct

Presented using the returned age bands.

Audience

Location

Direct

Presented using the province groups currently returned.

Audience

Device, interests, and related accounts

Partial

Device price bands are supported; interests and related accounts are not currently available.

Sales history

Previously promoted products

Unavailable

Historical creator-to-product links are unavailable.

Sales history

Previously promoted categories

Unavailable

Historical promoted-category data is unavailable.

Sales history

Creator average order value

Partial

Only a 30-day range is retained; it is not an exact settled average order value.

Sales history

Category average order value

Unavailable

Creator-by-category settlement data is unavailable.

Commercial performance

30-day ecommerce GMV

Partial

Returns the source range, not an exact amount.

Commercial performance

Conversion and ROI

Partial

Returns related indices and ranges; order-level ROI is unavailable.

Product details

Primary, white-background, and gallery images

Direct

Product search returns primary and white-background images; product detail returns image carousels and long-form detail images. Image counts vary by product.

Product details

Product URL and ID

Direct

Returns identifiers and links from the independent product pool.

Product details

Title and price

Direct

Returns the displayed product price; per-SKU prices may be absent.

Product details

Four-level category path

Partial

Returns the available category depth. The verified sample had three levels.

Product details

Brand

Unavailable

A structured brand field is unavailable.

Product details

Sales

Direct

Returns 30-day sales trends and the public sold snapshot available at collection time.

Product details

Revenue or GMV

Unavailable

A product revenue or GMV field is unavailable.

Product details

Shop, rating, and commission

Direct

Returns shop, rating, commission, and cooperating-creator fields when available.

Buyer profile

Buyer gender

Unavailable

Transaction-buyer gender is unavailable.

Buyer profile

Buyer age

Unavailable

No reliable transaction-buyer data is available.

Buyer profile

Buyer location

Unavailable

No reliable transaction-buyer data is available.

Live commerce

Current live-room products

Partial

Finds current live products by keyword and returns live_room_id; it does not list every product for a specified creator.

Data linkage

Historical creator-to-product attribution

Unavailable

Historical creator-to-product attribution is unavailable.

Group	Target data	Current state	Evidence boundary
Creator details	Avatar	Direct	Returns a public avatar URL.
Creator details	Douyin ID	Direct	Kept distinct from internal user IDs and Xingtu creator IDs.
Creator details	Display name and bio	Direct	Returns the public display name and biography.
Creator details	Followers, likes, and post count	Direct	Returns public account totals.
Audience	Gender	Direct	Returns the follower or audience distribution.
Audience	Age	Direct	Presented using the returned age bands.
Audience	Location	Direct	Presented using the province groups currently returned.
Audience	Device, interests, and related accounts	Partial	Device price bands are supported; interests and related accounts are not currently available.
Sales history	Previously promoted products	Unavailable	Historical creator-to-product links are unavailable.
Sales history	Previously promoted categories	Unavailable	Historical promoted-category data is unavailable.
Sales history	Creator average order value	Partial	Only a 30-day range is retained; it is not an exact settled average order value.
Sales history	Category average order value	Unavailable	Creator-by-category settlement data is unavailable.
Commercial performance	30-day ecommerce GMV	Partial	Returns the source range, not an exact amount.
Commercial performance	Conversion and ROI	Partial	Returns related indices and ranges; order-level ROI is unavailable.
Product details	Primary, white-background, and gallery images	Direct	Product search returns primary and white-background images; product detail returns image carousels and long-form detail images. Image counts vary by product.
Product details	Product URL and ID	Direct	Returns identifiers and links from the independent product pool.
Product details	Title and price	Direct	Returns the displayed product price; per-SKU prices may be absent.
Product details	Four-level category path	Partial	Returns the available category depth. The verified sample had three levels.
Product details	Brand	Unavailable	A structured brand field is unavailable.
Product details	Sales	Direct	Returns 30-day sales trends and the public sold snapshot available at collection time.
Product details	Revenue or GMV	Unavailable	A product revenue or GMV field is unavailable.
Product details	Shop, rating, and commission	Direct	Returns shop, rating, commission, and cooperating-creator fields when available.
Buyer profile	Buyer gender	Unavailable	Transaction-buyer gender is unavailable.
Buyer profile	Buyer age	Unavailable	No reliable transaction-buyer data is available.
Buyer profile	Buyer location	Unavailable	No reliable transaction-buyer data is available.
Live commerce	Current live-room products	Partial	Finds current live products by keyword and returns live_room_id; it does not list every product for a specified creator.
Data linkage	Historical creator-to-product attribution	Unavailable	Historical creator-to-product attribution is unavailable.

Start calling

Call POST /api/v1/social with platform=douyin and the selected action. Open the API card for parameters and response fields.

douyin_creator.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"product_search","params":{"keyword":"lipstick","limit":5}}'

Product search request example

Calling tips

Xingtu rankings, independent product search, and current live product search each have their own row limit. Do not combine results from different calls into one per-call limit.
Product detail accepts one numeric product_id per call. Use an ID returned by product search or current live product search, not a SKU ID, promotion ID, or title.
Current live product search is fixed to products that are live now. Send a keyword and a catalog-supported limit; there is no public parameter for filtering by a specified creator.
user_id, douyin_id, and Xingtu creator_id are different identifiers. Use the exact identifier required by the selected action.
Use the identifier required by each action. Check the marketplace for current fields, availability, and billing rules.

Open the Douyin creator workspace Integration guide