Targeting Suggestions
targeting-suggestions

Targeting Suggestions

GET accounts/:account_id/targeting_suggestions

Get up to 50 keyword or user targeting suggestions to complement your initial selection.

Resource URL

https://ads-api.x.com/12/accounts/:account_id/targeting_suggestions

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource's path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticating user.

Type: string

Example: 18ce54d4x5t

suggestion_type
required

Specify the type of suggestions to return.

Type: enum

Possible values: KEYWORD, USER_ID

targeting_values
required

Comma separated collection of either keywords or user IDs used to seed the suggestions.

Note: These two types of suggestions cannot be mixed.

Example: 756201191646691328

count
optional

Specifies the number of records to try and retrieve per distinct request.

Type: int

Default: 30
Min, Max: 1, 50

Example Request

GET https://ads-api.x.com/12/accounts/18ce54d4x5t/targeting_suggestions?suggestion_type=KEYWORD&targeting_values=developers&count=2"

Example Response

{
  "data": [
    {
      "suggestion_type": "KEYWORD",
      "suggestion_value": "devs"
    },
    {
      "suggestion_type": "KEYWORD",
      "suggestion_value": "software"
    }
  ],
  "request": {
    "params": {
      "suggestion_type": "KEYWORD",
      "targeting_values": [
        "developers"
      ],
      "count": 2,
      "account_id": "18ce54d4x5t"
    }
  }
}