Making Your First Call to SERP API v3
Note: the “target” field and “target_rankings” array in SERP API v3 have been eliminated. Instead, you may use our script for retrieving website ranking data. Learn more >>
The most resourceful foundation for any SEO tool and research is data from search engine results pages. DataForSEO SERP API will furnish you with the top-100 results for any keyword, location, and language from Google, Yahoo, Bing, Youtube and more.
Using our API is really easy. We will show you how to get SERP Advanced results. This endpoint provides a full overview of SERP data, including all additional elements like featured snippets, related search, knowledge graphs, and more.
This short guide and video will lead you through the process of data retrieval using Postman collection in JSON. If you use a different programming language, feel free to download examples for PHP, Python, and C# from our documentation.
We will outline how to use the Standard and Live methods of data retrieval. The first one requires making separate POST and GET requests, while the second one delivers the
results at once.
Setting a task
1First, you should log in to the new account dashboard that we’ve created for version three.
2Once the previous step is completed, you should download our Postman collection, if you haven’t yet. The examples will be saved on your desktop compressed in the gzip format. The folder will be called dataforseo_xmpl_v3_postman and you can find the file DataForSEO_v3.postman_collection.json inside of it.
3To import the collection, extract the file from the gzip archive, open Postman, click ‘Import’, and select the file or drag and drop the file into the import window.
After the import is completed, find the DataForSEO Postman collection in the sidebar, open the SERP API folder, choose standard and click on task_post.
Before heading to the body of the request, remember to fill in your credentials from the account dashboard in the authorization section of Postman.
4After you have done so, open the body of the request in Postman.
To set a task, specify search engine language, location, and the necessary keyword. In case you need to retrieve the results for a particular domain, specify it in the target field. For more information on additional fields that you can use, turn to our documentation. Once the body structure is ready, hit send. You will receive a response from the API server with information about the task we have just set. Find the “id” field and copy the value from it.
Retrieving results by id
1In the Postman sidebar, click on task_get_advanced under the serp folder. Replace the id variable at the end of the GET request with the id of the task that you have just copied:
2Fill in the authorization fields with your username and password from the account dashboard, and hit ‘send’. The results of the task will be displayed in the bottom window.
You can review all found SERP elements in the items array. To get a detailed description of each field, please, turn to our documentation. If you wish to check the accuracy of the results, find the check_url field and open it in the incognito window of your browser.
Retrieving real-time results
1Select the live folder in Postman sidebar and choose google_organic_advanced endpoint.
2Copy and paste your credentials from the account dashboard into the username and password fields to complete the authorization.
3To set a task, you should specify the language, location, and keyword for which the SERP data will be retrieved. Optionally, you can define the target domain, if you need the SERP results only for it. You can find additional fields that you may use in our documentation.
4Once you have specified all necessary fields, hit ‘send’.
5When you use the Live method, the API server will return the results of the task in response at once. The items array contains all found SERP elements. Our documentation provides a detailed description of each field.
That fast and simple, you have just made your first API call with DataForSEO. Now you are ready to explore the full power of DataForSEO SERP API.
Don’t hesitate to create a free account and try SERP API in our API Explorer.
If you’d like to learn more about testing our APIs through a graphic user interface, check out this Help Center article.
Sorry, the comment form is closed at this time.