API version 5. History

August 1, 2024

Added the Maps and SearchOrganizationList fields to methods of the Campaigns service for unified performance campaigns.

July 1, 2024

Disabled manual bid management in the Yandex Advertising Network.

April 24, 2024

Added instructions on upgrading to a unified performance campaign.

March 22, 2024

Added the ListingAd structure to the Ads service.

Added the CustomPeriodBudget structure to methods of the Campaigns and Strategies services.

December 26, 2023

Added the NegativeKeywordSharedSetIds structure to the Campaigns service.

November 27, 2023

Added support for unified performance campaigns:

  • Added the UnifiedCampaign structure to the Campaigns service.

  • Added the UnifiedAdGroup structure to the AdGroups service.

  • Added the ShoppingAd structure to the Ads service.

  • Added a new adjusment AD_GROUP_ADJUSTMENT to the BidModifiers service (a group-level adjustment available for a unified performance group).

  • New parameters added to the Reports service:

  • Added UNIFIED_CAMPAIGN to the CampaignType field.

  • Added OFFER_RETARGETING to the CriterionType field.

November 21, 2023

Added the AutotargetingSettings structure to the Keywords service. Updated the autotargeting workflow diagram.

October 2, 2023

Added the getGeoRegions method to the Dictionaries service.

September 19, 2023

Added the ExplorationBudget structure to methods of the Campaigns and Strategies services.

September 11, 2023

Added the AutotargetingSearchBidIsAuto field to methods of the Bids, KeywordBids, and Keywords services to indicate whether automatic bid is enabled.

August 2, 2023

Added the Strategies service for working with portfolio strategies.

July 4, 2023

Added the GetRegionNames structure to the get method for the AdImages service.

April 13, 2023

Added the Type field to the add method for the AdImages service.

March 24, 2023

Added the ForbiddenPlatform and AvailableCampaignTypes fields to methods for the AgencyClients and Clients services.

September 6, 2022

Added the TrackingParams field to Campaigns methods (for “Text & Image ads”, “Dynamic ads”, and “Smart banners” campaigns) .

August 15, 2022

Added TinInfo and ErirAttributes structures to methods of the Agencyclients and Clients services.

July 19, 2022

Added new Subtype parameter values to the AdImages service.

July 13, 2022

Added a new role for the Direct advertiser and Advertiser — agency client users.

Added a new value for the Role parameter in the Clients and AgencyClients services.

April 29, 2022

Added the CampaignUrlPath field to the Reports service.

April 18, 2022

Added to the Reports service:

  • ClientLogin field.
  • Added the Offset field to the Page structure.

April 13, 2022

For Dynamic ads campaigns, now you can select a targeting category (the AutotargetingCategories structure).

March 29, 2022

Added the IsMetrikaSourceOfValue field to the PriorityGoals structure of the Campaigns service — for campaigns with the AVERAGE_CRR strategy.

March 25, 2022

New adjustment types added to the bidmodifiers service:

  • TABLET_ADJUSTMENT: Adjustment on tablets.
  • DESKTOPS_ONLY_ADJUSTMENT: Adjustment only on desktops.

January 26, 2022

Added the AdVideos service.

January 14, 2022

The NETWORK_DEFAULT and MAINTAIN_NETWORK_CPC parameters will soon be discontinued in Campaigns. Please update your applications before the end of January 2022.

November 22, 2021

The campaigns service now supports the PlacementTypes setting (ad placements in search results) for “Dynamic ads” campaigns.

November 19, 2021

New parameters added to the Reports service:

  • PRODUCT_EXTENSIONS, MARKET: To the ClickType field.
  • PRODUCT_GALLERY: To the Slot field.

November 12, 2021

Reports are now also available for campaigns created in the Campaign Wizard.

November 1, 2021

A new adjustment added to the bidmodifiers service:

  • INCOME_GRADE_ADJUSTMENT: Adjustment for income.

October 25, 2021

Added the VideoTarget parameter to Campaigns methods (for campaigns with the “Display campaign” type).

October 20, 2021

In the adgroups service, you can now create a group of Text & Image ads based on a feed:

  • Added the TextAdGroupFeedParams structure to the add method.
  • Added the TextAdGroupFeedParamsFieldNames parameter to the get method.
  • Added the TextAdGroupFeedParamsUpdate structure to the update method.

