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.
Request
- Base URLhttps://api.reacherapp.com/public/v1
- AuthAPI key in header x-api-key and API key in header x-shop-id
Path parameters
Discovery Agent profile ID.
Request body
Response
Successful Response
Changes
No operation changes recorded.