---
title: "Get Frequently Used Contextual Segments"
method: GET
path: "/targeting_segments/frequently_used"
tags: ["Targeting"]
---

# Get Frequently Used Contextual Segments

`GET /targeting_segments/frequently_used`

## Request

- Base URL: `https://api.mediamath.com/api/v3.0`
- URL: `https://api.mediamath.com/api/v3.0/targeting_segments/frequently_used`
- Auth: OAuth 2
  - Authorization code: `https://auth.mediamath.com/authorize`
  - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services`
- TypeScript: <https://skmtc.dev/mediamath/apis/campaigns-api/docs/targeting_segments/frequently_used/get.ts> (a function with typed inputs; its response is checked against the schema)

Display the most frequently used contextual segments for a given advertiser. Only buyable segments are returned; the `top` limit is applied after non-buyable segments are excluded.

## Query parameters

- `advertiser_id` integer
- `top` integer

## Response `200`

Targeting segment friendly name response

- object
  - `data` object[], nullable
    - `id` number
    - `external_code` string
    - `friendly_name` string
    - `vendor_id` number
    - `vendor_name` string
    - `dimension_id` number
    - `code` string
    - `frequency` number
    - `name` string
    - `retail_cpm` number
    - `objective_id` number
    - `targeting_vendor_id` number
    - `segment_objective_name` string
  - `meta` object
    - `status` string

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response

---

[API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)