October 14, 2021

A new adjustment added to the bidmodifiers service:

  • SERP_LAYOUT_ADJUSTMENT: Adjustment for exclusive placement.

October 7, 2021

Disabled support for the WEEKLY_CLICK_PACKAGE parameter in the campaigns service.

September 3, 2021

In the keywords service, you can now select the targeting category (the AutotargetingCategories structure).

The TargetingCategory field was added to the Reports service.

August 2, 2021

In the ads service, you can now add video extensionsvideo extensions to ads with the MOBILE_APP_AD type:

  • Added the VideoExtension structure to the add, get, and update methods.

July 13, 2021

In the campaigns service, you now have the new PAY_FOR_CONVERSION_CRR strategy for campaigns with the “Text & Image Ads”, “Dynamic ads”, and “Smart banners” type.

The strategy will bring you conversions at a cost equal to the specified percentage of the revenue transferred for the goal.

June 23, 2021

Added the dynamicfeedadtargets service for managing dynamic feed ad targets.

June 2, 2021

New strategy in the campaigns service:

  • AVERAGE_CRR for “Text & Image Ads”, “Dynamic ads” and “Smart banners” campaigns.

You can use this strategy to get the maximum number of conversions for the selected goal, while maintaining the specified cost revenue ratio.

May 28, 2021

Added the FilterSchema parameter to the feeds service. This parameters specifies the name of the schema for creating filters.

May 24, 2021

In the adgroups service, you can now create a group of dynamic ads with the FEED subtype using the API:

  • Added the DynamicTextFeedAdGroupAdd structure with the FeedId field to the add method.
  • Added the FeedId field to the DynamicTextFeedAdGroupFieldNames parameter in the get method.

May 13, 2021

Added the IsAdaptive parameter to the creatives service methods.

April 13, 2021

New strategies added to the campaigns service for “Display campaigns”:

  • CP_AVERAGE_CPV
  • WB_AVERAGE_CPV

Strategies let you get the maximum number of video views over a given period within a given budget.

April 8, 2021

New strategy in the campaigns service:

  • PAY_FOR_CONVERSION_PER_FILTER: For “Smart banner” campaigns.

The strategy will bring you conversions at the CPA specified on strategy setup.

March 31, 2021

Added information about bonuses to be credited (the Bonuses parameter) to the agencyclients and clients services.

March 26, 2021

Disabled support for the ENABLE_EXTENDED_AD_TITLE option in the campaigns service. This option will be ignored in all API requests.

March 16, 2021

Added the campaign setting CAMPAIGN_EXACT_PHRASE_MATCHING_ENABLED to the campaigns service methods (for the following campaign types: “Text & Image ads”“Text & Image ads”, “Dynamic ads”“Dynamic ads”, and “Ads for mobile apps”“Ads for mobile apps”).

March 3, 2021

New strategy in the campaigns service:

  • PAY_FOR_INSTALL: For “Ads for mobile apps” campaigns.

The strategy lets you get conversions at a fixed price per app install.

February 8, 2021

Added support for video ads in “Ads for mobile apps”“Ads for mobile apps” campaigns:

  • Added support for ads of the MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD subtype in the ads service.

February 2, 2021

The Reports service now has the AvgEffectiveBid field.

December 4, 2020

Added the KEYWORD value for the MatchType field in Reports.

September 28, 2020

In the turbopages service, you can now search for Turbo pages using their links. Added new parameters: BoundWithHref, TurboSiteHref.

August 26, 2020

In the campaigns service, the parameter AverageCpa (for AVERAGE_CPA_PER_CAMPAIGN) / FilterAverageCpa (for AVERAGE_CPA_PER_FILTER) is mandatory in AVERAGE_CPA_PER_CAMPAIGN and AVERAGE_CPA_PER_FILTER strategies. The AverageCpc/FilterAverageCpc parameter is no longer used.

July 17, 2020

In the campaigns service, you can't optimize for all goals in WB_MAXIMUM_CONVERSION_RATE, AVERAGE_ROI, and AVERAGE_CPA strategies. Use the GoalId parameter for these strategies to pass the ID of a specific Yandex Metrica goal.

