Skip to main content
Facebook AdsVersion: v3

Search targeting options

GET/ad-publishing/facebook/targeting/search

Search Facebook targeting options for ad set audience building. type selects which taxonomy is searched and determines the response shape: geolocation returns places, interest returns interests, behaviours, and demographics, and language returns locales. Geolocation and interest results are passed through from Facebook, so their fields are snake_case.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstring

Location identifier

Example:loc_abc123
typestringrequired

Targeting search type

Available optionsgeolocationinterestlanguage
Example:interest
querystringrequired

Search query string

Example:fitness
searchTypestring

Specific search subtype

Example:adgeolocation

Response

application/json

Matching targeting options. The item shape follows the requested type: geo results for geolocation, interest/behaviour/demographic results for interest (sorted by estimated reach, largest first), and locales for language.

  • Array items
    • oneOf
    keystringrequired

    Facebook geo key, used as the targeting id

    Example:1045272
    namestringrequired

    Location name

    Example:Thane
    typestringrequired

    Location granularity

    Available optionscountryregioncitysubcityneighborhoodzipgeo_marketelectoral_district
    Example:city
    country_codestring

    ISO country code

    Example:IN
    country_namestring

    Country name

    Example:India
    regionstring

    Region or state name

    Example:Maharashtra
    region_idnumber

    Numeric region id

    Example:1735
    supports_regionboolean

    Whether region-level targeting is available here

    Example:true
    supports_cityboolean

    Whether city-level targeting is available here

    Example:true
    geo_hierarchy_levelstring

    Position in the geo hierarchy. Absent on plain cities.

    Example:NEIGHBORHOOD
    geo_hierarchy_namestring

    Hierarchy label. Can differ from geo_hierarchy_level — a SUBCITY reports CITY here.

    Example:CITY