Migration to Yahoo! JAPAN Ads API

Yahoo! JAPAN Promotional Ads API can be continuously used once after Yahoo! JAPAN Ads API starts. Required ad creatives and ad quality will not change.
The data added by Yahoo! JAPAN Promotional Ads API can be edited by Yahoo! JAPAN Ads API, and vice versa.
Please also note that Yahoo! JAPAN Promotional Ads API will close in 2020.
Learn more about the closing on the announcement.

The changes of protocol and authentication from Yahoo! JAPAN Promotional Ads API will gain the following benefits when using Yahoo! JAPAN Ads API.

  • Fast feature release and enhancement cycles
  • Security on API connection improves by OAuth authentication

Major differences between Yahoo! JAPAN Promotional Ads API and Yahoo! JAPAN Ads API are as follows.

EntityYahoo! JAPAN Promotional Ads APIYahoo! JAPAN Ads API
Protocol SOAP REST
Authentication Basic authorization OAuth
Intended for Agencies, Tool providers Company who requests to use Yahoo! JAPAN Ads API
Ad contents Search Ads, Display Ads (YDN only) Search Ads, Display Ads
Authorized by Application Account Yahoo! JAPAN Business ID
Your codes can be tested on Sandbox Test account

Everyone needs to apply for the new Yahoo! JAPAN Ads API before start using. When you apply, you need to accept "Yahoo! JAPAN Ads API Terms of Use."
Since the program format and authentication are different from former API, applications need to be developed in accordance with a specification of Yahoo! JAPAN Ads API.
Please consider to migrate to Yahoo! JAPAN Ads API using Yahoo! JAPAN Promotional Ads API together.

Service change by migration

API services changed by migration from Yahoo! JAPAN Promotional Ads API to Yahoo! JAPAN Ads API and unsupported services on Yahoo! JAPAN Ads API are as follows.

■Migration to Yahoo! JAPAN Ads Search Ads API

*See also the changes from YDN API

Service nameChanges from Sponsored Search API
AccountService - Get test account was added.
- Following items were added to the response.
  - Access information of Yahoo! JAPAN business ID
  - Test account flag
AdGroupFeedService Removed devicePlatform.
AuditLogService When downloading change history, run AuditLogService/download.
CampaignExportService When downloading campaign information, run CampaignExportService/download.
CampaignFeedService Removed devicePlatform.
FeedFolderService Changed the service name to "FeedService".
FeedItemService Removed LINK_URL.
PageFeedItemService - When downloading feed items, run PageFeedItemService/download.
- When downloading the file of error details, run PageFeedItemService/downloadErrorFile.
- When uploading feed files, POST required parameters on PageFeedItemService/upload.
ReportDefinitionService When downloading reports, run ReportDefinitionService/download.

■Migration to Yahoo! JAPAN Ads Display Ads API

Service nameChanges from YDN API
AccountService - Get test account was added.
- Following items were added to the response.
 - Access information of Yahoo! JAPAN business ID
 - Test account flag
FeedDataService - When uploading feed files, POST required parameters on FeedDataService/upload.
- When downloading the file of error details, run FeedDataService/downloadErrorFile.
FeedHolderService Changed the service name to "FeedService".
MediaService When downloading images, run MediaService/download.
ReportDefinitionService When downloading reports, run ReportDefinitionService/download.
VideoService - When uploading video files, POST required parameters on VideoService/upload
- When downloading video files, run VideoService/download.

See also the following information website and documentations for more about Yahoo! JAPAN Promotional Ads API.