July 16, 2020

In the campaigns service, you can now optimize for all priority goals in the WB_MAXIMUM_CONVERSION_RATE strategy (the GoalId:13 parameter).

June 29, 2020

Added the PHONE value for the ClickType field in the Reports service.

June 8, 2020

New strategies added to the campaigns service:

  • PAY_FOR_CONVERSION: For “Text & Image ads” and “Dynamic ads” campaigns.
  • PAY_FOR_CONVERSION_PER_CAMPAIGN: For “Smart banner” campaigns.

These strategies will produce conversions for the price specified when setting up the strategy.

June 2, 2020

Changed the value of the bid coefficient for ads on mobile devices (BidModifier parameter).

March 26, 2020

For all advertising campaigns other than “Smart banner” campaigns, the limit on the number of linked tags (the CounterIds parameter for the campaigns service) was removed.

March 25, 2020

Added support for business profiles from Yandex BusinessYandex Business:

  • Added the Businesses service for getting the profiles of an advertiser's businesses.

  • Methods for the ads service now have the BusinessId parameter for Text & Image ads.

March 16, 2020

Added support for smart banners:

  • Added the feeds service for managing feeds (that is, files with product offers).
  • Added the smartadtargets service for managing filters (used as targeting criteria for smart banners).
  • The adgroups service now supports ad groups with the SMART_AD_GROUP type.
  • The creatives service now supports creatives with the SMART_CREATIVE type.
  • Ads with the SMART_AD type now supported in the ads service.
  • Bid adjustments of the SMART_AD_ADJUSTMENT type now supported in the bidmodifiers service.

Learn more about managing smart banners

February 25, 2020

All API services now support the Accept-Encoding: gzip header.

February 25, 2020

The Reports service has the new SMART_TILE value for the AdFormat field.

February 6, 2020

The agencyclients.get, clients.get methods now have new values for the Element parameter: GENERAL_DOMAIN_BLACKLIST_SIZE and VIDEO_DOMAIN_BLACKLIST_SIZE.

January 15, 2020

The Reports service has the new ADAPTIVE_IMAGE value for the AdFormat field.

December 19, 2019

Added targeting by user interests for Text & Image ads:

  • For a TEXT_AD_GROUP group, you can add an audience target with a retargeting list that has the AUDIENCE type and contains only audience segments based on short-term interests.
  • The response of the retargetinglists.get method now includes the AvailableForTargetsInAdGroupTypes parameter.

For details, see retargeting-list.

December 2, 2019

In the Reports service, the “Smart banners”“Smart banners” campaign type was changed to SMART_CAMPAIGN in the CampaignType field.

November 22, 2019

The AVERAGE_ROI strategy now provides optimization for priority goals. The GoalId parameter in the AverageRoi structure accepts the new value 13.

November 11, 2019

The dictionaries.get method now returns the new MinimumAccountDailyBudget parameter (the minimum daily budget of the shared account) in the Currencies reference list.

The MinimumPayment currency parameter, which previously combined both the minimum payment (without VAT) and the minimum daily budget of the shared account, should now be used only for the minimum payment amount.

October 1, 2019

Changes in the campaigns.get method: values of the return parameters SharedAccountFunds.Spend and CampaignFunds.Sum now include VAT.

September 25, 2019

In the campaigns service, the default value for ADD_METRICA_TAG in the Settings structure was changed from NO to YES.

September 17, 2019

Attribution models available in the API:

  • The campaigns service methods now have the AttributionModel parameter for “Text & Image ads”“Text & Image ads” and “Dynamic ads”“Dynamic ads” campaigns.
  • The Reports service for the AttributionModels input parameter has the new LYDC value: “Last click from Yandex Direct”. Statistics for the new attribution model are available starting from July 30, 2019.

September 9, 2019

Changes in the sitelinks service: a set of sitelinks can now contain up to 8 links.

August 28, 2019

The campaigns service now supports priority goals for “Dynamic ads”“Dynamic ads” campaigns: the PriorityGoals structure has been added to the DynamicTextCampaign structure.

August 22, 2019

