Google News SERP Live HTML

Live SERP HTML provides a raw HTML page of Google News search engine results for the specified keyword, search engine, and location in response to a single request.

curl --location --request POST 'https://api.dataforseo.com/v3/serp/google/news/live/html' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic Og==' \ --data-raw '[ { "keyword": "albert einstein", "location_name": "united states", "language_name": "english" } ]'

{ "version": "0.1.20241227", "status_code": 20000, "status_message": "Ok.", "time": "7.4983 sec.", "cost": 0.002, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "03271032-8029-0140-0000-35c6217ab6cb", "status_code": 20000, "status_message": "Ok.", "time": "7.3290 sec.", "cost": 0.002, "result_count": 1, "path": [ "v3", "serp", "google", "news", "live", "html" ], "data": { "api": "serp", "function": "live", "se": "google", "se_type": "news", "keyword": "albert einstein", "location_name": "united states", "language_name": "english", "device": "desktop", "os": "windows" }, "result": [ { "keyword": "albert einstein", "type": "news", "se_domain": "google.com", "location_code": 2840, "language_code": "en", "datetime": "2025-03-27 08:32:56 +0000", "items_count": 1, "items": [ { "page": 1, "date": "2025-03-27T08:32:56.6157215Z", "html": "<!doctype html><html itemscope=\"\" itemtype=\"http://schema.org/SearchResultsPage\" lang=\"en\"><head><meta charset=\"UTF-8\"><meta content=\"origin\" name=\"referrer\"><meta content=\"/images/branding/googleg/1x/googleg_standard_color_128dp.png\" itemprop=\"image\"><title>albert einstein - Google Search</title><script nonce=\"SVdjIces4GEsyaAbx9sKvQ\">window._hst=Date.now();</script><script nonce=\"SVdjIces4GEsyaAbx9sKvQ\">(function(){var _g={kEI:'Mg3lZ5W0N4Si5NoP49vx4AU',kEXPI:'0,3700244,1140,448528,175343,211575,5663254,1807593,7038774,77,2,4,3,1,3,2,53318479,105339,53867,47629,127312,18558,5352,55,10369,8240,38962,3898,3038,1542,1464,1943,27731,813,3938,986,908,6264,4184,1717,713,2023,2266,2378,1220,4998,10716,3246,131,4754,149,864,2989,2133,1566,88,5055,1613,839,622,80,1597,1957,655,931,2219,50,543,1594,623,880,2542,626,650,169,175,611,902,339,227,2100,1272,57,641,57,687,865,1,3,1,3,2,2,1,3,1,3,2,2,1,3,2,1,3,1,2,3,2,2,2,1,3,1,3,1,2,3,1,2,2,3,1,3,2,2,1,3,1,3,2,2,1,3,1,2,2,2,3,2,2,1,3,2,1,2,3,2,1,2,2,2,2,2,2,3,2,1,2,3,2,1,3,2,1,2,2,3,2,1,2,2,2,2,3,1,2,2,3,2,1,2,3,298,1021,500,108,132,223,761,362,529,61,785,438,293,493,464,207,310,190,617,1331,276,213,426,206,296,17,393,145,75,295,2,351,412,262,122,103,251,184,1220,13,534,69,1167,799,20913263,410036,13085,8536521',kBL:'uevp',kOPI:89978449};(function(){var a;((a=window.google)==null?0:a.stvsc)?google.kEI=_g.kEI:window.google=_g;}).call(this);})();(function(){google.sn='newssearch';google.kHL='en';})();(function(){\nvar g=this||self;function k(){return window.google&&window.google.kOPI||null};var l,m=[];function n(a){for(var b;a&&(!a.getAttribute||!(b=a.getAttribute(\"eid\")));)a=a.parentNode;return b||l}function p(a){for(var b=null;a&&(!a.getAttribute||!(b=a.getAttribute(\"leid\")));)a=a.parentNode;return b}function q(a){/^http:/i.test(a)&&window.location.protocol===\"https:\"&&(google.ml&&google.ml(Error(\"a\"),!1,{src:a,glmm:1}),a=\"\");return a}\nfunction r(a,b,d,c,h){var e=\"\";b.search(\"&ei=\")===-1&&(e=\"&ei=\"+n(c),b.search(\"&lei=\")===-1&&(c=p(c))&&(e+=\"&lei=\"+c));var f=b.search(\"&cshid=\")===-1&&a!==\"slh\";c=\"&zx=\"+Date.now().toString();g._cshid&&f&&(c+=\"&cshid=\"+g._cshid);(d=d())&&(c+=\"&opi=\"+d);return\"/\"+(h||\"gen_204\")+\"?atyp=i&ct=\"+String(a)+\"&cad=\"+(b+e+c)};l=google.kEI;google.getEI=n;google.getLEI=p;google.ml=function(){return null};google.log=function(a,b,d,c,h,e){e=e===void 0?k:e;d||(d=r(a,b,e,c,h));if(d=q(d)){a=new Image;var f=m.length;m[f]=a;a.onerror=a.onload=a.onabort=function(){delete m[f]};a.src=d}};google.logUrl=function(a,b){b=b===void 0?k:b;return r(\"\",a,b)};}).call(this);(function(){google.y={};google.sy=[];var d;(d=google).x||(d.x=function(a,b){if(a)var c=a.id;else{do c=Math.random();while(google.y[c])}google.y[c]=[a,b];return!1});var e;(e=google).sx||(e.sx=function(a){google.sy.push(a)});google.lm=[];var f;(f=google).plm||(f.plm=function(a){google.lm.push.apply(google.lm,a)});google.lq=[];var g;(g=google).load||(g.load=function(a,b,c){google.lq.push([[a],b,c])});var h;(h=google).loadAll||(h.loadAll=function(a,b){google.lq.push([a,b])});google.bx=!1;var k;(k=google).lx||(k.lx=function(){});var l=[],m;(m=google).fce||(m.fce=function(a,b,c,n){l.push([a,b,c,n])});google.qce=l;}).call(this);google.f={};(function(){\ndocument.documentElement.addEventListener(\"submit\",function(b){var a;if(a=b.target){var c=a.getAttribute(\"data-submitfalse\");a=c===\"1\"||c===\"q\"&&!a.elements.q.value?!0:!1}else

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

array of:

keyword

string

required

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”.

<= 700 characters

location_name

string

required

Full name of search engine location. You can find the supported locations in the DataForSEO documentation.

language_name

string

required

Full name of search engine language. You can find the supported languages in the DataForSEO documentation.

url

string

optional

Direct URL of the search query. You can specify a direct URL and we will sort it out to the necessary fields.

location_coordinate

string

optional

GPS coordinates of a location. If you use this field, you don’t need to specify location_name. location_coordinate parameter should be specified in the latitude,longitude,radius format. The maximum number of decimal digits for latitude and longitude: 7. The minimum value for “radius”: 199.9 (mm), the maximum value for “radius”: 199999 (mm). Example: 53.476225,-2.243572,200.

enum<string>

optional

Device operating system.

Allowed values:

windowsmacos

Default:

windows

se_domain

string

optional

Search engine domain. We choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field.

depth

integer

optional

Parsing depth. Number of results in SERP.

<= 700

Default:

100

max_crawl_pages

integer

optional

Page crawl limit. Number of search results pages to crawl.

<= 100

search_param

string

optional

Additional parameters of the search query. You can find the list of available parameters and additional details here.

tag

string

optional

User-defined task identifier. 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.

Examples

Request

Responses