# Frequently Used Audience Segments

Display the most frequently used audience segments for a given advertiser or campaign.

Endpoint: GET /audience_segments/frequently_used
Version: xx.xx.xx
Security: Auth0

## Query parameters:

  - `advertiser_id` (integer)
    Numeric ID of the advertiser to filter on

  - `campaign_id` (integer)
    Numeric ID of the campaign to filter on

  - `top` (integer)
    limit of top elements

## Response 200 fields (application/json):

  - `data` (array,null)

  - `data.id` (number)

  - `data.external_code` (string)

  - `data.friendly_name` (string)

  - `data.vendor_id` (number)

  - `data.vendor_name` (string)

  - `data.dimension_id` (number)

  - `data.code` (string)

  - `data.frequency` (number)

  - `data.name` (string)

  - `data.retail_cpm` (number)

  - `data.objective_id` (number)

  - `data.targeting_vendor_id` (number)

  - `data.segment_objective_name` (string)

  - `meta` (object)

  - `meta.status` (string)
    Example: "success"

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)

## Response 401 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)