Live SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location. This endpoint will supply a complete overview of featured snippets and other extra elements of SERPs.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-dashboard
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard \
login="login" \
password="password" \
cred="$(printf ${login}:${password} | base64)" \
curl --location --request POST "https://api.dataforseo.com/v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced" \
--header "Authorization: Basic ${cred}" \
--header "Content-Type: application/json" \
--data-raw "[
{
"language_code": "en",
"location_code": 2840,
"keyword": "flight ticket new york san francisco"
}
]"
<?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-dashboard
$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();
}
$post_array = array();
// You can set only one task at a time
$post_array[] = array(
"language_code" => "en",
"location_code" => 2840,
"keyword" => mb_convert_encoding("flight ticket new york san francisco", "UTF-8")
);
try {
// POST /v3/serp/bing/organic/live/advanced
// in addition to 'bing' and 'organic' you can also set other search engine and type parameters
// the full list of possible parameters is available in documentation
$result = $client->post('/v3/serp/bing/organic/live/advanced', $post_array);
print_r($result);
// do something with post 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;
?>
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
post_data = dict()
# You can set only one task at a time
post_data[len(post_data)] = dict(
language_code="en",
location_code=2840,
keyword="flight ticket new york san francisco"
)
# POST /v3/serp/bing/organic/live/advanced
# in addition to 'bing' and 'organic' you can also set other search engine and type parameters
# the full list of possible parameters is available in documentation
response = client.post("/v3/serp/bing/organic/live/advanced", post_data)
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
print(response)
# do something with result
else:
print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
const axios = require('axios');
axios({
method: 'post',
url: 'https://api.dataforseo.com/v3/serp/bing/organic/live/advanced',
auth: {
username: 'login',
password: 'password'
},
data: [{
"keyword": encodeURI("flight ticket new york san francisco"),
"language_code": "en",
"location_code": 2840
}],
headers: {
'content-type': 'application/json'
}
}).then(function (response) {
var result = response['data']['tasks'];
// Result data
console.log(result);
}).catch(function (error) {
console.log(error);
});
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
public static partial class Demos
{
public static async Task serp_live_advanced()
{
var httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/"),
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard
//DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
};
var postData = new List<object>();
// You can set only one task at a time
postData.Add(new
{
language_code = "en",
location_code = 2840,
keyword = "flight ticket new york san francisco"
});
// POST /v3/serp/bing/organic/live/advanced
// in addition to 'bing' and 'organic' you can also set other search engine and type parameters
// the full list of possible parameters is available in documentation
var taskPostResponse = await httpClient.PostAsync("/v3/serp/bing/organic/live/advanced", new StringContent(JsonConvert.SerializeObject(postData)));
var result = JsonConvert.DeserializeObject<dynamic>(await taskPostResponse.Content.ReadAsStringAsync());
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (result.status_code == 20000)
{
// do something with result
Console.WriteLine(result);
}
else
Console.WriteLine($"error. Code: {result.status_code} Message: {result.status_message}");
}
}
}
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}}",
"advanced",
"live",
"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",
"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
}
}
]
}
]
}
]
}
All POST data should be sent in the JSON format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API calls per minute, each Live SERP API call can contain only one task.
Below you will find a detailed description of the fields you can use for setting a task.
Description of the fields for setting a task:
Field name
Type
Description
url
string
direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example: https://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE
keyword
string
keyword required field
you can specify up to 700 characters in the keyword field all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”
learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article
priority
integer
task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priority
location_name
string
full name of search engine location required field if you don’t specifylocation_code or location_coordinate if you use this field, you don’t need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example: London,England,United Kingdom
location_code
integer
search engine location code required field if you don’t specifylocation_name or location_coordinate if you use this field, you don’t need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example: 2840
location_coordinate
string
GPS coordinates of a location required field if you don’t specifylocation_name or location_code if you use this field, you don’t need to specify location_name or location_code location_coordinate parameter should be specified in the “latitude,longitude” format
the maximum number of decimal digits for “latitude” and “longitude”: 7
example: 53.476225,-2.243572
language_name
string
full name of search engine language required field if you don’t specifylanguage_code if you use this field, you don’t need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example: English
language_code
string
search engine language code required field if you don’t specifylanguage_name if you use this field, you don’t need to specify language_name
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages example: en
device
string
device type
optional field
can take the values:desktop, mobile
default value: desktop
os
string
device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android
depth
integer
parsing depth
optional field
number of results in SERP
default value: 100
max value: 700 Note: your account will be billed per each SERP containing up to 100 results;
thus, setting a depth above 100 may result in additional charges if the search engine returns more than 100 results;
if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance
max_crawl_pages
integer
page crawl limit
optional field
number of search results pages to crawl
max value: 100 Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center
calculate_rectangles
boolean
calcualte pixel rankings for SERP elements in advanced results
optional field
pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>>
by default, the parameter is set to false Note: if set to true, the charge per task will be multiplied by 2
browser_screen_width
integer
browser screen width
optional field
you can set a custom browser screen width to calculate pixel rankings for a particular device;
by default, the parameter is set to: 1920 for desktop; 360 for mobile on android; 375 for mobile on iOS; Note: to use this parameter, set calculate_rectangles to true
browser_screen_height
integer
browser screen height
optional field
you can set a custom browser screen height to calculate pixel rankings for a particular device;
by default, the parameter is set to: 1080 for desktop; 640 for mobile on android; 812 for mobile on iOS; Note: to use this parameter, set calculate_rectangles to true
browser_screen_resolution_ratio
integer
browser screen resolution ratio
optional field
you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device;
by default, the parameter is set to: 1 for desktop; 3 for mobile on android; 3 for mobile on iOS; Note: to use this parameter, set calculate_rectangles to true
user-defined task identifier
optional field the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response
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.
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 character ‘+’ 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
equals null
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
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
relevant 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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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