Search third-party segments

get

https://{buzz_key}.api.beeswax.com/rest/v2/third-party/segment-search

Search across third-party segments shared with the active account. Returns a flat list of matching segment nodes.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

alternative_id

string

alternative_id__contains

string

alternative_id__in

array of strings

Multiple values may be separated by commas.

alternative_id__in

alternative_id__isempty

boolean

alternative_id__not

string

alternative_id__not_contains

string

alternative_id__not_in

array of strings

Multiple values may be separated by commas.

alternative_id__not_in

alternative_id__not_startswith

string

alternative_id__startswith

string

cpm

number

Only return third-party segments whose CPM exactly matches this value.

cpm__gt

number

Only return third-party segments whose CPM is greater than this value.

cpm__lt

number

Only return third-party segments whose CPM is less than this value.

data_provider_id

integer

Only return third-party segments whose data provider ID exactly matches this value.

data_provider_id__gt

integer

Only return third-party segments whose data provider ID is greater than this value.

data_provider_id__gte

integer

Only return third-party segments whose data provider ID is greater than or equal to this value.

data_provider_id__in

array of integers

Only return third-party segments whose data provider ID matches one of these values. Multiple values may be separated by commas.

data_provider_id__in

data_provider_id__isempty

boolean

When true, only return third-party segments with no data provider ID. When false, exclude them.

data_provider_id__lt

integer

Only return third-party segments whose data provider ID is less than this value.

data_provider_id__lte

integer

Only return third-party segments whose data provider ID is less than or equal to this value.

data_provider_id__not

integer

Exclude third-party segments whose data provider ID exactly matches this value.

data_provider_id__not_in

array of integers

Exclude third-party segments whose data provider ID matches one of these values. Multiple values may be separated by commas.

data_provider_id__not_in

favorite

boolean

Filter to the set of objects the user has "favorited".

name

string

Only return third-party segments whose name exactly matches this value.

name__contains

string

Only return third-party segments whose name contains this value (case-insensitive).

name__in

array of strings

Only return third-party segments whose name matches one of these values. Multiple values may be separated by commas.

name__in

name__isempty

boolean

When true, only return third-party segments with an empty or missing name. When false, exclude them.

name__not

string

Exclude third-party segments whose name exactly matches this value.

name__not_contains

string

Exclude third-party segments whose name contains this value (case-insensitive).

name__not_in

array of strings

Exclude third-party segments whose name matches one of these values. Multiple values may be separated by commas.

name__not_in

order

string

Which field to use when ordering the results.

string

A search term.

type

string

Only return third-party segments whose type matches this value ('segment' or 'category').

type__isempty

boolean

When true, only return third-party segments with an empty or missing type. When false, exclude them.

type__not

string

Exclude third-party segments whose type matches this value ('segment' or 'category').

user_count_by_region__apac__gt

integer

Only return segments whose APAC user count is greater than this value.

user_count_by_region__apac__lt

integer

Only return segments whose APAC user count is less than this value.

user_count_by_region__emea__gt

integer

Only return segments whose EMEA user count is greater than this value.

user_count_by_region__emea__lt

integer

Only return segments whose EMEA user count is less than this value.

user_count_by_region__nam__gt

integer

Only return segments whose North America (NAM) user count is greater than this value.

user_count_by_region__nam__lt

integer

Only return segments whose North America (NAM) user count is less than this value.

user_count_update_date__gt

date-time

Only return segments whose user count update date is after this timestamp.

user_count_update_date__lt

date-time

Only return segments whose user count update date is before this timestamp.

Responses

400

Invalid search or filter parameters.

401

Authentication credentials were not provided.

403

Permission denied.

500

Internal server error.

Language

Credentials

URL

Loading…

Response

Choose an example:

application/json

200Third-party segments retrieved successfully.