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 is due to replace Google AdWords API by April 2022. If you’re using DataForSEO Google AdWords API, you need to upgrade to DataForSEO Google Ads API by April 27th, 2022.
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.
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
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.
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.