Yahoo! JAPAN Ads API | Developer Center

Before you start

This page shows an overview of start using Yahoo JAPAN Ads API, including the process based on your situation.
・Process overview
・Access
・Process based on your situation

Process overview

You need to take the following steps before an API call.

1. Sign up for API (for each company)
Who: A company that owns the application being developed
　　　*Not necessarily a developer.
　　　 For example, when a company outsources development, the company still owns the application.
Steps: Apply API Use

2. Add application (for each application)
Who: A company that owns the application being developed
　　　*Not necessarily a developer.
Steps: Add Application

3. Authentication (for each Business ID that has ad account access)
　Who: A company that uses the application
　Steps: Companies that develop their own applications: API call
　　　　 Companies using third-party tools: Approve Application

4. API call
Who: Developer of the application
Steps: API call

The steps required vary depending on the user. Learn more about process based on your situation.

Access

Each step requires the following access:
・Administrator permission: Sign up for API
・Administrator permission of Yahoo! JAPAN Ads API Management Console: Add application
・Read-only or Edit permission for the Campaign Management Tool (ad account): Authentication

Process based on your situation

This section describes the process based on your situation.
Answer questions in the flow chart and find the best case for you.

Case 1

Companies that manage their ad accounts and want to operate them through their applications (agencies, companies that manage ads in-house, etc.)

(Example) Agency-A develops application-B using the Yahoo! JAPAN Ads API. Agency-A uses application B and operates accounts 11111 and 22222 managed by the agency.

1. Sign up for API (for each company)
　Who: A company that owns the application being developed
　　　→Agency-A
2. Add application (for each application)
　Who: A company that owns the application being developed
　　　→Agency-A
3. Authentication (for each Business ID that has ad account access)
　Who: A company that uses the application
　　　→Agency-A
4. API call
　Who: Developer of the application
　　　→Agency-A

Case 2

Companies (advertisers, etc.) that let an agency manage their ad accounts and want to operate them through their applications

(Example) Advertiser-A develops the application-C using the Yahoo! JAPAN Ads API. Advertiser-A uses application-C and operates accounts 11111 and 22222 managed by agency-B.

1. Sign up for API (for each company)
　Who: A company that owns the application being developed
　　　→Advertiser-A
2. Add application (for each application)
　Who: A company that owns the application being developed
　　　→Advertiser-A
3. Authentication (for each Business ID that has ad account access)
　Who: A company that uses the application
　　　→Advertiser-A
　　　　*Generally, agency-B gives advertiser-A a Business ID that has ad account access.
4. API call
　Who: Developer of the application
　　　→Advertiser-A

Case 3

Companies (commercial tool vendors, etc.) that want to develop ad management tools using Yahoo! JAPAN Ads API and make them available to other companies (Example) Company-A develops the third-party tool-C using the Yahoo! JAPAN Ads API. Company-B uses the third-party tool-C and operates accounts 11111 and 33333, managed by Agencies D and E.

1. Sign up for API (for each company)
　Who: A company that owns the application being developed
　　　→Company-A
2. Add application (for each application)
　Who: A company that owns the application being developed
　　　→Company-A
3. Authentication (for each Business ID that has ad account access)
　Who: A company that uses the application
　　　→Company-B
　　　　*Company B needs to receive a Business ID that has ad account access from Agencies D and E and
　　　　 authenticate with that Business ID. (Approve application)
　　　　Company A, a third-party tool vendor, needs to send the URL for approval to Company B that uses the tool.
　　　　Company B needs to authenticate it.
　　　　Reference: Yahoo! JAPAN Ads API requires authentication using OAuth2.0.
　　　　　　　　　　About OAuth2.0
4. API call
　Who: Developer of the application
　　　→Company-A

Case 4

Companies that use ad management tools (third-party tools) provided by companies other than LY Corporation
You don't need to be responsible for using Yahoo! JAPAN Ads API when you use third-party tools.
Use the authentication method that the third-party tool provides.

Developer Center

Related sites: