xiaohongshu

Xiaohongshu PGY creator search

Find Xiaohongshu creators on PGY by search terms, by the filters of PGY's creator square, or both: followers, the price of a sponsored note, estimated CPM, median reads and interactions of everyday and sponsored notes, image or video creators, content category, content feature, persona, where they are, gender, followers' gender and age, industry worked with lately; leaving out the inactive and those losing followers; ordered by followers, price, reads, interactions, shop visits, cost per read, invitations answered, growth, completion and more. Each with creator ID, name, handle, location, content categories and followers, and in the full view prices and medians. A search goes as far as its first 5,000 creators. The creator ID the other PGY endpoints take comes from here.

Price: $0.04 per call.

20 items on a usual page, 20 at most. A cursor is valid for 3600 seconds.

Preview: the returned object may change, announced beforehand.

get/v1/xiaohongshu/pgy/creators/search

Request

  • Base URL
    https://api.dataxapi.com
  • Auth
    HTTP bearer

Query parameters

querystring

Search terms, matched against what creators' notes are about; for terms no creator matches the platform still returns loosely related creators, not an empty result. Leave out to find by the filters alone

sort'relevance' | 'most_followers' | 'lowest_rate' | 'highest_rate' | 'most_reads' | 'most_engagements' | 'most_impressions' | 'most_sponsored_reads' | 'most_sponsored_engagements' | 'most_sponsored_impressions' | 'most_shop_visits' | 'lowest_read_cost_image' | 'lowest_read_cost_video' | 'highest_reply_rate' | 'fastest_growth' | 'most_active_followers' | 'most_thousand_like_notes' | 'highest_completion_rate'

Order: relevance (the default); most_followers; lowest_rate, highest_rate; most_reads, most_engagements, most_impressions (medians of everyday notes); most_sponsored_reads, most_sponsored_engagements, most_sponsored_impressions; most_shop_visits; lowest_read_cost_image, lowest_read_cost_video (estimated cost per read); highest_reply_rate; fastest_growth; most_active_followers; most_thousand_like_notes; highest_completion_rate (of videos)

followers_mininteger

At least this many followers

followers_maxinteger

At most this many followers

rate_mininteger

Rate at least this, in yuan: of an image note, or of a video note with type=video

rate_maxinteger

Rate at most this, in yuan: of an image note, or of a video note with type=video

cpm_mininteger

Estimated CPM at least this, in yuan: of an image note, or of a video note with type=video

cpm_maxinteger

Estimated CPM at most this, in yuan: of an image note, or of a video note with type=video

median_reads_mininteger

Median reads of everyday notes at least this

median_engagements_mininteger

Median interactions of everyday notes at least this

sponsored_median_reads_mininteger

Median reads of sponsored notes at least this

type'image' | 'video'

Creators mostly of image notes (image) or of video notes (video); both when left out

categorystring

Content category, top or second level (such as 护肤 or 面部保养), in PGY's own words; only a value of its dictionary is taken, anything else is a 400

feature_tagstring

Content feature, top or second level (such as vlog or 探店), in PGY's own words; only a value of its dictionary is taken, anything else is a 400

personastring

Persona, any level (such as 妈妈 or 职业身份), in PGY's own words; only a value of its dictionary is taken, anything else is a 400

locationstring

Where the creator is, a province or a city (such as 上海 or 杭州), in PGY's own words; only a value of its dictionary is taken, anything else is a 400

gender'female' | 'male'

The creator's gender: female or male

audience_gender'female' | 'male'

Creators whose followers are mostly women (female) or men (male)

audience_age'under_18' | '18_24' | '25_34' | '35_44' | 'over_44'

The age band most of the followers are in: under_18, 18_24, 25_34, 35_44, over_44

industry'beauty' | 'food_drink' | 'mother_baby' | 'electronics' | 'household' | 'fashion' | 'internet' | 'local_services' | 'home_building' | 'auto'

Creators who worked with this industry lately: beauty, food_drink, mother_baby, electronics, household, fashion, internet, local_services, home_building, auto

exclude'low_active' | 'follower_drop' | 'both'

Creators to leave out: low_active, the inactive; follower_drop, those losing followers; both

cursorstring

The next_cursor of the previous page. A new page is a new call.

view'compact' | 'standard' | 'full'

How much of each item: compact (the most used fields, long text cut short), standard, or full (adds ext).

fieldsstring[]

Return only these fields of each item, by path (author.name).

Response

OK

code'ok' required
request_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.