Keywords Data API: Overview

Keywords Data API encompasses two datasources (Google and Bing) working with a broad range of endpoints:

Note that Google Ads Keywords Data API is based on the latest version of the Google Ads API that has replaced legacy Google AdWords API. If you’re using DataForSEO Google AdWords API, you need to upgrade to DataForSEO Google Ads API.

You can get the full list of available endpoints here. The returned results are specific to the indicated language, location, and other endpoint-specific parameters.

The restrictions of Google and Bing endpoints of Keywords Data API are related to Google Advertising Policy and Microsoft Advertising Ad Policies and Guidelines accordingly. Consequently, we are not able to return data for keywords that fall into such categories as weapons, tobacco, drugs, violence, terrorism, etc. If you want to learn more about Google restrictions and prohibited categories, check the article on our blog.

Please note that if you post, for instance, 100 keywords in a batch and at least one of them falls into one of the categories listed above, no data will be retrieved for the whole batch of keywords.

To find answers on common questions about Keywords Data API and find guidance on efficient use of its features, visit our Help Center.

Methods

The cost of using Keywords Data endpoints depends on the selected method and priority of task execution. Available methods and priorities are described below.

DataForSEO has two main methods to deliver the results: Standard and Live.

If your system requires delivering instant results, the Live method is the best solution for you. Unlike the Standard method, this method doesn’t require making separate POST and GET requests to the corresponding endpoints.

If you don’t need to receive data in real-time, you can use the Standard method of data retrieval. This method requires making separate POST and GET requests, but it’s more affordable. Using this method, you can retrieve the results after our system collects them.

‌Alternatively, you can specify pingback_url or postback_url when setting a task, and we will notify you on completion of tasks or send them to you respectively.

If you need to set several tasks, you can receive the list of id for all completed tasks using ‘Tasks Ready’ endpoint, and then collect the results of each separate task using ‘Task GET’ endpoint.
‌
You can send up to 2000 API calls per minute. Contact us if you would like to raise the limit.

Visit DataForSEO Help Center to get practical tips for request handling depending on your Keyword Data API payload volume.

Cost

The price depends on the method of data retrieval. The cost can be calculated on the Pricing page. You can check your spending in your account dashboard or by making a separate call to the User Data endpoint

You can test Keywords Data API for free using DataForSEO Sandbox.