Yahoo! JAPAN Ads API | Developer Center

2025/05/29

Yahoo! JAPAN Ads API v17 release

We will release a new version of Yahoo! JAPAN Ads API.

Products

• Yahoo! JAPAN Ads Search Ads API
• Yahoo! JAPAN Ads Display Ads API

Version released

v17

Schedule

June 30, 2025
*This date is subject to change.

Changes to the Search Ads API

Ad display asset removal feature
We will support the ad display asset remove feature. You can use this feature only after the release. See the following announcement for details.
Ad display asset removal feature

Services
AssetService

Changes
Add "/remove" to AssetService.
*We will apply this addition to v15 and v16.

Sample request and response example
■Sample request

{
  "accountId": 111,
  "operand": [
    {
      "assetId": 1111
    },
    {
      "assetId": 2222
    }
  ]
}

■Response example
*The content returned is the same as with add or set.

{
  "errors": null,
  "rid": "rid0000",
  "rval": {
    "values": [
      {
        "errors": null,
        "asset": {
          "accountId": 111,
          "assetId": 1111,
          "assetData": {
            // Data related to asset details
          },
          // Omitted
        },
        "operationSucceeded": true
      }, ...
      // Multiple entries will be returned if multiple assets are removed
    ]
  }
}

Changes to the Display Ads API

End of search keyword targeting
With the end of support for "Search keyword targeting," we will also end the creation and modification of search keyword lists. Learn more in the following announcement.
End of search keyword targeting

Services
・SearchKeywordListService/add, set

Changes
・Remove add and set from the SearchKeywordListService endpoint.

Adding URL to the audience list "Advanced segments"
You will be able to specify a URL in the "Advanced segments" of the audience list. Additionally, you will be able to get the user size for the specified URL using the EstimatedUserSizeService.
*This feature is already available in the Campaign Management Tool. Learn more in the following announcement.
Adding URL to the audience list "Advanced segments"

Services
・AudienceListService
・EstimatedUserSizeService

Changes
・Add "urls[]" to advancedSegmentsAudienceList in AudienceListService.
・Add "urls[]" to the selector in EstimatedUserSizeService.

Adding features for the campaign goal "Gain friends" ads
We will support adding "Carousel" ads for the campaign goal "Gain friends." Additionally, we will support the addition of settings for "Responsive (image/video)."
*This feature is already available in the Campaign Management Tool. Learn more in the following announcement.
Adding features for the campaign goal "Gain friends" ads

Services
・AdGroupAdService/get,add,set

Changes
・get
　-You will be able to get carouselGainFriendsAd.
　-You will be able to get the viewing beacon URL with responsiveGainFriendsAd.
・add
　-You will be able to add carouselGainFriendsAd.
　-You will be able to add the viewing beacon URL with responsiveGainFriendsAd.
　-When the adType is RESPONSIVE_GAIN_FRIENDS_AD, you will be able to specify the following:
　 Third-party script tag src attribute URL
　 Viewable impression beacon URL
・set
　-You will be able to modify carouselGainFriendsAd.
　-You will be able to modify the viewing beacon URL with responsiveGainFriendsAd.

End of site category targeting
With the end of support for "Site category targeting," we will remove the relevant items. Site category targeting is no longer available. Learn more in the following announcement.
End of site category targeting

Services
・AdGroupTargetService/get,add,set,replace,remove
・StatsService/get
・ReportDefinitionService/getReportFields
・PlacementUrlIdeaService/get
・DictionaryService/getSiteCategory

Changes
・In AdGroupTargetService/get, add, set, replace, remove, make the following changes:
　-Remove "SITE_CATEGORY" from targetType.
　-Remove "siteCategoryTarget" from Request and Response.
・In StatsService/get, make the following changes:
　-Remove "SITE_CATEGORY" from targetType.
　-Remove "siteCategoryTarget" from Request and Response.
・Remove "SITE_CATEGORY" from reportType in ReportDefinitionServic/getReportFields.
・In PlacementUrlIdeaService/get, make the following changes:
　-Remove "siteCategories[]" from Request.
　-Remove "siteCategory[]" from Response.
・Remove "getSiteCategory" from the endpoints of DictionaryService.

Specification change for download files of Dynamic Ads for Display
We will support the specification change for files downloaded in Dynamic Ads for Display.
*This feature is already available in the Campaign Management Tool. Learn more in the following announcement.
Emoji addition and file management specification changes

Services
・FeedService/downloadDisApprovalReasonList
・FeedDataService/downloadErrorFile

Changes
・In FeedService/downloadDisApprovalReasonList, you will be able to specify "SJIS" for encoding.
・You will be able to specify encoding in FeedDataService/downloadErrorFile.

Maintenance

• We will modify the "limitValue" field in FeedService/get to int64 (long type).
• You won't be able to create reports specifying an MCC account.
  If you specify an MCC account or root MCC in ReportDefinitionService, error code 0097 will be returned.
• We will modify the errors in the following fields of CampaignService.
  skanOptimaizeAdDeliveryEnabled → skanOptimizeAdDeliveryEnabled

Search Ads API and Display Ads API

In the Java client library, release versions with the suffix "-spring5" will no longer be supported as of v17.

Comments

Find more details in the release notes and reference documents provided in the upcoming release.

End of Yahoo! JAPAN Ads API v15

Yahoo! JAPAN Ads API v15 will end with the following schedule:
Support end date: July 28, 2025
End of life date: Early of November 2025 (scheduled)
*Wait for further announcements with detailed schedules.

Yahoo! JAPAN Ads API v14 will end with the following schedule:
End of life date: July 28, 2025
*Support for this version has already ended.