Strategy settings were changed in the campaigns service:

  • The BidPercent parameter was removed from the NetworkDefault structure. The add and update methods return an error when trying to set it, and the get method no longer returns it.

  • The LimitPercent parameter in the NetworkDefault structure is used only when the search strategy is set to HIGHEST_POSITION.
    If an automatic strategy is selected for search:

  • The add and update methods ignore the specified value and display a warning message. To enable the strategy in NETWORK_DEFAULT networks, you need to pass an empty NetworkDefault structure.

  • The get method doesn't return the NetworkDefault structure.

  • The MAINTAIN_NETWORK_CPC setting in the Settings structure is used only when the search strategy is set to HIGHEST_POSITION and the strategy for ad networks is NETWORK_DEFAULT. In all other cases, the add and update methods ignore the passed value and issue a warning, and the get method does not return MAINTAIN_NETWORK_CPC.

To learn how the strategies in the API correspond to the updated strategies in the web interface, see strategies.

July 23, 2019

Image ads: Uzbekistan som. The ads service methods now accept the value UZS for the PriceCurrency parameter.

July 11, 2019

Support for sets of negative keywords:

  • Added a new negativekeywordsharedsets service for managing sets of negative keywords.
  • Added the NegativeKeywordSharedSetIds parameter to the adgroups service methods. The adgroups.get method can now filter ad groups that use specified sets of negative keywords.

June 24, 2019

Video ads are now supported in display campaigns:

  • The adgroups service now supports ad groups with the CPM_VIDEO_AD_GROUP type.

Alert

The Gather audience by completion rate setting is currently not supported in the API.

  • The ads service now supports ads with the CPM_VIDEO_AD type.

June 3, 2019

Changes to the retargetinglists service:

  • Lifted restrictions on retargeting lists that consist exclusively of rules with the NONE operator. Now these retargeting lists can use both Yandex Metrica goals and segments, as well as Yandex Audience segments.
  • The MembershipLifeSpan parameter is now used only for Yandex Metrica goals. For segments from Yandex Metrica and Yandex Audience, the add and update methods ignore the specified value.
  • The maximum number of days in the MembershipLifeSpan parameter increased to 540.

May 16, 2019

The creatives service now supports creatives with the type CPM_VIDEO_CREATIVE.

May 15, 2019

Support for Turbo pages:

  • Added the turbopages service to get Turbo pages created in the Turbo Page Builder.

  • The ads service methods now have the TurboPageId parameter. The response of the ads.get method now also includes the TurboPageModeration parameter.
    The Href parameter in the TextImageAd, TextAdBuilderAd, CpcVideoAdBuilderAd, and CpmBannerAdBuilderAd structures is now nillable in the methods ads.update and ads.get.

  • The sitelinks service methods now have the TurboPageId parameter.
    The Href and Description parameters are now nillable in the sitelinks.get method.

The sitelinks.get method method now includes the SitelinkFieldNames input parameter.

Learn more about Turbo pages

April 8, 2019

The Reports service supports priority goals:

  • Added the Profit field.
  • The values of Revenue, Profit, and GoalsRoi for priority goals are based on the conversion values specified in the campaign settings.

Learn more about priority goalsLearn more about priority goals

March 27, 2019

Prices can now be configured for Text & Image ads: methods in the ads service now have the PriceExtension structure.

March 11, 2019

The campaigns service has new settings for conversion strategies.

If one of the following strategies is selected for search:

  • AVERAGE_CPA, AVERAGE_ROI, or WB_MAXIMUM_CONVERSION_RATE for a “Text & Image ads”“Text & Image ads” campaign.
  • AVERAGE_CPI or WB_MAXIMUM_APP_INSTALLS for an “Ads for mobile apps”“Ads for mobile apps” campaign.

then there is no support for the NetworkDefault.BidPercent and NetworkDefault.LimitPercent parameters in ad networks, or for the MAINTAIN_NETWORK_CPC option in the Settings structure.

The add and update methods ignore the passed values and return a warning. To enable the strategy in NETWORK_DEFAULT networks, you need to pass an empty NetworkDefault structure.

The get method doesn't return the NetworkDefault structure or the MAINTAIN_NETWORK_CPC parameter.

February 4, 2019

