Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
<?php // You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip require('RestClient.php'); $api_url = 'https://api.dataforseo.com/'; try { // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access $client = new RestClient($api_url, null, 'login', 'password'); } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; exit(); } try { $result = array(); // #1 - using this method you can get a list of completed tasks // GET /v3/serp/{{low_se_name}}/{{low_se_type}}/tasks_ready // in addition to '{{low_se_name}}' and '{{low_se_type}}' you can also set other search engine and type parameters // the full list of possible parameters is available in documentation $tasks_ready = $client->get('/v3/serp/{{low_se_name}}/{{low_se_type}}/tasks_ready'); // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) { foreach ($tasks_ready['tasks'] as $task) { if (isset($task['result'])) { foreach ($task['result'] as $task_ready) { // #2 - using this method you can get results of each completed task // GET /v3/serp/{{low_se_name}}/{{low_se_type}}/task_get/advanced/$id if (isset($task_ready['endpoint_advanced'])) { $result[] = $client->get($task_ready['endpoint_advanced']); } // #3 - another way to get the task results by id // GET /v3/serp/{{low_se_name}}/{{low_se_type}}/task_get/advanced/$id /* if (isset($task_ready['id'])) { $result[] = $client->get('/v3/serp/{{low_se_name}}/{{low_se_type}}/task_get/advanced/' . $task_ready['id']); } */ } } } } print_r($result); // do something with result } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; } $client = null; ?>
The above command returns JSON structured like this:
{ "version": "0.1.20200129", "status_code": 20000, "status_message": "Ok.", "time": "0.2347 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "01291734-1535-0066-0000-6988734166f9", "status_code": 20000, "status_message": "Ok.", "time": "0.0934 sec.", "cost": 0, "result_count": 1, "path": [ "v3", "serp", "{{low_se_name}}", "{{low_se_type}}", "task_get", "advanced", "01291734-1535-0066-0000-6988734166f9" ], "data": { "api": "serp", "function": "task_get", "se": "{{low_se_name}}", "se_type": "{{low_se_type}}", "language_name": "English", "location_name": "United States", "keyword": "flight ticket new york san francisco", "priority": 2, "tag": "tag2", "device": "desktop", "os": "windows" }, "result": [ { "keyword": "star wars cast", "type": "organic", "se_domain": "bing.com", "location_code": 2840, "language_code": "en", "check_url": "https://www.bing.com/search?q=star%20wars%20cast&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&form=QBLH", "datetime": "2022-01-28 13:46:40 +00:00", "spell": null, "refinement_chips": null, "item_types": [ "organic", "images", "top_stories", "video", "related_searches", "carousel", "paid" ], "se_results_count": 99148, "items_count": 110, "items": [ { "type": "carousel", "rank_group": 1, "rank_absolute": 1, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/div[1]/div[1]/div[2]", "title": "Star Wars - Cast", "items": [ { "type": "carousel_element", "title": "George Lucas", "subtitle": "Born 1944" }, { "type": "carousel_element", "title": "Mark Hamill", "subtitle": "Born 1951" }, { "type": "carousel_element", "title": "Carrie Fisher", "subtitle": "1956 - 2016" }, { "type": "carousel_element", "title": "Hayden Christensen", "subtitle": "Born 1981" }, { "type": "carousel_element", "title": "Daisy Ridley", "subtitle": "Born 1992" } ], "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } }, { "type": "organic", "rank_group": 1, "rank_absolute": 2, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[1]", "domain": "www.imdb.com", "title": "Star Wars Cast(1977-Present) - IMDb", "url": "https://www.imdb.com/list/ls070679507/", "cache_url": null, "related_search_url": null, "breadcrumb": "https://www.imdb.com/list/ls070679507", "website_name": "IMDb", "is_image": false, "is_video": false, "is_featured_snippet": false, "is_malicious": false, "is_web_story": false, "description": "Star Wars Cast (1977-Present) 1. Mark Hamill. Actor | Star Wars. Mark Hamill is best known for his portrayal of Luke Skywalker in the original Star Wars trilogy - Star Wars: ... 2. Harrison Ford. 3. Carrie Fisher. 4. Billy Dee Williams. 5. Alec Guinness.", "pre_snippet": null, "extended_snippet": null, "images": null, "amp_version": false, "rating": null, "price": null, "highlighted": [ "Mark Hamill.", "Mark Hamill", "Luke Skywalker" ], "links": null, "faq": null, "extended_people_also_search": null, "about_this_result": null, "related_result": null, "timestamp": null, "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } }, { "type": "images", "rank_group": 1, "rank_absolute": 4, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[3]", "title": "Images of Star Wars Cast", "url": "https://www.bing.com/images/search?q=star+wars+cast&qpvt=star+wars+cast&tsc=ImageHoverTitle&FORM=IGRE", "items": [ { "type": "images_element", "alt": "Image result for Star Wars Cast. Size: 176 x 170. Source: www.blackfilm.com", "url": "https://www.blackfilm.com/read/2017/12/recapping-star-wars-last-jedi-press-conference/", "image_url": "https://api.dataforseo.com/cdn/i/01281546-1535-0139-0000-57efd54f6fd8:0" }, { "type": "images_element", "alt": "Image result for Star Wars Cast. Size: 176 x 170. Source: www.therichest.com", "url": "https://www.therichest.com/pop-culture/cast-member-star-wars-net-worth/", "image_url": "https://api.dataforseo.com/cdn/i/01281546-1535-0139-0000-57efd54f6fd8:1" }, { "type": "images_element", "alt": "Image result for Star Wars Cast. Size: 176 x 170. Source: www.cheatsheet.com", "url": "https://www.cheatsheet.com/entertainment/star-wars-the-rise-of-skywalker-final-trailer-all-the-easter-eggs-you-may-have-missed.html/", "image_url": "https://api.dataforseo.com/cdn/i/01281546-1535-0139-0000-57efd54f6fd8:2" }, { "type": "images_element", "alt": "Image result for Star Wars Cast. Size: 176 x 170. Source: www.blackfilm.com", "url": "https://www.blackfilm.com/read/2019/12/j-j-abrams-the-cast-of-star-wars-the-rise-of-skywalker-talk-landing-the-final-skywalker-saga-vehicle/", "image_url": "https://api.dataforseo.com/cdn/i/01281546-1535-0139-0000-57efd54f6fd8:3" }, { "type": "images_element", "alt": "Image result for Star Wars Cast. Size: 176 x 170. Source: io9.gizmodo.com", "url": "http://io9.gizmodo.com/cast-of-star-wars-the-last-jedi-takes-over-vanity-fair-1795461250", "image_url": "https://www.bing.com/th?id=OIP.kdF2M7uR8MfXQ33UycMOgQHaEK&w=176&h=170&c=8&rs=1&qlt=90&o=6&pid=3.1&rm=2" } ], "related_image_searches": [ { "type": "related_image_searches_element", "title": "Star Wars Actors", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Actors&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars 9 Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+9+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Episode 9 Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Episode+9+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars 8 Characters", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+8+Characters&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars 7 Characters", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+7+Characters&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars 4 Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+4+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Full Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Full+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Female Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Female+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars 1 Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+1+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Episode 2 Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Episode+2+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Movie Characters", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Movie+Characters&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Original Star Wars Actors", "alt": null, "url": null, "image_url": "/th?q=Original+Star+Wars+Actors&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Cast Anakin", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Cast+Anakin&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Clone Wars Cast", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Clone+Wars+Cast&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" }, { "type": "related_image_searches_element", "title": "Star Wars Actors List", "alt": null, "url": null, "image_url": "/th?q=Star+Wars+Actors+List&w=100&h=100&c=7&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate" } ], "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } }, { "type": "top_stories", "rank_group": 1, "rank_absolute": 7, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[6]", "title": "News about Star Wars Cast", "items": [ { "type": "top_stories_element", "source": "Cinema Blend", "domain": "www.cinemablend.com", "title": "Star Wars Galactic Starcruiser Is Prepping For Launch, Here’s Our First Look At The Crew", "date": "· 9h", "amp_version": false, "timestamp": null, "url": "https://www.cinemablend.com/movies/star-wars-galactic-starcruiser-is-prepping-for-launch-heres-our-first-look-at-the-crew", "image_url": null, "badges": null }, { "type": "top_stories_element", "source": "GameSpot", "domain": "www.gamespot.com", "title": "New Footage Of Canceled Star Wars 1313 Game Shows Boba Fett On The Hunt", "date": "· 22h", "amp_version": false, "timestamp": null, "url": "https://www.gamespot.com/articles/new-footage-of-canceled-star-wars-1313-game-shows-boba-fett-on-the-hunt/1100-6500019/", "image_url": null, "badges": null }, { "type": "top_stories_element", "source": "theblast", "domain": "theblast.com", "title": "Mary Elizabeth Winstead Cast In ‘Star Wars’ Ahsoka Series", "date": "· 6d", "amp_version": false, "timestamp": null, "url": "https://theblast.com/164070/mary-elizabeth-winstead-casting/", "image_url": null, "badges": null } ], "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } }, { "type": "video", "rank_group": 1, "rank_absolute": 10, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[9]", "items": [ { "type": "video_element", "source": "Microsoft NewsABC", "title": "Star Wars Cast Plays Family Feud", "timestamp": "2019-12-16 00:00:00 +00:00", "url": null }, { "type": "video_element", "source": "Microsoft NewsABC", "title": "Star Wars Cast Answers Questions From Kids", "timestamp": "2019-12-16 00:00:00 +00:00", "url": null }, { "type": "video_element", "source": "YouTubeStar Wars", "title": "Star Wars: The Force Awakens Trailer (Official)", "timestamp": "2015-10-20 00:00:00 +00:00", "url": null }, { "type": "video_element", "source": "YouTubeBuzzFeed Celeb", "title": "Star Wars Cast Takes \"Which Star Wars Character Are You?\" Quiz", "timestamp": "2017-12-12 00:00:00 +00:00", "url": null }, { "type": "video_element", "source": "YouTubeONE Media", "title": "STAR WARS: THE BAD BATCH Trailer 2 (NEW, 2021) Disney", "timestamp": "2021-04-28 13:46:33 +00:00", "url": null } ], "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } }, { "type": "people_also_ask", "rank_group": 1, "rank_absolute": 8, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[9]", "items": [ { "type": "people_also_ask_element", "title": "How popular is Star Wars?", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[9]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]/div[1]", "expanded_element": [ { "type": "people_also_ask_expanded_element", "featured_title": null, "url": "https://www.msn.com/en-us/movies/news/these-are-the-most-popular-star-wars-characters/ss-BB1glLna#:~:text=Star%20Wars%20is%20one%20of%20the%20most%20popular,Star%20Wars%20has%20always%20been%20its%20unforgettable%20characters.", "domain": "www.msn.com", "title": "These Are the Most Popular Star Wars Characters", "description": "Star Wars is one of the most popular and long-running franchises in American media history, spawning three trilogies, spin-off films, comics, TV shows, video games, and more. Though many fans have been drawn in by the intense battle sequences and eye-popping visual effects, the heart of Star Wars has always been its unforgettable characters.", "timestamp": null, "table": null } ] }, { "type": "people_also_ask_element", "title": "Who are the most popular characters in Star Wars?", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[9]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]/div[3]", "expanded_element": [ { "type": "people_also_ask_expanded_element", "featured_title": null, "url": "https://finance.yahoo.com/news/50-most-least-popular-star-211953052.html", "domain": "finance.yahoo.com", "title": "50 Most (and Least) Popular Star Wars Characters", "description": "The most popular Wookie in the Star Wars films, Chewbacca is Han Solo’s lifelong friend and co-pilot of the Millenium Falcon. Based on Google search frequency, Chewbacca was the 201st most popular Halloween costume in 2017 and the sixth most popular costume of any Star Wars character.", "timestamp": null, "table": null } ] } ], "rectangle": { "x": 160, "y": 2964.3, "width": 648, "height": 260 } }, { "type": "local_pack", "rank_group": 1, "rank_absolute": 1, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[1]/div[1]/div[1]/div[3]/div[2]", "title": "Angelo's Barber Shop", "description": "DIRECTIONS WEBSITE \n\n", "domain": "www.angelosbarbershop.com", "phone": null, "url": "https://www.angelosbarbershop.com/dtla--biltmore-hotel-", "is_paid": false, "rating": { "rating_type": "Max5", "value": 4.5, "votes_count": 11, "rating_max": 5 }, "cid": null, "rectangle": { "x": 180, "y": 446, "width": 608, "height": 109 } }, { "type": "local_pack", "rank_group": 2, "rank_absolute": 2, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[1]/div[1]/div[1]/div[3]/div[4]", "title": "Bolt Barbers", "description": "DIRECTIONS WEBSITE \n\n", "domain": "boltbarbers.com", "phone": null, "url": "http://boltbarbers.com/", "is_paid": false, "rating": { "rating_type": "Max5", "value": 5, "votes_count": 2, "rating_max": 5 }, "cid": null, "rectangle": { "x": 180, "y": 567, "width": 608, "height": 109 } }, { "type": "map", "rank_group": 1, "rank_absolute": 2, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[2]", "title": "Los Angeles, California", "url": "https://www.bing.com/maps?&ty=18&q=Los%20Angeles%2C%20California&satid=id.sid%3A9958ca5c-ea31-4e71-8a17-bd1e7839c723&vdpid=5059788015119892481&mb=34.401077~-118.917908~33.708313~-117.565002&ppois=34.05469512939453_-118.241455078125_Los%20Angeles%2C%20California_~&cp=34.054695~-118.241455&v=2&sV=1&FORM=MIRE&qpvt=la+city+map", "rectangle": { "x": 160, "y": 495, "width": 648, "height": 427 } }, { "type": "shopping", "rank_group": 1, "rank_absolute": 1, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/div[2]/div[1]/ul[1]/li[1]", "title": "See star wars merch", "items": [ { "type": "shopping_element", "title": "STAR WARS Jedi Master Yoda …Illuminated Desk Lamp By The Bradford Exchange", "price": { "current": 199.99, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$199.99" }, "source": "Bradford Exchange", "description": null, "marketplace": null, "marketplace_url": null, "url": "https://www.bing.com/aclk?ld=e8qFvV9VcUMhyLj3DuLsIrnTVUCUwTcqcHjoJv3P8PVcIS9F9w3gZGJBqAMAEG6pJkDHP2n6875j9_EyEP8Qg7UUu9zXQNXY_683sB4k2CruGusHc4SGyKxdNaZsayqS-pPkEnZzJM5pSMBYe3ESgHjPf6RriMnnDSMZq07NQZknsV4oLouIeglB3IK33r2TaNFkSVvg&u=aHR0cHMlM2ElMmYlMmZhZC5hdGRtdC5jb20lMmZzJTJmZ28lM2JhZHYlM2QxMTEyNzIwMDkwNjM2NCUzYmVjJTNkMTExMjcyMDEwNjIzNjglM2JjLmElM2Q2MTc1NjU4MyUzYnMuYSUzZGdvb2dsZSUzYnAuYSUzZDYxNzU2NTgzJTNiYXMuYSUzZDEyNzMyMzUwNTI4MTUzMjQlM2JxcGIlM2QxJTNiJTNmYmlka3clM2RkZWZhdWx0a2V5d29yZCUyNmR2YyUzZGMlMjZoJTNkaHR0cHMlMjUzQSUyNTJGJTI1MkZ3d3cuYnJhZGZvcmRleGNoYW5nZS5jb20lMjUyRnByb2R1Y3RzJTI1MkYxMjIzNDgwMDFfc3Rhci13YXJzLWplZGktbWFzdGVyLXlvZGEtaWxsdW1pbmF0ZWQtZGVzay1sYW1wLmh0bWwlMjUzRmNtX3ZlbiUyNTNER1BTJTI1MjZjbV9jYXQlMjUzREJpbmclMjU3Q1Byb2R1Y3RBZHMlMjUyNmNtX3BsYSUyNTNENjE3NTY1ODMlMjU3QzEyNzMyMzUwNTI4MTUzMjQlMjUyNmNtX2l0ZSUyNTNEMTIyMzQ4MDAxJTI2bXNjbGtpZCUzZDhlYTUwZmY0MDM3MTE3OGQwZDlhNmUwN2Y1MmRlODM4JTI2dXRtX3NvdXJjZSUzZGJpbmclMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX2NhbXBhaWduJTNkU2hvcHBpbmclMjUyMC0lMjUyMERDUiUyNnV0bV90ZXJtJTNkNDU4MzE3NjgwMTU2NDI2NyUyNnV0bV9jb250ZW50JTNkRENSJTI1MjAtJTI1MjBTb2xv&rlid=8ea50ff40371178d0d9a6e07f52de838" }, { "type": "shopping_element", "title": "Boys Long-Sleeve Star Wars Print …Logo Graphic Tee In Cream | Size 9/10 | Abercrombie Kids", "price": { "current": 29.95, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$29.95" }, "source": "Abercrombie & Fitch", "description": null, "marketplace": null, "marketplace_url": null, "url": "https://www.bing.com/aclk?ld=e8mm3Mz6x7XNuvNgXABZiyfTVUCUyxI359lpzDGJyQD0BkuOGu2ZEN3nZX1MInzo0FN30Jt_3g4ygPR7un0nTEhpGPvD43_XzhbXO-vZNI-Df0F79VEFJHkQlHrZsWqjs1xb34PyXPTc2kJ6hEZCOmpK8DuZ67E1EDcYiALDg2QjNbOEMaTA4Az1s9qDxoL8M-tlYCjg&u=aHR0cHMlM2ElMmYlMmZ3d3cuYWJlcmNyb21iaWUuY29tJTJmc2hvcCUyZnVzJTJma2lkcyUyZnAlMmZsb25nLXNsZWV2ZS14Ym94LWdyYXBoaWMtdGVlLTQ2MzM4ODM2JTNmc2VxJTNkMDclMjZzb3VyY2UlM2RiaW5nc2hvcHBpbmclMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX2NhbXBhaWduJTNkUExBJTI2c2NpZCUzZHNjYnBscDY0OTg5ODUyMSUyNnNjX2ludGlkJTNkNjQ5ODk4NTIxJTI2Y21wJTNkUExBJTNhRVZHJTNhMjAlM2FLJTNhSyUzYVVTJTNhWCUzYU1TTiUzYVglM2FTSE9QJTNhWCUzYVglM2FYJTNhWCUzYXglM2FTQyUyYlNob3BwaW5nJTJiLSUyYmFmayUyYi0lMmJHZW5lcmFsX0FsbCUyYlByb2R1Y3RzX1BST0RVQ1RfR1JPVVAlMjZnY2xpZCUzZDE5OGQzY2U0MjlmODExMzA4NjE5NWQxN2RmYTRkN2Y3JTI2Z2Nsc3JjJTNkM3AuZHMlMjZtc2Nsa2lkJTNkMTk4ZDNjZTQyOWY4MTEzMDg2MTk1ZDE3ZGZhNGQ3Zjc&rlid=198d3ce429f8113086195d17dfa4d7f7" } ], "rectangle": { "x": 0, "y": 159, "width": 1920, "height": 333 } }, { "type": "recipes", "rank_group": 1, "rank_absolute": 1, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/div[1]/div[1]/div[1]", "items": [ { "type": "recipes_element", "title": "Easy Homemade Vanilla Pudding", "url": null, "domain": null, "source": "Celebrating Sweets", "description": null, "time": null, "rating": { "rating_type": "Max5", "value": 5, "votes_count": 451, "rating_max": 5 } }, { "type": "recipes_element", "title": "Homemade Chocolate Pudding", "url": null, "domain": null, "source": "Spend With Pennies", "description": null, "time": null, "rating": { "rating_type": "Max5", "value": 5, "votes_count": 218, "rating_max": 5 } }, { "type": "recipes_element", "title": "BEST Bread Pudding Recipe 2022 ❤️", "url": null, "domain": null, "source": "Jojorecipes.com", "description": null, "time": null, "rating": { "rating_type": "Max5", "value": 5, "votes_count": 36300, "rating_max": 5 } } ], "rectangle": { "x": 180, "y": 128, "width": 1740, "height": 492 } }, { "type": "jobs", "rank_group": 1, "rank_absolute": 6, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[2]", "title": null, "url": null, "items": [ { "type": "jobs_element", "title": "Make Up To $23 Per Hour As A Mover-Driver With Bellhop! - Los Angeles", "description": "Los Angeles, CA · Full-time", "author": "via Snagajob", "job_posted_time": "Posted 2 days ago", "timestamp": null, "contract_type": null, "salary": null, "url": null }, { "type": "jobs_element", "title": "Registered Behavior Technician (RBT) - Los Angeles", "description": "Los Angeles, CA · Full-time", "author": "via Snagajob", "job_posted_time": "Posted 3 days ago", "timestamp": null, "contract_type": null, "salary": null, "url": null } ], "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } }, { "type": "hotels_pack", "rank_group": 1, "rank_absolute": 5, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[3]", "title": "Hotels | Los Angeles, CA", "date_from": "2022-03-13", "date_to": "2022-03-14", "items": [ { "type": "hotels_pack_element", "price": null, "title": "Freehand Los Angeles", "description": null, "hotel_identifier": null, "domain": null, "url": null, "is_paid": false, "rating": { "rating_type": "Max5", "value": 3.5, "votes_count": null, "rating_max": 5 } }, { "type": "hotels_pack_element", "price": null, "title": "JW Marriott Los Angeles L.A. LIVE", "description": "\"The JW Marriott at LA Live is a beautiful hotel in a great location.\"", "hotel_identifier": null, "domain": null, "url": null, "is_paid": false, "rating": { "rating_type": "Max5", "value": 4.5, "votes_count": null, "rating_max": 5 } } ], "rectangle": { "x": 160, "y": 1575, "width": 648, "height": 1331.8 } }, { "type": "featured_snippet", "rank_group": 1, "rank_absolute": 6, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[4]", "domain": "www.travelandleisure.com", "title": "Best Los Angeles Hotels: World's Best 2020 | Travel + Leisure", "featured_title": "The Top 15 City Hotels in Greater Los Angeles", "description": "Santa Monica Proper Hotel. Score: 96.00 More information: properhotel.com A “beautiful hotel with top-notch service and amenities,” as one reader put it, the second addition to the Proper portfolio ...\nKimpton La Peer Hotel, West Hollywood. Score: 95.62 More information: lapeerhotel.com\nViceroy L'Ermitage Beverly Hills. ...\nWaldorf Astoria Beverly Hills. ...", "timestamp": null, "url": "https://www.travelandleisure.com/worlds-best/hotels-in-los-angeles#:~:text=The%20Top%2015%20City%20Hotels%20in%20Greater%20Los,Waldorf%20Astoria%20Beverly%20Hills.%20...%20More%20items...%20", "images": [ { "type": "images_element", "alt": "Image result for hotels los angeles. Size: 252 x 160. Source: www.omnihotels.com", "url": "https://www.bing.com/th?id=OIP.U2IArS9OwTQee7AphkxE_wHaEL&w=252&h=160&c=8&rs=1&qlt=90&o=6&pid=3.1&rm=2", "image_url": "https://api.dataforseo.com/cdn/i/01281600-1535-0139-0000-4c76961a87c2:0" }, { "type": "images_element", "alt": "Image result for hotels los angeles. Size: 213 x 160. Source: www.expedia.com", "url": "https://www.bing.com/th?id=OIP.Z9SXEdpDvg31RQnoOP_OQwHaE8&w=213&h=160&c=8&rs=1&qlt=90&o=6&pid=3.1&rm=2", "image_url": "https://api.dataforseo.com/cdn/i/01281600-1535-0139-0000-4c76961a87c2:1" }, { "type": "images_element", "alt": "Image result for hotels los angeles. Size: 232 x 160. Source: www.wallpaper.com", "url": "https://www.bing.com/th?id=OIP.hc0LTR_Dg8QxtzpeRJr6RAHaEi&w=232&h=160&c=8&rs=1&qlt=90&o=6&pid=3.1&rm=2", "image_url": "https://api.dataforseo.com/cdn/i/01281600-1535-0139-0000-4c76961a87c2:2" } ], "table": null, "rectangle": { "x": 160, "y": 2930.8, "width": 648, "height": 546 } }, { "type": "paid", "rank_group": 3, "rank_absolute": 157, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[51]/ul[1]/li[1]", "title": "Star Wars Super Store | superherostuff.com", "domain": "www.superherostuff.com", "breadcrumb": "https://www.superherostuff.com/starwars", "website_name": "superherostuff.com/starwars", "url": "https://www.superherostuff.com/characters/star-wars-t-shirts/star-wars-merchandise.html?msclkid=27d694c1f70f1f1cbd4cf53204b0e3d5", "highlighted": [ "Star Wars" ], "extra": { "ad_aclk": null }, "description": "Ad Looking for Official Star Wars Merchandise? Look No Further, Shop Now.", "description_rows": null, "links": null, "price": null, "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } }, { "type": "related_searches", "rank_group": 3, "rank_absolute": 158, "position": "left", "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[52]/div[1]", "items": [ "star wars cast names", "cast of star wars 1977", "star wars actors names cast", "star wars cast members", "list of star wars actors", "original star wars character list", "star wars cast members names", "the original star wars cast" ], "rectangle": { "x": 160, "y": 571, "width": 648, "height": 986 } } ] } ] } ] }
Description of the fields for sending a request:
Field name | Type | Description |
---|---|---|
id |
string | task identifier unique task identifier in our system in the UUID format you will be able to use it within 30 days to request the results of the task at any time |
As a response of the API server, you will receive JSON-encoded data containing a tasks
array with the information specific to the set tasks.
You can also get all available SERP features and possible extra elements by making a request to the following Sandbox URL:
https://sandbox.dataforseo.com/v3/serp/bing/organic/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Bing Organic SERP Advanced endpoint with the fields containing dummy data.
You won’t be charged for using Sandbox endpoints.
Description of the fields in the results array:
Field name | Type | Description |
---|---|---|
version |
string | the current version of the API |
status_code |
integer | general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string | general informational message you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | total tasks cost, USD |
tasks_count |
integer | the number of tasks in the tasks array |
tasks_error |
integer | the number of tasks in the tasks array returned with an error |
tasks |
array | array of tasks |
id |
string | task identifier unique task identifier in our system in the UUID format |
status_code |
integer | status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes here |
status_message |
string | informational message of the task you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | cost of the task, USD |
result_count |
integer | number of elements in the result array |
path |
array | URL path |
data |
object | contains the same parameters that you specified in the POST request |
result |
array | array of results |
keyword |
string | keyword received in a POST array the keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character) |
type |
string | search engine type in a POST array |
se_domain |
string | search engine domain in a POST array |
location_code |
integer | location code in a POST array |
language_code |
string | language code in a POST array |
check_url |
string | direct URL to search engine results you can use it to make sure that we provided accurate results |
datetime |
string | date and time when the result was received in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
spell |
object | autocorrection of the search engine if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection |
refinement_chips |
object | search refinement chips equals null |
keyword |
string | keyword obtained as a result of search engine autocorrection the results will be provided for the corrected keyword |
type |
string | type of autocorrection possible values: did_you_mean , showing_results_for , no_results_found_for , including_results_for |
item_types |
array | types of search results in SERP contains types of search results ( items ) found in SERP.possible item types: answer_box , carousel , events , featured_snippet , hotels_pack , images , jobs , local_pack , map , organic , paid , people_also_ask , people_also_search , questions_and_answers ,recipes , related_searches , shopping , top_stories , video |
se_results_count |
integer | total number of results in SERP |
items_count |
integer | the number of results returned in the items array |
items |
array | elements of search results found in SERP |
‘organic’ element in SERP | ||
type |
string | type of element = ‘organic’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
domain |
string | domain in SERP |
title |
string | title of the result in SERP |
url |
string | relevant URL in SERP |
cache_url |
string | cached version of the page |
related_search_url |
string | URL to a similar search URL to a new search for the same keyword(s) on related sites |
breadcrumb |
string | breadcrumb in SERP |
website_name |
string | website name in SERP |
is_image |
boolean | indicates whether the element contains an image |
is_video |
boolean | indicates whether the element contains a video |
is_featured_snippet |
boolean | indicates whether the element is a featured_snippet |
is_malicious |
boolean | indicates whether the element is marked as malicious |
is_web_story |
boolean | indicates whether the element is marked as a web story |
description |
string | description of the results element in SERP |
pre_snippet |
string | includes additional information appended before the result description in SERP |
extended_snippet |
string | includes additional information appended after the result description in SERP |
images |
array | images of the element |
type |
string | type of element = ‘images_element‘ |
alt |
string | alt tag of the image |
url |
string | relevant URL |
image_url |
string | URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) |
amp_version |
boolean | Accelerated Mobile Pages indicates whether an item has the Accelerated Mobile Page (AMP) version |
rating |
object | the item’s rating the popularity rate based on reviews and displayed in SERP |
rating_type |
string | the type of rating here you can find the following elements: Max5 , Percents , CustomMax |
value |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
price |
object | pricing details contains the pricing details of the product or service featured in the result |
current |
float | current price indicates the current price of the product or service featured in the result |
regular |
float | regular price indicates the regular price of the product or service with no discounts applied |
max_value |
float | the maximum price the maximum price of the product or service as indicated in the result |
currency |
string | currency of the listed price ISO code of the currency applied to the price |
is_price_range |
boolean | price is provided as a range indicates whether a price is provided in a range |
displayed_price |
string | price string in the result raw price string as provided in the result |
highlighted |
array | words highlighted in bold within the results description |
links |
array | sitelinks the links shown below some search results if there are none, equals null |
type |
string | type of element = ‘link_element‘ |
title |
string | title of the result in SERP |
description |
string | description of the results element in SERP |
url |
string | sitelink URL |
faq |
object | frequently asked questions questions and answers extension shown below some search results if there are none, equals null |
type |
string | type of element = ‘faq_box‘ |
items |
array | items featured in the faq_box |
type |
string | type of element = ‘faq_box_element‘ |
title |
string | question related to the result |
description |
string | answer provided in the drop-down block |
links |
array | links featured in the faq_box_element |
type |
string | type of element = ‘link_element‘ |
title |
string | link anchor text |
url |
string | link URL |
extended_people_also_search |
array | extension of the organic element extension of the organic result containing related search queries Note: extension appears in SERP upon clicking on the result and then bouncing back to search results |
about_this_result |
object | contains information from the ‘About this result’ panel note: about_this_result feature is not available in Bing search engine, that’s why it always equals null |
related_result |
array | related result from the same domain related result from the same domain appears as a part of the main result snippet; note: related_result feature is not available in Bing search engine, that’s why it always equals null |
timestamp |
string | date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘paid’ element in SERP | ||
type |
string | type of element = ‘paid’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
domain |
string | domain in SERP of the Ad element |
description |
string | description of the results element in SERP |
title |
string | title of the result in SERP |
url |
string | relevant URL of the Ad element in SERP |
breadcrumb |
string | breadcrumb of the Ad element in SERP |
highlighted |
array | words highlighted in bold within the results description |
extra |
object | additional information about the result |
ad_aclk |
string | the identifier of the ad |
description |
string | description of the results element in SERP |
description_rows |
array | extended description if there is none, equals null |
links |
array | sitelinks the links shown below some search results if there are none, equals null |
type |
string | type of element = ‘link_element‘ |
title |
string | title of the link element |
description |
string | description of the results element in SERP |
url |
string | URL link |
ad_aclk |
string | the identifier of the ad |
price |
object | pricing details contains the pricing details of the product or service featured in the result |
current |
float | current price indicates the current price of the product or service featured in the result |
regular |
float | regular price indicates the regular price of the product or service with no discounts applied |
max_value |
float | the maximum price the maximum price of the product or service as indicated in the result |
currency |
string | currency of the listed price ISO code of the currency applied to the price |
is_price_range |
boolean | price is provided as a range indicates whether a price is provided in a range |
displayed_price |
string | price string in the result raw price string as provided in the result |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘answer_box’ element in SERP | ||
type |
string | type of element = ‘answer_box’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
text |
array | text if there is none, equals null |
links |
array | sitelinks the links shown below some search results if there are none, equals null |
type |
string | type of element = ‘link_element‘ |
title |
string | title of the link |
description |
string | description of the results element in SERP |
url |
string | URL link |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘related_searches’ element in SERP | ||
type |
string | type of element = ‘related_searches’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘people_also_search’ element in SERP | ||
type |
string | type of element = ‘people_also_search’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
items |
array | additional items present in the element if there are none, equals null |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘local_pack’ element in SERP | ||
type |
string | type of element = ‘local_pack’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
description |
string | description of the results element in SERP |
domain |
string | domain in SERP |
phone |
string | phone number |
url |
string | relevant URL |
is_paid |
boolean | indicates whether the element is an ad |
rating |
object | the item’s rating the popularity rate based on reviews and displayed in SERP |
rating_type |
string | the type of rating here you can find the following elements: Max5 , Percents , CustomMax |
value |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
cid |
string | bing-defined client id unique id of a local establishment |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘hotels_pack’ element in SERP | ||
type |
string | type of element = ‘hotels_pack’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
date_from |
string | starting date of stay in the format “year-month-date” example: 2019-11-15 |
date_to |
string | ending date of stay in the format “year-month-date” example: 2019-11-17 |
items |
array | contains results featured in the ‘hotels_pack’ element of SERP |
type |
string | type of element = ‘hotels_pack_element’ |
price |
object | price of booking a place for the specified dates of stay |
current |
float | current price indicates the current price of booking a place for the specified dates of stay |
regular |
float | regular price indicates the regular price of booking a place for the specified dates of stay |
max_value |
float | the maximum price the maximum price of booking a place for the specified dates of stay |
currency |
string | currency of the listed price ISO code of the currency applied to the price |
is_price_range |
boolean | price is provided as a range indicates whether a price is provided in a range |
displayed_price |
string | price string in the result raw price string as provided in the result |
title |
string | title of the place |
desription |
string | description of the place in SERP |
hotel_identifier |
string | unique hotel identifier unique hotel identifier assigned by Bing; example: "CgoIjaeSlI6CnNpVEAE" |
domain |
string | domain in SERP |
url |
string | relevant URL |
is_paid |
boolean | indicates whether the element is an ad |
rating |
object | the item’s rating the popularity rate based on reviews and displayed in SERP |
rating_type |
string | the type of rating here you can find the following elements: Max5 , Percents , CustomMax |
value |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘carousel’ element in SERP | ||
type |
string | type of element = ‘carousel’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘carousel_element‘ |
title |
string | title of the item |
subtitle |
string | subtitle of the item |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘events’ element in SERP | ||
type |
string | type of element = ‘events’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
url |
string | URL |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘events_element‘ |
title |
string | title of the item |
description |
string | snippet of the element |
url |
string | events_element URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘featured_snippet’ element in SERP | ||
type |
string | type of element = ‘featured_snippet’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
domain |
string | domain in SERP |
title |
string | title of the result in SERP |
featured_title |
string | the title of the featured snippets source page |
description |
string | description of the results element in SERP |
timestamp |
string | date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
url |
string | relevant URL |
images |
array | images of the element |
type |
string | type of element = ‘images_element‘ |
alt |
string | alt tag of the image |
url |
string | relevant URL |
image_url |
string | URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) |
table |
object | results table if there are none, equals null |
table_header |
array | column names |
table_content |
array | the content of the table one line of the table in this element of the array |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘images’ element in SERP | ||
type |
string | type of element = ‘images’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
url |
string | relevant URL |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘images_element‘ |
alt |
string | alt tag of the image |
url |
string | original URL of the image the URL leading to the image on the original resource |
image_url |
string | URL to the compressed image the URL leading to the image on DataForSEO storage |
related_image_searches |
array | contains keywords and images related to the specified search term if there are none, equals null |
type |
string | type of element = ‘related_image_searches_element‘ |
title |
string | title of the element indicates keyword that may be used with the specified term to refine image search |
alt |
string | alt tag of the featured image |
url |
string | original URL of the featured image the URL leading to the image on the original resource |
image_url |
string | URL to the compressed featured image the URL leading to the image on DataForSEO storage |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘shopping’ element in SERP | ||
type |
string | type of element = ‘shopping’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘shopping_element‘ |
title |
string | title of the result in SERP |
price |
object | price of the shopping element |
current |
float | current price indicates the current price of the shopping element |
regular |
float | regular price indicates the regular price of the shopping element |
max_value |
float | the maximum price indicates the maximum price of the shopping element |
currency |
string | currency of the listed price ISO code of the currency applied to the price |
is_price_range |
boolean | price is provided as a range indicates whether a price is provided in a range |
displayed_price |
string | price string in the result raw price string as provided in the result |
source |
string | source of the element indicates the source of information included in the shopping_element |
description |
string | the description of the results element in SERP |
marketplace |
string | merchant account provider commerce site that hosts products or websites of individual sellers under the same merchant account example: by Bing |
marketplace_url |
string | relevant marketplace URL URL of the page on the marketplace website where the product is hosted |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘jobs’ element in SERP | ||
type |
string | type of element = ‘jobs’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
url |
string | URL |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘jobs_element‘ |
title |
string | title of the result in SERP |
description |
string | description |
author |
string | author |
job_posted_time |
string | the time when the job was posted |
timestamp |
string | date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
contract_type |
string | contract type |
salary |
string | salary |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘map’ element in SERP | ||
type |
string | type of element = ‘map’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘people_also_ask’ element in SERP | ||
type |
string | type of element = ‘people_also_ask’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘people_also_ask_element‘ |
title |
string | title of the result in SERP |
xpath |
string | the XPath of the element |
expanded_element |
array | expanded element |
type |
string | type of element = ‘people_also_ask_expanded_element‘ |
featured_title |
string | title |
url |
string | relevant URL |
domain |
string | domain in SERP |
title |
string | title of the result in SERP |
description |
string | description of the results element in SERP |
timestamp |
string | date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
table |
object | results table if there are none, equals null |
table_header |
array | column names |
table_content |
array | the content of the table one line of the table in this element of the array |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘questions_and_answers’ element in SERP | ||
type |
string | type of element = ‘questions_and_answers’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘questions_and_answers_element‘ |
url |
string | questions_and_answers_element URL |
question_text |
string | question included in the item |
answer_text |
string | answer included in the item |
source |
string | source of the element indicates the source of information included in the questions_and_answers_element |
domain |
string | domain name of the source |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘recipes’ element in SERP | ||
type |
string | type of element = ‘recipes’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘recipes_element‘ |
title |
string | title of the item |
url |
string | recipes_element URL |
domain |
string | domain in SERP |
source |
string | source of the element indicates the source of information included in the recipes_element |
description |
string | snippet of the element |
time |
string | the total time it takes to prepare the cook the dish |
rating |
object | the item’s rating the popularity rate based on reviews and displayed in SERP |
rating_type |
string | the type of rating here you can find the following elements: Max5 , Percents , CustomMax |
value |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘top_stories’ element in SERP | ||
type |
string | type of element = ‘top_stories’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘top_stories_element‘ |
source |
string | source of the element indicates the source of information included in the top_stories_element |
domain |
string | domain in SERP |
title |
string | title of the result in SERP |
date |
string | the date when the page source of the element was published |
amp_version |
boolean | Accelerated Mobile Pages indicates whether an item has the Accelerated Mobile Page (AMP) version |
timestamp |
string | date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
url |
string | URL |
image_url |
string | URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) |
badges |
array | badges relevant to the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘video’ element in SERP | ||
type |
string | type of element = ‘video’ |
rank_group |
integer | group rank in SERP position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP |
position |
string | the alignment of the element in SERP can take the following values: left , right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘video_element‘ |
source |
string | source of the element indicates the source of the video |
title |
string | title of the result in SERP |
timestamp |
string | date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |