Sign in
Ad Groups

Search 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, browse demographic categories, languages); interests, work employers, job titles, schools, majors, and locations need a search term.

get/ad_groups/targeting_options

Query parameters

account_idstring

Account to search on behalf of. Defaults to the authenticated account.

platform'meta' required

The ad network whose targeting taxonomy to search.

querystring

The search term. Blank browses the fixed lists; interests, work employers, job titles, schools, majors, and locations return nothing without one.

typesstring[]

Kinds of targeting options to search. Defaults to all of them.

[
  "interests"
]
location_typesstring[]

Narrow location results to these kinds of places. Only applies when types includes locations.

[
  "country"
]
countrystring

Narrow location results to one country, as an ISO 3166-1 code such as US. Only applies when types includes locations.

limitinteger

Maximum number of results per requested type.

special_ad_categoriesstring[]

The campaign's declared special ad categories. Under housing, employment, or financial_products the ad platform allows interests only, drawn from a short approved list, so results are narrowed to what such a campaign can launch with and other kinds return nothing. Blank query browses that approved list instead of the usual fixed lists.

[
  "housing"
]

Response

types narrows the search and accepts a comma-separated list

Example response

{
  "data": [
    {
      "audience_size_lower_bound": 18400000,
      "audience_size_upper_bound": 21700000,
      "behavior_type": "video",
      "description": "People who have expressed an interest in or like pages related to car washing and detailing.",
      "id": "6003193685204",
      "name": "Car wash",
      "type": "interests"
    }
  ]
}

Changes

Changed in 5 of the 74 revisions of this API.914

  • 42ce5c13e53b1See the full diff
    • ○

      added the new optional query request parameter special_ad_categories

      new-optional-request-parameter

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6a23760847c854See the full diff
    • ●

      added the new district enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new dma enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new medium_geo_area enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new neighborhood enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new subcity enum value to the /// response property for the response status

      response-property-enum-value-added

    • ○

      added the enum value medium_geo_area to the property items/ of the query request parameter location_types

      request-parameter-property-enum-value-added

    • ○

      added the enum value neighborhood to the property items/ of the query request parameter location_types

      request-parameter-property-enum-value-added

    • ○

      added the enum value subcity to the property items/ of the query request parameter location_types

      request-parameter-property-enum-value-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

  • ae20b30817de45See the full diff
    • ●

      added the new education_majors enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new education_schools enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new work_employers enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new work_positions enum value to the /// response property for the response status

      response-property-enum-value-added

    • ○

      added the enum value education_majors to the property items/ of the query request parameter types

      request-parameter-property-enum-value-added

    • ○

      added the enum value education_schools to the property items/ of the query request parameter types

      request-parameter-property-enum-value-added

    • ○

      added the enum value work_employers to the property items/ of the query request parameter types

      request-parameter-property-enum-value-added

    • ○

      added the enum value work_positions to the property items/ of the query request parameter types

      request-parameter-property-enum-value-added

    • ○

      added education_majors education_schools work_employers work_positions discriminator mapping keys to the / response property for the response status

      response-property-discriminator-mapping-added

  • f1020c3ecda43See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 60bbb4a6ffbc1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.