The campaigns service now supports priority goals for campaigns with the “Text & Image Ads”“Text & Image Ads” type: the add, update, and get methods have the PriorityGoals structure.

January 9, 2019

Changes to the Reports service for smart banners:

  • For campaigns with the SMART_BANNER_CAMPAIGN type, if at least one of the Criterion, CriterionId, Criteria, or CriteriaId fields is specified, or data is filtered by the SmartBannerFilterId field, or the CRITERIA_PERFORMANCE_REPORT type is selected, a dash will be shown in the Impressions and Ctr fields.
  • The ImpressionShare field can be specified in conjunction with TargetingLocationId and TargetingLocationName.

December 25, 2018

The bidmodifiers service supports bid adjustments based on the device type for display ad groups. More about bid adjustments

December 10, 2018

Changes in the reference list of regions: the parent region of the Zabaykalsky Krai administrative area and the Republic of Buryatia is now the Far Eastern Federal District (Dalny Vostok), instead of Siberia.

We recommend calling the dictionaries.get method to get an updated list of regions.

December 6, 2018

The dictionaries.get method no longer supports Yandex units:

  • The YND_FIXED currency has been removed from the Currencies list.
  • For other currencies, the Rate and RateWithVAT parameters are no longer returned.

December 4, 2018

There are upcoming changes in the reference list of regions: the parent region of the Zabaykalsky administrative area and the Republic of Buryatia will be the Far Eastern Federal District (Dalny Vostok), instead of Siberia.

After the reference list is updated, we recommend calling the dictionaries.get method to request the new list.

November 26, 2018

The keywordsresearch.deduplicate method now has a new Operation input parameter to allow merging duplicates and eliminating overlaps both separately and in bulk.

November 12, 2018

The currency reference now shows the minimum and maximum CPM bids for display ads. To get the reference list, use the dictionaries.get method and enter Currencies as the reference list name in your request.

November 2, 2018

Crypta segments are available for behavioral targeting of display advertising:

  • The retargetinglists service supports behavioral segments in audience targets based on user profiles.
  • The dictionaries.get method returns behavioral indicators in the AudienceCriteriaTypes reference list and behavioral segments in the AudienceDemographicProfiles reference list.

November 1, 2018

Added a restriction: in an “Ads for mobile apps”“Ads for mobile apps” campaign, all ad groups must have the same app link.

October 3, 2018

Added the creatives service to get creatives designed in the Ad Builder that are available to the advertiser.

October 3, 2018

Added support for video ads in the ads service. Learn more about ad types

October 1, 2018

Added the keywordsresearch.deduplicate method to merge duplicates and eliminate overlaps in keyword arrays.

September 26, 2018

The following is now available for display campaigns in the API:

  • The campaigns service now supports campaigns with the CPM_BANNER_CAMPAIGN type.
  • The adgroups service now supports ad groups with the CPM_BANNER_AD_GROUP type.
  • The ads service now supports ads with the CPM_BANNER_AD type.
  • Added user profile support to the retargetinglists service, see retargeting-list.
  • The dictionaries.get method now allows getting reference lists for Crypta segments:
  • list of demographic segments: gender, age, income, family status and profession
  • list of demographic characteristics
  • list of user interest segments

Learn more about managing display campaigns

August 27, 2018

Changed restrictions: the maximum number of gender and age adjustments per campaign or ad group has been increased to 12.

August 21, 2018

The bidmodifiers and Reports services now support the age groups AGE_45_54 and AGE_55.

August 8, 2018

The Reports service has the new fields AvgTrafficVolume, WeightedCtr, and WeightedImpressions.

June 8, 2018

The Reports service has the new input parameters Goals and AttributionModels.

Changed how the value of the ConversionRate field is calculated: the number of converted sessions is now divided by the number of clicks instead of the total number of sessions.

May 30, 2018

Added the keywordbids.setAuto method, which is used to set bids for keywords in search results depending on the desired traffic volume.

May 3, 2018

The Reports service now returns statistics for “Display campaigns”“Display campaigns”:

  • Added the value CPM_BANNER_CAMPAIGN for the CampaignType field.

  • Added the new report type REACH_AND_FREQUENCY_PERFORMANCE_REPORT, which shows the new fields AvgCpm, AvgImpressionFrequency and ImpressionReach.

