Marketing API Version

Partner Categories

Partner categories are ads targeting groups created by our third party data providers. They are packaged targeting options to reach people on Facebook based on their off-Facebook activity. These categories are defined by partner data matching.

Browse

Partner categories are housed alongside Facebook categories within demographics and behaviors and are retrieved using the same search endpoints.

By class

Partner categories can be found within several targeting classes and are not handled differently from regular Facebook categories. To retrieve only Partner Categories, see By Account Id .

To browse ALL categories, query the search endpoint with type adTargetingCategory. :

https://graph.facebook.com/<API_VERSION>/search
nametypedescriptionrequired

type

string

specify adTargetingCategory

yes

class

string

one of targeting types or blank to retrieve the entire list

no


See Demographics and Behavior targeting for more information on browsing classes.

It is recommended to leave the class field blank as the classes in which a partner category falls is subject to change. Retrieve the entire list of categories and use the type value in the below response for the targeting spec. The response will include both Facebook categories and Partner categories.

Partner categories within the result set will have the following fields:

namedescriptiontype

id

Facebook ID of the targeting category

integer

name

Name of the targeting category

string

approximate_count

Estimated audience size of the target audience

string

path

Includes the category and any parent categories the targeting falls into

array of strings

description

Description of this category

string

source

The data source

string

partner

The data partner providing this category

string

type

Type of targeting category. Use this in the targeting spec

string

By Account Id

To retrieve the list of all partner categories accessible by your account (including permissioned partner categories), make an HTTP GET request to this endpoint with your access token:

https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/partnercategories

Optional parameters

nametypedescriptionrequired

private_or_public

string

either public or private

no

targeting_type

string

one of targeting types

no

Use cursor-based paging to download a full list of partner categories. The default limit is 25 and can be raised up to 1000

The response will be an array of json objects:

NameDescriptionType

id

The ID of this category

long

name

The name of this category

string

description

Description of this category

string

details

Additional details on this category

string

source

The data source

string

parent_category

Data provider

string

status

Status of the category (ready, waiting, error)

string

targeting_type

Type of targeting category. Use this in the targeting spec

string


Look for parent_category field to see who the data provider is.

Available Targeting Types

Behaviors:

  • behaviors

Demographics:

  • life_events
  • politics,
  • industries,
  • income,
  • net_worth,
  • home_type,
  • home_ownership,
  • ethnic_affinity,
  • generation,
  • household_composition,
  • moms,
  • office_type,
  • family_statuses

Uncategorized:

  • uncategorized

Using Partner Categories in Targeting

Partner categories are specified the same manner as Facebook categories. Use the type field returned in the browse response to specify partner categories in the targeting spec.

targeting={
  'behaviors':[
    {id: 6006142989425, 'name': 'Full-size SUV'},
  ],
  'household_composition':[
    {id: 6009218313499, 'name': 'Children in home'},
  ],
  'user_adclusters':[
    {id: 6006371326532, 'name': 'Recent homebuyer'},
  ],
}

For Partner Categories retrieved with class=uncategorized, their type will be user_adclusters.

Note: exclusion targeting is not supported for partner categories.