Today we are excited to announce some new features we’ve been working on over the past month. For this mid-spring update, we really wanted to give you something special. Here, at DataForSEO we believe these updates will become a game-changer for your SEO software project. So, let’s cut to the chase here.
LIVE EXTRA SERP API
Newly released Live Extra SERP API allows for real-time collection of Extra SERP API data. You can try it out using the following endpoint:
https://api.dataforseo.com/v2/live/srp_extra_tasks_post
The request structure is similar to that of a regular Extra SERP API. The response, however, is real-time so you don’t have to send a separate GET request to obtain it. Here’s an example of the Live Extra SERP request and response:
Request Sample
https://api.dataforseo.com/v2/live/srp_extra_tasks_post
{
"data":
{
"post ID 1":
{
"se_name":"google.co.uk",
"se_language":"English",
"loc_name_canonical":"London,England,United Kingdom",
"key":"rank checker"
}
}
}
Response Sample
{
"task_id": 4316254927,
"se_id": 22,
"loc_id": 1006886,
"key_id": 496329,
"post_id": "post ID 1",
"post_key": "rank checker",
"result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
"result_datetime": "2019-04-26 11:42:52 +00:00",
"result_spell": "",
"result_spell_type": "",
"result_extra": "people_also_ask,knowledge_graph,related_search",
"result_serp_count": 18400000,
"result": {
"left": [
{
"type": "organic",
"position": 1,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://smallseotools.com/keyword-position/",
"breadcrumb": "https://smallseotools.com/keyword-position/",
"title": "Keyword Rank Checker - A Free online Google keyword position ...",
"snippet": "To check the keyword rank in Google ranking, use our free Keyword Position Checker. Just enter the domain name, keywords and search engine and click the ...",
"snippet_extra": "",
"links": [],
"stat": []
},
{
"type": "organic",
"position": 2,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://www.serprobot.com/",
"breadcrumb": "https://www.serprobot.com/",
"title": "Free SERP checker - google ranking check | serprobot.com",
"snippet": "Free SERP check, track and monitor your search engine keyword ranking quickly and accurately.",
"snippet_extra": "",
"links": [
{
"title": "Free SERP check",
"url": "https://www.serprobot.com/serp-check.php",
"snippet": ""
},
{
"title": "Pricing",
"url": "https://www.serprobot.com/pricing.php",
"snippet": ""
},
{
"title": "SERPROBOT Info",
"url": "https://www.serprobot.com/info.php",
"snippet": ""
}
],
"stat": []
},
{
"type": "organic",
"position": 3,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://serps.com/tools/rank-checker/",
"breadcrumb": "https://serps.com/tools/rank-checker/",
"title": "Free Keyword Rank Checker - Google & Yahoo | SERPs.com",
"snippet": "International and local keyword rankings. Check keyword rankings positions in Google or Yahoo from over 100 country and language combinations.",
"snippet_extra": "",
"links": [],
"stat": []
},
{
"type": "organic",
"position": 4,
"featured_snippet": false,
"image": false,
"video": false,
"url": "http://rankchecker.net/",
"breadcrumb": "rankchecker.net/",
"title": "Rankchecker.net SEO Tool",
"snippet": "Search engine optimization tool helps you analize your website ranking on google, msn, and yahoo.",
"snippet_extra": "",
"links": [],
"stat": []
},
{
"type": "organic",
"position": 5,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://www.seoreviewtools.com/rank-checker/",
"breadcrumb": "https://www.seoreviewtools.com/rank-checker/",
"title": "(TIP!) Free Google Rank Checker - SEO Review Tools",
"snippet": "Use the Google Rank Checker to see how well your web site is performing in search. Submit up to 10 keywords, add your domain and select your version of ...",
"snippet_extra": "Rating: 8.7/10 - \u200e417 votes",
"links": [],
"stat": {
"rating": 8.7,
"rating_max": 10
}
},
{
"type": "organic",
"position": 6,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://www.alexa.com/siteinfo",
"breadcrumb": "https://www.alexa.com/siteinfo",
"title": "Website Traffic, Statistics and Analytics - Alexa",
"snippet": "Find traffic statistics for any site using Alexa's advanced analysis tools. Understand rank, sources of traffic, competitors, top keywords and more.",
"snippet_extra": "",
"links": [],
"stat": []
},
{
"type": "organic",
"position": 7,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://www.thehoth.com/search-engine-rankings/",
"breadcrumb": "https://www.thehoth.com/search-engine-rankings/",
"title": "Free Google Search Engine Rankings Checker Tool - The Hoth",
"snippet": "The HOTH Search Engine Ranking Tool helps you identify high volume keywords for your domain.",
"snippet_extra": "Rating: 4.8 - \u200e2,063 reviews",
"links": [],
"stat": {
"rating": 4.8,
"rating_max": 5
}
},
{
"type": "organic",
"position": 8,
"featured_snippet": false,
"image": false,
"video": false,
"url": "http://tools.seobook.com/firefox/rank-checker/",
"breadcrumb": "tools.seobook.com/firefox/rank-checker/",
"title": "Free Rank Checker: Google + Microsoft Bing Online Rank Tracker",
"snippet": "Track where your site ranks in Google, Yahoo, and Microsoft Bing Search using the free Firefox rank checker.",
"snippet_extra": "",
"links": [],
"stat": []
},
{
"type": "organic",
"position": 9,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://www.ranktank.org/keyword-position-checker-tool/",
"breadcrumb": "https://www.ranktank.org/keyword-position-checker-tool/",
"title": "Free Keyword Rank Checker Tool - RankTank",
"snippet": "Use this free keyword rank checker tool to check your site's keyword positions. It's built out of a Google Sheet, so you can use it in your web browser!",
"snippet_extra": "",
"links": [],
"stat": []
},
{
"type": "organic",
"position": 10,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://www.shoutmeloud.com/5-excellent-websites-to-check-keyword-ranking-in-google.html",
"breadcrumb": "https://www.shoutmeloud.com/5-excellent-websites-to-check-keyword-ranking-in-go...",
"title": "5 Excellent Websites for Checking Google Keyword Rankings",
"snippet": "Jump to Check Your Keyword Rank - Of all the keyword rank checker tools on this list, SEMrush is my top choice for checking keyword positions in ...",
"snippet_extra": "",
"links": [],
"stat": []
},
{
"type": "organic",
"position": 11,
"featured_snippet": false,
"image": false,
"video": false,
"url": "https://ahrefs.com/keyword-rank-checker",
"breadcrumb": "https://ahrefs.com/keyword-rank-checker",
"title": "Keyword Rank Checker By Ahrefs: Track Your Keyword Rankings",
"snippet": "The Keyword Rank Checker tool by Ahrefs lets you see keyword rankings for any website and how well your target keywords rank for on desktop and mobile.",
"snippet_extra": "",
"links": [],
"stat": []
},
…
The price of Live SERP Extra API is 5 credits for SERP (TOP100 results for a keyword) as opposed to 1 credit for SERP in the standard SERP Extra API.
Breadcrumbs in SERP API
Breadcrumbs indicate a user’s current position when visiting a page of your website. They provide a path from your homepage to the page that the user is viewing. In other words, breadcrumbs translate the structure of your website, bring context to your page’s frame and lower your bounce rate since they help guide visitors through your website.
Here’s an example of an ordinary organic SERP containing breadcrumbs.
Now, let’s use Live SERP API to get SERP results for this query:
Request Sample
https://api.dataforseo.com/v2/live/srp_tasks_post
{
"data":
{
"here is supposed to be your post ID 1":
{
"se_name":"google.co.uk",
"se_language":"English",
"loc_name_canonical":"London,England,United Kingdom",
"key":"rent a car london heathrow"
}
}
}
Response Sample
{
"status": "ok",
"results_time": "0.1474 sec.",
"results_count": 106,
"results": {
"organic": [
{
"post_id": "here is supposed to be your post ID 1",
"task_id": 4316319873,
"se_id": 22,
"loc_id": 1006886,
"key_id": 530036832,
"post_key": "rent a car london heathrow",
"result_datetime": "2019-04-26 12:18:50 +00:00",
"result_position": 1,
"result_url": "https://www.heathrow.com/transport-and-directions/car-rental/mobile",
"result_breadcrumb": "https://www.heathrow.com/transport-and-directions/car-rental/mobile",
"result_title": "Car hire | Mobile-friendly page | Heathrow",
"result_snippet_extra": "",
"result_snippet": "LHR Airports Limited accepts no liability for the correctness, completeness and legitimacy of any content on external websites. Car rental bookings are in ...",
"results_count": 4040000,
"result_extra": "people_also_ask,images,local_pack",
"result_stat": [],
"result_spell": "",
"result_spell_type": "",
"result_se_check_url": "https://www.google.co.uk/search?q=rent%20a%20car%20london%20heathrow&num=100&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
},
{
"post_id": "here is supposed to be your post ID 1",
"task_id": 4316319873,
"se_id": 22,
"loc_id": 1006886,
"key_id": 530036832,
"post_key": "rent a car london heathrow",
"result_datetime": "2019-04-26 12:18:50 +00:00",
"result_position": 2,
"result_url": "https://www.enterprise.co.uk/en/car-hire/locations/uk/heathrow-airport.html",
"result_breadcrumb": "https://www.enterprise.co.uk › ... › Car Hire › Worldwide Locations › United Kingdom",
"result_title": "Heathrow | Enterprise Rent-A-Car",
"result_snippet_extra": "",
"result_snippet": "Car Hire at Heathrow Airport (LHR). Welcome to the Enterprise Heathrow car rental page. Choose from a wide selection of cars ranging from smaller economy ...",
"results_count": 4040000,
"result_extra": "people_also_ask,images,local_pack",
"result_stat": [],
"result_spell": "",
"result_spell_type": "",
"result_se_check_url": "https://www.google.co.uk/search?q=rent%20a%20car%20london%20heathrow&num=100&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
},
...
As you might have noticed, the response array has a “results_breadcrumb” field.
Getting breadcrumbs from SERP results is particularly valuable if you want to get certain parts of the URL, such ISBN codes in Google Books. By applying the &tbm=bks search parameter, you can get results from Google books and actually identify books by using their ISBNs.
Click here to learn more about Google Search Parameters
Here’s an example of how you can do this with Live SERP API:
Request Sample
https://api.dataforseo.com/v2/live/srp_tasks_post
{
"data":
{
"here is supposed to be your post ID 1":
{
"se_name":"google.co.uk",
"se_language":"English",
"loc_name_canonical":"London,England,United Kingdom",
"key":"jazz musicians",
"se_param_add":"&tbm=bks"
}
}
}
Response Sample
{
"status": "ok",
"results_time": "0.1431 sec.",
"results_count": 100,
"results": {
"organic": [
{
"post_id": "here is supposed to be your post ID 1",
"task_id": 4316363971,
"se_id": 22,
"loc_id": 1006886,
"key_id": 2901576,
"post_key": "jazz musicians",
"result_datetime": "2019-04-26 12:55:55 +00:00",
"result_position": 1,
"result_url": "https://books.google.co.uk/books?id=ug9FPHAvcbcC&printsec=frontcover&dq=jazz+musicians&hl=en&sa=X&ved=0ahUKEwjKxvic5-3hAhWGfd4KHVW9Cn4Q6AEIKDAA",
"result_breadcrumb": "https://books.google.co.uk/books?isbn=0786485566",
"result_title": "Jazz Musicians of the Early Years, to 1945",
"result_snippet_extra": "David Dicaire - 2010 - \u200ePreview - \u200eMore editions",
"result_snippet": "This work provides biographical sketches of the aforementioned artists and many others who made jazz so popular in the first half of the twentieth century.",
"results_count": 1090000,
"result_extra": "",
"result_stat": [],
"result_spell": "",
"result_spell_type": "",
"result_se_check_url": "https://www.google.co.uk/search?q=jazz%20musicians&num=100&tbm=bks&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
},
{
"post_id": "here is supposed to be your post ID 1",
"task_id": 4316363971,
"se_id": 22,
"loc_id": 1006886,
"key_id": 2901576,
"post_key": "jazz musicians",
"result_datetime": "2019-04-26 12:55:55 +00:00",
"result_position": 2,
"result_url": "https://books.google.co.uk/books?id=fSE00mknh0UC&printsec=frontcover&dq=jazz+musicians&hl=en&sa=X&ved=0ahUKEwjKxvic5-3hAhWGfd4KHVW9Cn4Q6AEILjAB",
"result_breadcrumb": "https://books.google.co.uk/books?isbn=0786485574",
"result_title": "Jazz Musicians, 1945 to the Present",
"result_snippet_extra": "David Dicaire - 2015 - \u200ePreview - \u200eMore editions",
"result_snippet": "The five major periods of jazz—the bop revolution, hard bop and cool jazz, the avant-garde, fusion, and contemporary—form the basis for the sections in this reference work, with a brief history of each period provided.",
"results_count": 1090000,
"result_extra": "",
"result_stat": [],
"result_spell": "",
"result_spell_type": "",
"result_se_check_url": "https://www.google.co.uk/search?q=jazz%20musicians&num=100&tbm=bks&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
},
...
As you could’ve noticed, unlike a typical URL, breadcrumbs contain structured information that includes a decoded ISBN of a book.
There are certainly more use cases for breadcrumbs in SERPs. Tell us how you use it in the comments below this article.
Keywords for Terms
Unlike keywords_for_keywords, a new keywords_for_terms endpoint of the Keyword Finder API makes it possible to actually set a limit for keywords you want to retrieve, what has given our users more flexibility in terms of required data volumes (even if you need data for just 10-20 keywords).
By using this method, you pay 50 credits for request and then 0.1 credit per every keyword in the results array.
What’s more, keywords_for_terms is using DataForSEO’s own keyword database and relies on keyword categories for finding the most relevant terms. According to our observations, keywords found by using this algorithm are just as relevant as those from Google Keyword Planner.
Request Sample
https://api.dataforseo.com/v2/kwrd_finder_kwrd_for_terms
{
"data":
{
"your post_id parameter here":
{
"language":"en",
"loc_name_canonical":"United States",
"keys":
[
"best seo",
"serp"
],
"pingback_url":"https://your-server.com/your_pingback_url.php?task_id=$task_id&post_id=$post_id"
}
}
}
Response Sample
{
"status": "ok",
"results_time": "0.7163 sec.",
"results_count": 1,
"results": {
"11913041": {
"post_id": "11913041",
"task_id": 987339,
"meta": {
"keywords": [
"seo"
],
"limit": 10,
"sort_by": "relevance",
"result_count": 10
},
"result": [
{
"key": "seo",
"country_code": "US",
"language": "en",
"search_volume": 135000,
"competition": 0.3911934555552456,
"cpc": 16.482774,
"history": [
{
"month": 3,
"year": 2019,
"search_volume": 135000
},
{
"month": 2,
"year": 2019,
"search_volume": 135000
},
{
"month": 1,
"year": 2019,
"search_volume": 135000
},
{
"month": 12,
"year": 2018,
"search_volume": 110000
},
{
"month": 11,
"year": 2018,
"search_volume": 110000
},
{
"month": 10,
"year": 2018,
"search_volume": 135000
},
{
"month": 9,
"year": 2018,
"search_volume": 110000
},
{
"month": 8,
"year": 2018,
"search_volume": 110000
},
{
"month": 7,
"year": 2018,
"search_volume": 110000
},
{
"month": 6,
"year": 2018,
"search_volume": 110000
},
{
"month": 5,
"year": 2018,
"search_volume": 135000
},
{
"month": 4,
"year": 2018,
"search_volume": 135000
}
],
"categories": [
10004,
10007,
10276,
11088,
12376,
13152,
13316,
13418
]
},
…
Check our article about Keywords for Terms to learn more
As our team prepares more updates to empower your SEO software, why don’t you try out those we discussed above with free DataForSEO credits?