April 10, 2018

Added the keywordbids service for managing bids and priorities of keywords and autotargetings.

April 9, 2018

The Keywords.get method no longer allows getting the Productivity parameter: it always returns null (nil).

The dictionaries.get method no longer allows getting a list of recommendations for improving productivity: the ProductivityAssertions array is not returned.

March 29, 2018

Disabled support for the IMPRESSIONS_BELOW_SEARCH strategy (for all types of campaigns) in the campaigns service. If you pass this value in the BiddingStrategyType parameter for the Search structure, an error is returned.

March 19, 2018

Added the Leads service for getting data that users enter in forms on turbo pages.

February 26, 2018

The bidmodifiers service now supports video bid adjustments. More about bid adjustments

February 8, 2018

In the Reports service, added the values SMART_MULTIPLE and SMART_SINGLE for the AdFormat field.

January 29, 2018

Added the CriterionType field in the Reports service.

January 10, 2018

The clients.get method method now allows you to get agency parameters and user settings for the agency's representative.

December 13, 2017

The ads service now supports image ads that use creatives created in the Ad Builder. Learn more about ad types

November 27, 2017

Changed the amount of points deducted for calling the methods bids.get and keywords.get. Learn more about points

November 13, 2017

Changed the errors that are returned when the request can't be processed. Instead of error code 53, the following error codes are returned:

  • If the OAuth token is omitted in the request or has an invalid format (for example, it contains invalid characters), error code 8000 is returned.

Note

If the OAuth token is invalid, it returns error code 53 as previously.

  • If a request on behalf of an agency representative omits the advertiser's username, error code 8000 is returned.

  • If the Client-Login header specifies a non-existing username or a username for an advertiser that doesn't belong to this agency, error code 8800 is returned.

  • If the user doesn't have access to the Yandex Direct API, error code 3000 is returned.

October 17, 2017

Added support for autotargeting in the bids, keywords, and Reports services. Learn more.

September 27, 2017

The Reports service now has the reportsInQueue response header and filtration by the CampaignType field.

September 19, 2017

Added the campaign setting ENABLE_COMPANY_INFO to methods for the campaigns service (for “Text & Image Ads”“Text & Image Ads” and “Dynamic ads”“Dynamic ads” campaigns).

September 11, 2017

The campaigns service has disabled support for the ENABLE_BEHAVIORAL_TARGETING setting in the Settings structure.

August 29, 2017

Added support for JSON requests in the Reports service.

August 29, 2017

Added the agencyclients.add method for registering new agency clients and the agencyclients.update method for editing parameters of agency clients.

Added the clients.update method for editing advertiser parameters and user settings for an advertiser's representative.

August 15, 2017

In the ads service, added the Title2 parameter for Text & Image ads.

Changed the restrictions on the number of characters in the Title and Text fields for Text & Image ads, and in the Text field for dynamic ads.

Changes in the reference list of restrictions. We recommend getting the updated list by calling the dictionaries.get method with the Constants reference list specified in the request.

August 7, 2017

A report with the SEARCH_QUERY_PERFORMANCE_REPORT type now contains statistics on search queries not only in Yandex search, but also in search engines in the Yandex Advertising Network. They also support the Placement field now.

August 7, 2017

The campaigns service has disabled support for the ENABLE_AUTOFOCUS setting in the Settings structure.

July 4, 2017

Video extensions now supported for Text & Image ads:

  • Added the VideoExtension structure to methods for the ads service.

  • In the Reports service, added the VIDEO value for the AdFormat field.

For more information about how to assign and unassign video extensions, see the section launch-campaign.

June 28, 2017

Disabled support for the LOWEST_COST, LOWEST_COST_GUARANTEE, and LOWEST_COST_PREMIUM strategies in the campaigns service (for all types of campaigns). If you pass one of these values in the BiddingStrategyType parameter for the Search structure, an error is returned.

June 22, 2017

In the campaigns service, changes were made in settings for impressions for related keywords in “Text & Image ads”“Text & Image ads” campaigns:

  • The BudgetPercent parameter in the RelevantKeywords structure supports any integer values from 1 to 100.

  • The Mode parameter in the RelevantKeywords structure is not supported and its value is ignored.

  • The ENABLE_RELATED_KEYWORDS setting in the Settings structure is not supported.

