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.twitter.com/8/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.twitter.com/8/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"
    }
  }
}

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.