NAVNavbar
Logo
cURL php NodeJS Python cSharp

Get {{up_se_name}} {{up_se_type}} SERP Results by id

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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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 values
positions 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

‌‌