The Reports service has the new fields MatchedKeyword, Criterion, and CriterionId.

June 20, 2017

Support for the 4th position in premium placement has been added to service bids: the P14 value in the Position parameter of the AuctionBids array, returned via the bids.get method, as well as the query parameter Position of the bids.setAuto method.

May 3, 2017

The bidmodifiers service now supports regional bid adjustments. More about bid adjustments

April 17, 2017

Added the keywordsresearch service for getting a forecast of impressions for keywords.

April 17, 2017

The adgroups.get method now includes the RestrictedRegionIds response parameter.

March 21, 2017

Added the Reports service for getting statistics.

March 6, 2017

Added the agencyclients service for managing agency clients.

February 28, 2017

You can now target mobile app ads by user interests (see audience-target):

February 14, 2017

Added support for negative keywords containing up to 7 words:

  • In the adgroups service — in the NegativeKeywords ad group parameter.

  • In the campaigns service — in the NegativeKeywords campaign parameter.

January 25, 2017

  • Added support for the “Rarely served” status: the methods adgroups.get, keywords.get, and bids.get now have the ServingStatuses request parameter and the ServingStatus response parameter.

  • The following keyword data is unavailable in groups with the “rarely served” status:

  • StatisticsSearch and StatisticsNetwork in the keywords.get method.

  • CompetitorsBids, SearchPrices, ContextCoverage, AuctionBids, MinSearchPrice, and CurrentSearchPrice in the bids.get method.

December 26, 2016

The ContextCoverage array in the bids.get method is unavailable for campaigns with the SERVING_OFF or NETWORK_DEFAULT display strategy.

November 9, 2016

Added the clients service for getting client information.

November 1, 2016

Added support for a new currency: the Belarusian ruble (BYN).

October 17, 2016

Alert

Account access may be suspended for advertisers using Yandex units who haven't made payments for over a year. In this case, calling API methods results in the error 54, and the web interface doesn't allow access to any operations except switching to a currency.

To continue using the API, you need to switch your account to a payment currency. To do this, click Switch now in the Yandex Direct web interface. For more information about switching to a currency, see the Help for Yandex Direct: Russian rublesRussian rubles or other currencyother currency.

October 13, 2016

The methods for the ads service have an extended set of possible values for the Action parameter (for mobile app ads).

October 13, 2016

Changes in the reference list of regions. We recommend calling the dictionaries.get method to get an updated list of regions.

In particular, the regions listed below have been removed from the list:

  • These regions can no longer be used when creating or editing ad groups.

  • In groups that used these regions, they have been automatically replaced with lower-level regions.

  • Statistics for these regions have been moved to higher-level regions.

List of deleted regions

Deleted region

Replaced by regions in the group settings

Statistics moved to the region

20524

West/Ukraine/CIS (excluding Russia)

20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550

187

20525

East/Ukraine/CIS (excluding Russia)

20536, 20537, 20538, 20539, 20540

187

20526

South/Ukraine/CIS (excluding Russia)

20541, 20542, 20543

187

20527

Central/Ukraine/CIS (excluding Russia)

20544, 20545, 20546, 20547, 20548, 20549

187

20528

North/Ukraine/CIS (excluding Russia)

20551, 20552

187

980

Baltic States/Europe

117, 179, 206

111

1004

Middle East/Asia

181, 210, 1056

183

October 12, 2016

Added a restriction for keywords: the maximum length of each word or negative keyword in a keyword is 35 characters.

September 28, 2016

Added the audiencetargets service for managing audience targets, and the retargetinglists service for managing retargeting lists. Learn more about audience targeting

September 20, 2016

Changes will be made to the regions reference list in approximately two to three weeks. After the reference list is updated, we recommend calling the dictionaries.get method to request the new list.

In particular, the regions listed below will be removed from the list:

  • You won't be able to specify these regions when creating or editing ad groups.

  • In groups that use these regions, they will be automatically replaced with lower-level regions.

  • Statistics for these regions will be moved to higher-level regions.

List of regions planned for deletion

Region to be deleted

To be replaced by regions in the group settings

