v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
customer_segment

List customer segments

Get a list of the customer segments in the specified ad_account_id.

get/ad_accounts/{ad_account_id}/customer_segments

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Query parameters

bookmarkstring

Cursor used to fetch the next page of items

page_sizeinteger

Maximum number of items to include in a single page. See documentation on Pagination for more information.

order'ASCENDING' | 'DESCENDING'

The order in which to sort the items returned: "ASCENDING" or "DESCENDING" by ID. Note that higher-value IDs are associated with more-recently added items.

include_sizingboolean

Include audience sizing in result or not

search_querystring

Search query. Can contain pin description keywords or comma-separated pin IDs.

Response

The request has succeeded.

bookmarkstring nullable