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"
    }
  }
}