PRprezent
Audiences

Search audience profiles

Free-text and field-filtered search across audience profiles. Use the request body's limit field to cap how many matches are returned (most-relevant first) and the filterBy* fields to narrow the search.

post/api/v1/audiences/search

Request

  • Base URL
    https://api.prezent.ai
  • Auth
    HTTP bearer

Query parameters

featurestring

Filter by feature scope.

Request body

querystring

Free-text search query.

idstring

Filter to a single audience by id.

sortstring

Sort expression (for example name:asc).

filterByobject

Field-level filter.

filterByCollectionobject

Collection-level filter.

fieldsstring[]

Subset of fields to return.

extraFieldsstring[]

Additional fields to include beyond defaults.

limitinteger

Maximum number of results.

Response

Matching audiences returned.

successboolean

Always true on success.

itemsobject[]

Same audience profiles as result (present when paginating).

next_cursorstring nullable

Opaque cursor for the next page, or null on the last page. Pagination is opt-in — omit limit/cursor to receive the full list.

Changes

No recorded changes to this operation across all 3 revisions of this API.