REreacherapp
AI Search

Export creator search results as CSV

Changed on

Export up to 50,000 matching creators as CSV. The response is a streaming attachment; the X-Creator-Row-Count response header reports the actual row count. CSV only — XLSX is not supported on the public API. Requires a single x-shop-id. The CSV includes a numeric gmv column in US dollars (the exact GMV, same value /ai-search/creators returns) — parse THIS for GMV, not gmv_segment. To filter server-side by an exact GMV, set min_gmv / max_gmv (or a numeric range under filters.performance.gmv); it is honored the same way the portal search does — a $2,000 floor keeps everyone earning $2,000+ rather than dropping a whole band. NOTE (breaking change vs the old export): gmv_segment is no longer a band like "$1K-$5K" — it is now a rounded USD display figure (e.g. "$120", "$2.1K", "$1.9M") derived from gmv, so anything parsing it as a band must switch to the numeric gmv column. min_post_rate/max_post_rate (aka the automations endpoint's fulfillment_rate) are on a 0–100 scale, not 0–1.

post/ai-search/export

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/ai-search/export
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Request body

min_gmvnumber nullable

Minimum GMV.

max_gmvnumber nullable

Maximum GMV.

min_units_soldnumber nullable

Minimum units sold.

max_units_soldnumber nullable

Maximum units sold.

min_post_ratenumber nullable

Minimum post rate (sample-fulfillment %) on a 0–100 scale, NOT 0–1. Same metric the automations endpoint calls fulfillment_rate. US/UK only.

max_post_ratenumber nullable

Maximum post rate (sample-fulfillment %) on a 0–100 scale, NOT 0–1.

min_engagement_ratenumber nullable

Minimum engagement rate, 0–100.

max_engagement_ratenumber nullable

Maximum engagement rate, 0–100.

min_average_viewsnumber nullable

Minimum average views.

max_average_viewsnumber nullable

Maximum average views.

min_followersinteger nullable

Minimum follower count.

max_followersinteger nullable

Maximum follower count.

has_emailboolean nullable

Only creators with (true) / without (false) an email.

has_ad_videosboolean nullable

Only creators whose search card shows (true) / doesn't show (false) a video that ran as a paid TikTok ad.

has_ai_videosboolean nullable

Only creators whose search card shows (true) / doesn't show (false) a video TikTok labels AI-generated.

categoriesstring[] nullable

Product categories (canonical names).

genderstring[] nullable

Creator gender, e.g. ["female"].

creator_ethnicitystring[] nullable

Creator ethnicity.

age_rangestring[] nullable

Creator age range, e.g. ["25-34"].

communitystring[] nullable

Community hashtags (US/UK/DE/ES only). Fetch valid values from GET /ai-search/hashtags.

creator_levelstring[] nullable

Creator GMV level tier, e.g. ["L5","L6","L7"] (L0=$0 through L7=$1.5M+). Same tiers the filter vocabulary lists as "Creator Level".

languagesstring[] nullable

Creator languages, e.g. ["english"].

audience_agestring[] nullable

Audience (follower) age band.

audience_genderstring[] nullable

Audience (follower) gender.

content_stylestring[] nullable

Content style, e.g. ["lifestyle"].

production_qualitystring[] nullable

Production quality, e.g. ["raw_ugc"].

personality_tonestring[] nullable

Personality / tone, e.g. ["relatable"].

face_visibilitystring[] nullable

Face visibility, e.g. ["sometimes"].

body_typestring[] nullable

Body type (~⅓ of creators populated).

hair_typestring[] nullable

Hair type, e.g. ["wavy"].

querystring nullable

Natural-language search query. Omit (or pass whitespace-only) to export the full browse universe for your shop's region.

creator_idsstring[] nullable

Explicit list of creator IDs to export. Mutually exclusive with query.

filtersobject nullable

Optional creator filters (categories, follower/GMV ranges, etc.), same shape as the portal search filters. Applied server-side so the export matches a filtered search. post_rate is on a 0–100 scale (sample-fulfillment %). Unrecognized filter keys are rejected with a 400 rather than silently ignored. Cannot be combined with the flat filter params (min_gmv, gender, hair_type, etc.) inherited above.

Response

Successful Response

Changes

  • 2840b044a7daRevision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

  • 291230805105Revision changes
    • info

      api operation id export_creators_ai_search_export_post removed and replaced with ai_search_export