Discovery Agent

Creators matching a Discovery Agent profile

Resolve one profile to its matching creators. The profile's search_query and its structured filters are combined into the search that runs, so this returns exactly what the portal shows under that profile.

This is a read — POST only because the optional filters payload is a nested object that doesn't survive a query string. Nothing is created or modified.

Paginate with page / limit (max 1000 per page); total_creators is the full match count. Sort by any of: relevance_score, follower_count, gmv_num, avg_views, engagement_rate_segment. Supply filters to narrow the set further without editing the profile.

Each creator row carries its handle, follower/GMV/engagement metrics, categories, bio and the relevance_score that ordered it. Creator email addresses are omitted, matching the /ai-search surface.

Returns 404 when the profile doesn't exist or belongs to a different shop. Single-shop only.

post/discovery/profiles/{profile_id}/creators

Request

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

Path parameters

profile_idinteger required

Discovery Agent profile ID.

Request body

pageinteger

1-based page number.

limitinteger

Creators per page (max 1000).

sort_bystring

Column to sort by. One of: relevance_score, follower_count, gmv_num, avg_views, engagement_rate_segment.

sort_orderstring

'asc' or 'desc'.

filtersobject nullable

Extra filters applied on top of the profile's own query and filters — same shape as the AI-search filter payload, e.g. {"Performance": {"GMV": ["$5K-$10K"]}, "emailFilter": true}. Omit to get the profile's unmodified result set.

Response

Successful Response

profile_idinteger required
profile_titlestring required
total_creatorsinteger required
pageinteger required
limitinteger required
creatorsobject[] required

Changes

No operation changes recorded.