Discovery Agent

Create a Discovery Agent creator profile

Create a new creator brief for the shop — a search_query plus optional demographic filters — and resolve it immediately, so the response carries the creator_count it matched.

The brief is created with source: user_created and shows up in GET /discovery/profiles right away. The stored title is regenerated from the query and filters rather than kept verbatim, so read it back from the response instead of assuming what you sent.

Requires read_write scope and an Idempotency-Key header — a replay of the same key and body returns the original 201 rather than creating a second brief. Single-shop only.

post/discovery/profiles

Headers

Idempotency-Keystring nullable

Request body

titlestring required

Human-readable name for the brief. The stored title is regenerated from search_query + filters, so it may come back normalized rather than exactly as sent.

search_querystring required

Natural-language description of the creators you want, e.g. 'skincare creators who film get-ready-with-me content'.

descriptionstring nullable

Optional longer note about what this brief is for.

filtersobject nullable

Structured demographic filters layered on top of the query — {"Gender": ["female"], "Age": ["25-34"], "Ethnicity": [...], "Region": [...]}. Single values are normalized to arrays.

Response

Successful Response

successboolean required
creator_countinteger required

Changes

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