---
title: "Search Targeting Options"
method: GET
path: "/ad_groups/targeting_options"
tags: ["Ad Groups"]
---

# Search Targeting Options

`GET /ad_groups/targeting_options`

Searches the ad platform's targeting taxonomy for options to target an ad group with. Each result comes back in the exact shape the ad-group body accepts for its `type`, so it can be used in `detailed_targeting`, `regions`, or `languages` as-is. A blank `query` browses the small fixed lists (behaviors, demographic categories, languages); interests and locations need a search term.

## Query parameters

- `account_id` string
- `platform` 'meta', required
- `query` string
- `types` string[]
- `location_types` string[]
- `country` string
- `limit` integer

## Response `200`

types narrows the search and accepts a comma-separated list

- object
  - `data` TargetingOption[], required
    - union — One result from the ad-group targeting-options search. `type` picks the shape: detailed-targeting taxonomy options carry the ad platform's `id`, languages carry an ISO 639 `code`, and locations carry the platform `key` plus geographic context.
      - DetailedTargetingOption
        - `audience_size_lower_bound` number, nullable, required — Low end of the ad platform's estimate of how many people this option can reach. Null when the platform doesn't publish one.
        - `audience_size_upper_bound` number, nullable, required — High end of the ad platform's estimate of how many people this option can reach. Null when the platform doesn't publish one.
        - `description` string, nullable, required — The ad platform's description of who the option covers, when it publishes one.
        - `id` string, required — The ad platform's ID for the option in its targeting taxonomy. Use it as the `id` of a `detailed_targeting` entry.
        - `name` string, required — Display name, such as `Movies`.
        - `type` 'interests' | 'behaviors' | 'life_events' | 'industries' | 'income' | 'family_statuses', required — Which detailed-targeting field the option belongs in: `interests`/`behaviors` go in `detailed_targeting.interests`/`.behaviors`; the demographic categories go in `detailed_targeting.demographics` with this value as the entry's `type`.
      - LanguageTargetingOption
        - `code` string, required — ISO 639 code the ad-group `languages` field takes, such as `en`.
        - `name` string, required — Display name, such as `English`.
        - `type` 'languages', required — Always `languages`. The option goes in the ad-group `languages` field.
      - LocationTargetingOption
        - `code` string, nullable, required — The standardized code the ad-group targeting fields take: an ISO 3166-1 code for countries (`US`) or an ISO 3166-2 code for US states and DC (`US-CA`). Null for locations without one, such as cities — target those by `key` instead.
        - `country_code` string, nullable, required — ISO 3166-1 code of the country the location sits in.
        - `country_name` string, nullable, required — Name of the country the location sits in.
        - `key` string, required — The ad platform's key for the location in its location taxonomy. Use it as the `key` of a `regions` city or zip entry.
        - `location_type` 'country' | 'region' | 'city' | 'zip', required — Kind of location: `country`, `region`, `city`, or `zip`.
        - `name` string, required — Display name, such as `California`.
        - `region` string, nullable, required — Name of the state or province a city sits in. Null for everything but cities.
        - `type` 'locations', required — Always `locations`. The option goes in the ad-group `regions` field.

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/866821546d67/schema)