GetBannerPhrases

Returns information about keywords.
A GetBannerPhrases (Live) version of this method exists.

Restrictions

Retrieving keywords from archived campaigns is not available.

Alert

The method only supports “Text & Image Ads”. To work with keywords for ads of all types, use the Keywords service in API version 5.

Input data

The structure of input data in JSON format is shown below.

{
   "method": "GetBannerPhrases",
   "param": [
      (long)
      ...
   ]
}

The param parameter contains an array of ad IDs BannerID (no more than 1000).

Output data

The method returns an array of BannerPhraseInfo objects with keyword information. The structure of output data in JSON format is shown below.

{
   "data": [
      {  /* BannerPhraseInfo */
         "BannerID": (long),
         "CampaignID": (int),
         "PhraseID": (long),
         "Phrase": (string),
         "IsRubric": (string),
         "Price": (float),
         "ContextPrice": (float),
         "AutoBroker": (string),
         "UserParams": {
            /* PhraseUserParams */
            "Param1": (string),
            "Param2": (string)
         }
         "StatusPhraseModerate": (string),
         "AutoBudgetPriority": (string),
         "Clicks": (int),
         "Shows": (int),
         "Min": (float),
         "Max": (float),
         "PremiumMin": (float),
         "PremiumMax": (float),
         "LowCTRWarning": (string),
         "LowCTR": (string),
         "ContextLowCTR": (string),
         "Coverage": [
            {  /* CoverageInfo */
               "Probability": (float),
               "Price": (float)
            }
            ...
         ],
         "ContextCoverage": [
            {  /* CoverageInfo */
               "Probability": (float),
               "Price": (float)
            }
            ...
         ],
         "Prices": [
            (float)
            ...
         ],
         "CurrentOnSearch": (float),
         "MinPrice": (float)
      }
      ...
   ]
}

The parameters are described below.

^Parameter	^Description
_{BannerPhraseInfo object}
`CampaignID`	Campaign ID.
`BannerID`	Ad ID.
`PhraseID`	Keyword ID.
`Phrase`	Keyword. May contain negative words, which are specified with a minus sign before the word, for example [lightning -thunder -rain]. Negative words common to several keywords should preferably be specified in the ad group's `MinusKeywords` parameter. Keyword length — no more than 4096 characters. The "!" operator before a negative word is not counted in the keyword length (the sequence "-!" is counted as one character). No more than 7 words in a keyword, excluding stop words and negative words. Each word and negative word — no more than 35 characters, excluding the minus before the negative word.
`IsRubric`	Indicator that the keyword is a Yandex Catalog category. Always contains the value No.
`Price`	Bid on Yandex Search (Yandex units). Default limit — 50 Yandex units. Required only if a manual bid management strategy is selected for the campaign.
`ContextPrice`	Bid in the Yandex Advertising Network (Yandex units). The bid can be specified in the following cases: The IndependentControl strategy is used on search. This strategy can only be selected through the Yandex Direct web interface. Any manual strategy is used on search and the keyword is disabled for low CTR. For new keywords, this condition is not relevant, since keywords are no longer disabled for low CTR.
`AutoBroker`	Indicator of enabled auto-broker. Always contains the value Yes.
`UserParams`	`PhraseUserParams` object. Contains values of substitution variables for forming the website link.
`StatusPhraseModerate`	Keyword check result: New — keyword not checked; Yes — accepted; No — rejected;
`AutoBudgetPriority`	Keyword priority when using automatic strategies. Possible values: Low — low priority; Medium — medium priority; High — high priority.
`Clicks`	Number of clicks on the ad served on search for this keyword. Calculated for 28 days from the current date. Days during which there was at least one click on the ad are selected for calculation.
`Shows`	Number of ad impressions for this keyword on search. Calculated for 28 days from the current date. Days during which there was at least one ad impression for this keyword are selected for calculation.
`Min`	Minimum bid for entry into the Guaranteed placement block.
`Max`	Minimum bid for 1st position in the Guaranteed placement block.
`PremiumMin`	Minimum bid for entry into Premium placement.
`PremiumMax`	Minimum bid for 1st position in Premium placement.
`LowCTRWarning`	Keyword has low CTR and may be disabled soon — Yes/No. Alert This parameter is no longer relevant for new keywords, since keywords are no longer disabled for low CTR.
`LowCTR`	Keyword disabled in search for low CTR — Yes/No. Alert This parameter is no longer relevant for new keywords, since keywords are no longer disabled for low CTR.
`ContextLowCTR`	Keyword disabled on Yandex Advertising Network sites for low CTR — Yes/No. Alert This parameter is no longer relevant for new keywords, since keywords are no longer disabled for low CTR.
`Coverage`	Array of `CoverageInfo` objects that indicate the predicted audience reach on search. Alert The parameter is no longer relevant and should not be used for bid selection.
`ContextCoverage`	Array of `CoverageInfo` objects that indicate the predicted audience reach in the Yandex Advertising Network. The parameter is useful for bid selection for keywords.
`Prices`	Array of bids for all positions in Premium placement and in the Guaranteed placement block.
`CurrentOnSearch`	Final click price taking into account auto-broker. If the ad is not being served on search for the keyword or the keyword is disabled on search for low CTR, the parameter returns the value NULL.
`MinPrice`	Minimum price, assigned individually for each advertiser.
_{CoverageInfo object}
`Probability`	Impression frequency at the bid from the `Price` parameter. In the `ContextCoverage` array, specified as a percentage from 0 to 100. Used for bid selection.
`Price`	Bid for which the `Probability` parameter contains the impression frequency.
_{PhraseUserParams object}
`Param1`	Value of the `{param1}` substitution variable. No more than 255 bytes.
`Param2`	Value of the `{param2}` substitution variable. No more than 255 bytes.
Notes
In rare cases, impression position prices and some other parameters related to auction results may have a NULL value, which indicates an error retrieving data on the API side. It is recommended to retry the method call after some time.

Was the article helpful?

GetBanners (Live)

GetBannerPhrases (Live)