Skip to content
Ads API •References / targets / Get Contextual Targets Targets

Get Contextual Targets Targets

Returns contextual targets information based on given query parameter.

Request

GET
/targets/contextual_targets

Response

A list of contextual targets.

    • key_group
      string
      Required

      UI grouping label (e.g. “DISPLAY_GROUP_GENRE”)

    • Required
      • visible
        string
        Required

        display setting for UI (e.g. “DISPLAY_TYPE_HIDE_IF_SENSITIVE”)

        Allowed values: "DISPLAY_TYPE_UNSPECIFIED", "DISPLAY_TYPE_VISIBLE", "DISPLAY_TYPE_HIDE_IF_SENSITIVE", "DISPLAY_TYPE_HIDE", "UNRECOGNIZED"
      • Required
        • id
          string
        • name
          string

Response sample

{  "targeting": [    {      "key_group": "DISPLAY_GROUP_GENRE",      "value": [        {          "visible": "DISPLAY_TYPE_HIDE_IF_SENSITIVE",          "target": [            {              "id": "genre_alternative"            },            {              "name": "Alternative"            }          ]        },        {          "visible": "DISPLAY_TYPE_VISIBLE",          "target": [            {              "id": "genre_rock"            },            {              "name": "Rock"            }          ]        }      ]    },    {      "key_group": "DISPLAY_GROUP_MOOD",      "value": [        {          "visible": "DISPLAY_TYPE_HIDE_IF_SENSITIVE",          "target": [            {              "id": "mood_chill"            },            {              "name": "Chill"            }          ]        },        {          "visible": "DISPLAY_TYPE_VISIBLE",          "target": [            {              "id": "mood_happy"            },            {              "name": "Happy"            }          ]        }      ]    },    {      "key_group": "DISPLAY_GROUP_ACTIVITIES_AND_SETTINGS",      "value": [        {          "visible": "DISPLAY_TYPE_HIDE_IF_SENSITIVE",          "target": [            {              "id": "act_and_set_workout"            },            {              "name": "Workout"            }          ]        }      ]    },    {      "key_group": "DISPLAY_GROUP_ANTI_TARGETING",      "value": [        {          "visible": "DISPLAY_TYPE_HIDE_IF_SENSITIVE",          "target": [            {              "id": "anti_sensitive"            },            {              "name": "Sensitive"            }          ]        },        {          "visible": "DISPLAY_TYPE_HIDE_IF_SENSITIVE",          "target": [            {              "id": "anti_children"            },            {              "name": "Children"            }          ]        }      ]    }  ]}