Statistics will be moved to the region

20524

West/Ukraine/CIS (excluding Russia)

20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550

187

20525

East/Ukraine/CIS (excluding Russia)

20536, 20537, 20538, 20539, 20540

187

20526

South/Ukraine/CIS (excluding Russia)

20541, 20542, 20543

187

20527

Central/Ukraine/CIS (excluding Russia)

20544, 20545, 20546, 20547, 20548, 20549

187

20528

North/Ukraine/CIS (excluding Russia)

20551, 20552

187

980

Baltic States/Europe

117, 179, 206

111

1004

Middle East/Asia

181, 210, 1056

183

September 8, 2016

The ads.get method now includes the PROJECT_DECLARATION value for the AdCategories parameter.

September 6, 2016

The adgroups.get method now supports getting the parameters of a group of dynamic ads that has a feed as the data source.

August 22, 2016

Added support for image ads in the ads service. Learn more about ad types

Added the adimages service for managing images. This service supports image sizes for use in image ads. Learn more about images

August 11, 2016

The keywords.get method now includes the ModifiedSince request parameter.

June 2, 2016

In the bidmodifiers service, changed the acceptable coefficient values in bid adjustments for gender, age, and website users.

May 23, 2016

Now you can spend the agency's points instead of the advertiser's points for making requests from an agency representative. Learn more about points

May 10, 2016

The adextensions.get method now includes the States and ModifiedSince request parameters and the State and Associated response parameters.

April 18, 2016

Added the DisplayUrlPath parameter to the ads service methods, along with the DisplayUrlPathModeration parameter to the response of the ads.get method for Text & Image ads.

April 14, 2016

The dictionaries.get method now provides names of ad exchanges (SSPs).

March 30, 2016

The ExcludedSites campaign parameter now supports ad exchanges (SSPs).

March 29, 2016

The ads service now supports callouts for Text & Image ads and dynamic text ads. More about ads

  • Added support for images in the ads service for ads with the “Ads for mobile apps”“Ads for mobile apps” type.

  • Added the dictionaries service for getting reference data: regions, time zones, exchange rates, metro stations, restrictions on parameter values, and other information.

March 14, 2016

The BudgetPercent campaign parameter no longer supports the value –1. To allow unlimited spending on related keywords (within the campaign budget), use the value 100.

February 25, 2016

Added the campaign setting ENABLE_AREA_OF_INTEREST_TARGETING to the campaigns service methods (for all campaign types).

February 16, 2016

Added the OptimizeGoalId campaign parameter to methods of the campaigns service (for “Text & Image Ads”“Text & Image Ads” campaigns).

February 9, 2016

Changed the restrictions for keywords. Now an ad group can contain a maximum of 200 keywords, and the maximum length of each keyword is 4096 characters.

January 13, 2016

The adgroups.get method now includes the DomainUrlProcessingStatus parameter.

January 11, 2016

In the bidmodifiers service, changed the acceptable coefficient values in bid adjustments for gender, age, and website users.

December 15, 2015

Added the dynamictextadtargets service for managing targeting conditions for dynamic text ads. Learn more.

In the campaigns service, added campaign support for dynamic text ads. Learn more about campaigns

In the adgroups service, added group support for dynamic text ads. Learn more about ad groups

In the ads service, added support for dynamic text ads. More about ads

The bids.get method.

November 9, 2015

The keywords.get method has the added ability to get the number of impressions and keys for a keyword over 28 days.

The keywords.add method now allows setting the bid or priority for the keyword being created.

October 26, 2015

The adgroups service now supports groups for mobile app advertising. Learn more about ad groups

The ads service now supports ads for mobile app advertising. More about ads

September 30, 2015

The bids.setAuto method now allows calculating bids for search based on the minimum bid for second position in Premium Placement.

September 8, 2015

Added the bidmodifiers service for managing bid adjustments. More about bid adjustments

September 1, 2015

The bids.get method now allows you to get bidding results of a new auction: the minimum bid and the actual CPC for each position. If the FieldsNames input parameter is set to AuctionBids, the method returns the AuctionBids array.

June 26, 2015

Launched.

Previous
Other questions about the Yandex Direct API
Next
Upgrading to a unified performance campaign