REreacherapp
Analytics

CRM v2 sample-request rows, with archivedCount and lastUpdatedAt

Changed on

The paginated sample-request pipeline for one shop — the rows behind the Sample Requests board. Each row carries the creator (handle, followers, level, rising-star / fast-growing signals, CRM tags), the product, the request's status and timestamps, and the creator's performance metrics (post rate, PPS score, average views, engagement rate, GMV per sample, videos per sample).

Filter by pipeline tab (status), product, SKU, creator profile, sourcing automation, tag, date range, free-text search, and any of the metric ranges (min_* / max_*). product_ids and sku_ids are AND-ed: passing both narrows to those SKUs rather than widening. show_archived returns the archived board instead; show_expiring narrows to requests about to expire. Response also reports archivedCount (requests hidden because the creator is archived), expiringCount, lastUpdatedAt (when this shop was last observed on TikTok; null if never) and a dataFreshness stamp.

Single-shop only, and only for shops on the CRM v2 pipeline — others get a 404 and should use /samples.

get/funnel/v2/requests

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/funnel/v2/requests
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

pageinteger

Page number, 1-based.

page_sizeinteger

Rows per page (max 100).

statusstring nullable

Pipeline tab to filter to. One of: toReview, readyToShip, shipped, pendingContent, completed, cancelled.

product_idsstring nullable

Comma-separated product IDs.

sku_idsstring nullable

Comma-separated SKU IDs. AND-ed with product_ids, so passing both narrows to those SKUs rather than widening.

profile_idsstring nullable

Comma-separated creator profile IDs.

automation_idsstring nullable

Comma-separated automation IDs that sourced the request.

tagsstring nullable

Comma-separated CRM tags.

created_fromstring nullable

Earliest request date, YYYY-MM-DD (inclusive).

created_tostring nullable

Latest request date, YYYY-MM-DD (inclusive).

searchstring nullable

Free-text search over creator handle / name.

sort_bystring

Sort field.

sort_directionstring

'asc' or 'desc'.

exclude_rejectedboolean

Drop rejected requests.

show_archivedboolean

Return archived requests instead.

show_expiringboolean

Only requests expiring soon.

min_post_ratenumber nullable
max_post_ratenumber nullable
min_pps_scorenumber nullable
max_pps_scorenumber nullable
min_avg_viewsnumber nullable
max_avg_viewsnumber nullable
min_engagement_ratenumber nullable
max_engagement_ratenumber nullable
min_live_gmvnumber nullable
max_live_gmvnumber nullable
min_shop_gmvnumber nullable
max_shop_gmvnumber nullable
min_creator_gmvnumber nullable
max_creator_gmvnumber nullable
min_avg_gmv_videonumber nullable
max_avg_gmv_videonumber nullable
min_gmv_samplenumber nullable
max_gmv_samplenumber nullable
min_videos_per_samplenumber nullable
max_videos_per_samplenumber nullable
min_followersnumber nullable
max_followersnumber nullable
sample_typestring nullable

Deprecated and ignored. Reacher syncs only free sample requests, so every request is returned whatever this is set to.

Response

Successful Response

expiringCountinteger
lastUpdatedAtstring nullable

Changes

  • a348f1ea69b4Revision changes
    • info

      added the optional property /// to the response with the status

  • ae7007aad0c4Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status