What Are Search Engine Parameters And How to Use Them With SERP API?

blog img 1
When it comes to filtering search results, search engines are quite versatile. Google, for example, offers a variety of advanced parameters for narrowing down the search. From filtering out results for the past 24 hours to running the scholar search, knowing these search parameters can provide plentiful opportunities to SEO geeks and SEO software developers alike.

By knowing what parameters to append to the search URL string, you can also enhance your productivity when working with the SERP API of DataForSEO. If you take a look at the section for DataForSEO Docs that describes the task-setting process for this API, you will likely notice the search_param string. Even though this parameter is optional and is seldom used by our customers, we do get a lot of questions about using advanced search parameters in API requests.

Below you’ll find a set of popular parameters you can use to customize your requests to the SERP API.

Use Cases for Google search parameters

List of Popular Search Parameters

Search Engine Parameter Meaning
Bing q
setlang
count
safesearch
search query
search language
results number
safe search
(off, moderate, strict)
Yahoo p
vl
vc
search query
search language
search country
Google q
hl
gl
uule
tbs
tbm
num
start
safesearch
search query
search language
search location
search region
index time frame
search filter
results number
first result index
safe search
(off, on)

Specify A Time Frame

One of the most popular parameters Google offers for customizing the search is the time filter. By applying the &tbs=qdr:x with a corresponding timeframe indicator in the search_param string, you can get search results indexed by Google within a particular timeframe – e.g., past hour, past 24 hours, past week, and so on.

Parameter: &tbs=qdr:x

Replace x with one of the following timeframe indicators to only see the results first indexed in:

  • h – past hour
  • d – past 24 hours
  • w – past week
  • m – past month
  • mn – the past n number of months. Double digits are supported
  • y – past year


Past hour

Parameter: &tbs=qdr:h

Use it to get files indexed in the past hour.
past hour filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "rank checker",
        "search_param":"&tbs=qdr:h"
    }
]
 
Response Sample 
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "3.7539 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241434-1535-0139-0000-7383e37f039e",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "3.6694 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "rank checker",
                "search_param": "&tbs=qdr:h",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "rank checker",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbs=qdr%3Ah&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:34:53 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "paid",
                        "related_searches"
                    ],
                    "se_results_count": 60,
                    "items_count": 67,
                    "items": [
                        {
                            "type": "paid",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[1]",
                            "title": "SEMrush SEO Audit Tool | High Speed SEO Checker‎",
                            "domain": "www.semrush.com",
                            "breadcrumb": "www.semrush.com/",
                            "url": "https://www.semrush.com/lp/site-audit-2/en/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjhoZTImernAhVKqZYKHakNDKkYABAAGgJ0bA"
                            },
                            "description": "SEMrush Site Audit: over 100 technical SEO checks. Try now! 4,5+ trillion backlinks. Online SEO Analysis. 100+ SEO checks. Technical Site Audit. Best SEO Tool 2018 Winner. Diagnose Your Website. Services: Keyword Analytics, Site Audit, Traffic Analytics.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[2]",
                            "title": "Search Ranking Tool | Flexible And 100% Accurate‎",
                            "domain": "seranking.com",
                            "breadcrumb": "www.seranking.com/",
                            "url": "https://seranking.com/position-tracking.html",
                            "highlighted": [
                                "Rankings",
                                "Ranking"
                            ],
                            "extra": {
                                "ad_aclk": "DChcSEwjhoZTImernAhVKqZYKHakNDKkYABADGgJ0bA"
                            },
                            "description": "Rankings In Search For All Locations, Languages, Devices. +35 Tools For SEO. Free Trial! 300000 Users Chose SE Ranking To Boost Their Marketing Efforts. Join SE Ranking! SEO/PPC Research. API. 100% Accurate results. White Label. SERP's TOP 200 Tracking.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[3]",
                            "title": "SEO Rank Monitor | The Most Complete Rank Checker‎",
                            "domain": "www.seorankmonitor.com",
                            "breadcrumb": "www.seorankmonitor.com/Rank/Checker",
                            "url": "http://www.seorankmonitor.com/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjhoZTImernAhVKqZYKHakNDKkYABACGgJ0bA"
                            },
                            "description": "Everything you need to keep your Website Ranked High - Start a Free Trial Now! Track Competitors. Advanced Filters. Clear Reporting. Free 14-day Trial. Robust Tracking. Easy Export & Sharing. Features: Clear Reporting, Advanced Filters, Robust Tracking.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "oqpt.strafrechtliches-berlin.de",
                            "title": "First Rank Seo",
                            "url": "http://oqpt.strafrechtliches-berlin.de/first-rank-seo.html",
                            "cache_url": "http://webcache.googleusercontent.com/search?q=cache:W5R9dVpplFgJ:oqpt.strafrechtliches-berlin.de/first-rank-seo.html+&cd=1&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "oqpt.strafrechtliches-berlin.de › first-rank-seo",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "6 mins ago - First rank check: 15-12-2010. Get traffic statistics, SEO keyword opportunities, audience insights, and competitive analytics for Firstrankdigital. | Hi,warmly ...",
                            "pre_snippet": "6 mins ago",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "rank check"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "www.milesplit.com",
                            "title": "MileSplit United States | United States High School Running ...",
                            "url": "https://www.milesplit.com/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:Cc8xaqZpKpoJ:https://www.milesplit.com/+&cd=2&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.milesplit.com",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "38 mins ago - MileSplit United States has the latest United States high school running, cross country, and track & field coverage. Get rankings, race results, stats, news, photos ...",
                            "pre_snippet": "38 mins ago",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "rankings"
                            ],
                            "links": null
                        },
...


Past 24 hours

Parameter: &tbs=qdr:d

Use it to get files indexed in the past 24 hours.

past 24 hours filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "rank checker",
        "search_param":"&tbs=qdr:d"
    }
]
 
Response Sample 
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "10.4834 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241435-1535-0139-0000-5355b9394100",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "10.4154 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "rank checker",
                "search_param": "&tbs=qdr:d",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "rank checker",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbs=qdr%3Ad&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:36:05 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "paid",
                        "related_searches",
                        "people_also_search"
                    ],
                    "se_results_count": 73,
                    "items_count": 80,
                    "items": [
                        {
                            "type": "paid",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[1]",
                            "title": "SEMrush SEO Audit Tool | High Speed SEO Checker‎",
                            "domain": "www.semrush.com",
                            "breadcrumb": "www.semrush.com/",
                            "url": "https://www.semrush.com/lp/site-audit-2/en/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjEwufomernAhUN02QKHb2rBGMYABAAGgJwag"
                            },
                            "description": "SEMrush Site Audit: over 100 technical SEO checks. Try now! 4,5+ trillion backlinks. Online SEO Analysis. Best SEO Tool 2018 Winner. Technical Site Audit. 100+ SEO checks. Diagnose Your Website. Services: Keyword Analytics, Site Audit, Traffic Analytics.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[2]",
                            "title": "SEO Keyword Rank Checker | Global, Local & Mobile Results‎",
                            "domain": "www.advancedwebranking.com",
                            "breadcrumb": "www.advancedwebranking.com/",
                            "url": "https://www.advancedwebranking.com/localization.html",
                            "highlighted": [
                                "Rank Checker",
                                "Rankings"
                            ],
                            "extra": {
                                "ad_aclk": "DChcSEwjEwufomernAhUN02QKHb2rBGMYABABGgJwag"
                            },
                            "description": "Accurate Up To the City Level Rank Checker. Start Your 30-Day Free Trial Now! Trusted For 17 Years. No Credit Card Required. Accurate & Fresh Rankings. Localized Search Queries. On Any Search Engine. Unlimited User Accounts. All SERP Features Covered.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[3]",
                            "title": "SEO Rank Monitor | The Most Complete Rank Checker‎",
                            "domain": "www.seorankmonitor.com",
                            "breadcrumb": "www.seorankmonitor.com/Rank/Checker",
                            "url": "http://www.seorankmonitor.com/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjEwufomernAhUN02QKHb2rBGMYABACGgJwag"
                            },
                            "description": "Everything you need to keep your Website Ranked High - Start a Free Trial Now!",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 4,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[4]",
                            "title": "Search Ranking Tool | Flexible And 100% Accurate‎",
                            "domain": "seranking.com",
                            "breadcrumb": "www.seranking.com/",
                            "url": "https://seranking.com/position-tracking.html",
                            "highlighted": [
                                "Rankings"
                            ],
                            "extra": {
                                "ad_aclk": "DChcSEwjEwufomernAhUN02QKHb2rBGMYABADGgJwag"
                            },
                            "description": "Rankings In Search For All Locations, Languages, Devices. +35 Tools For SEO. Free Trial!",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "www.semrush.com",
                            "title": "SEMrush Sensor – Google's rank and algorithm tracking tool ...",
                            "url": "https://www.semrush.com/sensor/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:iYRIcs_GyWMJ:https://www.semrush.com/sensor/+&cd=1&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.semrush.com › sensor",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "10 hours ago - Although some sites experience insignificant rankings changes, this is most likely because these sites or their backlink profiles are ... On Page SEO Checker.",
                            "pre_snippet": "10 hours ago",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "rankings",
                                "Checker"
                            ],
                            "links": null
                        },
...


Past week

Parameter: &tbs=qdr:w

Use it to get files indexed during the past week.

past week filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "rank checker",
        "search_param":"&tbs=qdr:w"
    }
]
 
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "14.3479 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241441-1535-0139-0000-5fa1c987f010",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "14.2981 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "rank checker",
                "search_param": "&tbs=qdr:w",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "rank checker",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbs=qdr%3Aw&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:41:23 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "paid",
                        "related_searches",
                        "people_also_search"
                    ],
                    "se_results_count": 78100,
                    "items_count": 103,
                    "items": [
                        {
                            "type": "paid",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[1]",
                            "title": "SEO Rank Monitor | The Most Complete Rank Checker‎",
                            "domain": "www.seorankmonitor.com",
                            "breadcrumb": "www.seorankmonitor.com/Rank/Checker",
                            "url": "http://www.seorankmonitor.com/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjS8uWBm-rnAhUH4ncKHQBODzEYABAAGgJlZg"
                            },
                            "description": "Everything you need to keep your Website Ranked High - Start a Free Trial Now! Easy Export & Sharing. Advanced Filters. Track Competitors. Robust Tracking. Free 14-day Trial. Clear Reporting. Types: Personal, Pro, Pro Plus, Enterprise.",
                            "description_rows": null,
                            "links": [
                                {
                                    "type": "ad_link_element",
                                    "title": "Features",
                                    "description": "Check our features for themost complete rank tracking tool",
                                    "url": "http://www.seorankmonitor.com/features/",
                                    "ad_aclk": "DChcSEwjS8uWBm-rnAhUH4ncKHQBODzEYABAEGgJlZg"
                                },
                                {
                                    "type": "ad_link_element",
                                    "title": "Plans",
                                    "description": "We offer multiple plans toserve single user up to enterprises",
                                    "url": "http://www.seorankmonitor.com/pricing/",
                                    "ad_aclk": "DChcSEwjS8uWBm-rnAhUH4ncKHQBODzEYABAFGgJlZg"
                                }
                            ]
                        },
                        {
                            "type": "paid",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[2]",
                            "title": "SEMrush SEO Audit Tool | High Speed SEO Checker‎",
                            "domain": "www.semrush.com",
                            "breadcrumb": "www.semrush.com/",
                            "url": "https://www.semrush.com/lp/site-audit-2/en/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjS8uWBm-rnAhUH4ncKHQBODzEYABACGgJlZg"
                            },
                            "description": "SEMrush Site Audit: over 100 technical SEO checks. Try now! Best SEO Tool 2018 Winner.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[3]",
                            "title": "Search Ranking Tool | Free Trial With All Features‎",
                            "domain": "seranking.com",
                            "breadcrumb": "www.seranking.com/",
                            "url": "https://seranking.com/position-tracking.html",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjS8uWBm-rnAhUH4ncKHQBODzEYABADGgJlZg"
                            },
                            "description": "All Locations and Devices. Free Competitor Monitoring. White Label & API. From £10.8/m.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 4,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[4]",
                            "title": "SEO Keyword Rank Checker | Global, Local & Mobile Results‎",
                            "domain": "www.advancedwebranking.com",
                            "breadcrumb": "www.advancedwebranking.com/",
                            "url": "https://www.advancedwebranking.com/localization.html",
                            "highlighted": [
                                "Rank Checker"
                            ],
                            "extra": {
                                "ad_aclk": "DChcSEwjS8uWBm-rnAhUH4ncKHQBODzEYABABGgJlZg"
                            },
                            "description": "Accurate Up To the City Level Rank Checker. Start Your 30-Day Free Trial Now!",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "www.shoutmeloud.com",
                            "title": "2 Best YouTube Rank Checker Tools (Free + Paid)",
                            "url": "https://www.shoutmeloud.com/youtube-rank-checker.html",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:wORJW24Sa_kJ:https://www.shoutmeloud.com/youtube-rank-checker.html+&cd=1&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.shoutmeloud.com › vlogging",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "5 days ago - Looking to check the ranking of your YouTube videos? Want to track YouTube video ranking positions for a specific keyword? If your answer is yes, a good ...",
                            "pre_snippet": "5 days ago",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "check",
                                "ranking"
                            ],
                            "links": null
                        },
...


Past month

Parameter: &tbs=qdr:m

Use it to get files indexed in the past month.

past month filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "rank checker",
        "search_param":"&tbs=qdr:m"
    }
]
 
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "7.3290 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241442-1535-0139-0000-d0e23c731b2c",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "7.2387 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "rank checker",
                "search_param": "&tbs=qdr:m",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "rank checker",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbs=qdr%3Am&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:42:47 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "people_also_ask",
                        "paid",
                        "related_searches",
                        "people_also_search"
                    ],
                    "se_results_count": 176000,
                    "items_count": 103,
                    "items": [
                        {
                            "type": "paid",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[1]",
                            "title": "SEMrush Site Health Checker | Check Your Website's Health‎",
                            "domain": "www.semrush.com",
                            "breadcrumb": "www.semrush.com/",
                            "url": "https://www.semrush.com/lp/site-audit-2/en/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwj9ybKpm-rnAhUYquwKHTnWB8sYABABGgJwag"
                            },
                            "description": "Perform a comprehensive technical SEO audit and track the progress. Diagnose Your Website. 100+ SEO checks. Technical Site Audit. Online SEO Analysis. 4,5+ trillion backlinks.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "www.link-assistant.com",
                            "title": "Rank Tracker - Quick & Easy Search Engine Ranking Checker ...",
                            "url": "https://www.link-assistant.com/rank-tracker/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:vBzaGlYEBAkJ:https://www.link-assistant.com/rank-tracker/+&cd=1&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.link-assistant.com › rank-tracker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "5 Feb 2020 - If you think that a keyword rank checker tool providing unlimited data doesn't exist, you've never tried Rank Tracker. Track keywords with no limit, check positions ...",
                            "pre_snippet": "02/05/2020 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "rank checker"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "www.shoutmeloud.com",
                            "title": "2 Best YouTube Rank Checker Tools (Free + Paid)",
                            "url": "https://www.shoutmeloud.com/youtube-rank-checker.html",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:wORJW24Sa_kJ:https://www.shoutmeloud.com/youtube-rank-checker.html+&cd=2&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.shoutmeloud.com › vlogging",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "5 days ago - Looking to check the ranking of your YouTube videos? Want to track YouTube video ranking positions for a specific keyword? If your answer is yes, a good ...",
                            "pre_snippet": "5 days ago",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "check",
                                "ranking"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 3,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[3]/div[1]",
                            "domain": "www.serprobot.com",
                            "title": "Free SERP checker - google ranking check | serprobot.com",
                            "url": "https://www.serprobot.com/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:Zd70StapzBcJ:https://www.serprobot.com/+&cd=3&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.serprobot.com",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "14 Feb 2020 - Free SERP check, track and monitor your search engine keyword ranking quickly and accurately.",
                            "pre_snippet": "02/14/2020 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "check",
                                "ranking"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 4,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[4]/div[1]",
                            "domain": "ahrefs.com",
                            "title": "Keyword Rank Checker By Ahrefs: Track Your Keyword ...",
                            "url": "https://ahrefs.com/de/keyword-rank-checker",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:RXD0vOpG6PoJ:https://ahrefs.com/de/keyword-rank-checker+&cd=4&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "ahrefs.com › keyword-rank-checker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "12 Feb 2020 - The Keyword Rank Checker tool by Ahrefs lets you see keyword rankings for any website and how well your target keywords rank for on desktop and mobile.",
                            "pre_snippet": "02/12/2020 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "Rank Checker"
                            ],
                            "links": null
                        },
...


Past 11 months

Parameter: &tbs=qdr:m11

Use it to get files indexed in the past 11 months.

past 11 months filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "rank checker",
        "search_param":"&tbs=qdr:m11"
    }
]
 
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "5.9197 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241443-1535-0139-0000-058203411702",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "5.8770 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "rank checker",
                "search_param": "&tbs=qdr:m11",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "rank checker",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbs=qdr%3Am11&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:43:54 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "video",
                        "people_also_ask",
                        "paid",
                        "related_searches",
                        "people_also_search"
                    ],
                    "se_results_count": 4490000,
                    "items_count": 106,
                    "items": [
                        {
                            "type": "paid",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[1]",
                            "title": "SEO Rank Monitor | The Most Complete Rank Checker‎",
                            "domain": "www.seorankmonitor.com",
                            "breadcrumb": "www.seorankmonitor.com/Rank/Checker",
                            "url": "http://www.seorankmonitor.com/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwiPtLvJm-rnAhWEoOwKHQgcC6kYABAAGgJwag"
                            },
                            "description": "Everything you need to keep your Website Ranked High - Start a Free Trial Now! Free 14-day Trial. Clear Reporting. Advanced Filters. Easy Export & Sharing. Track Competitors. Robust Tracking. Types: Personal, Pro, Pro Plus, Enterprise.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[2]",
                            "title": "SEO Keyword Rank Checker | Global, Local & Mobile Results‎",
                            "domain": "www.advancedwebranking.com",
                            "breadcrumb": "www.advancedwebranking.com/",
                            "url": "https://www.advancedwebranking.com/localization.html",
                            "highlighted": [
                                "Rank Checker",
                                "Rankings"
                            ],
                            "extra": {
                                "ad_aclk": "DChcSEwiPtLvJm-rnAhWEoOwKHQgcC6kYABACGgJwag"
                            },
                            "description": "Accurate Up To the City Level Rank Checker. Start Your 30-Day Free Trial Now! Global Search Queries. Fully White-label Reports. Fresh On-Demand Rankings. Search Visibility KPIs. Search Performance Trends. Unlimited User Accounts. Mobile-Friendly UI.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[3]",
                            "title": "SEMrush SEO Audit Tool | High Speed SEO Checker‎",
                            "domain": "www.semrush.com",
                            "breadcrumb": "www.semrush.com/",
                            "url": "https://www.semrush.com/lp/site-audit-2/en/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwiPtLvJm-rnAhWEoOwKHQgcC6kYABADGgJwag"
                            },
                            "description": "SEMrush Site Audit: over 100 technical SEO checks. Try now! 4,5+ trillion backlinks.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 4,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[4]",
                            "title": "Search Ranking Tool | All Locations. All devices | SERanking.com‎",
                            "domain": "seranking.com",
                            "breadcrumb": "www.seranking.com/",
                            "url": "https://seranking.com/position-tracking.html",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwiPtLvJm-rnAhWEoOwKHQgcC6kYABABGgJwag"
                            },
                            "description": "Manage Your SEO Easily At Affordable Price. All-In-One SEO Software To Reach SERP's Top.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "moz.com",
                            "title": "Rank Checker Overview - Help Hub - Moz",
                            "url": "https://moz.com/help/research-tools/rank-checker/overview",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:9t5crp_zGacJ:https://moz.com/help/research-tools/rank-checker/overview+&cd=1&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "moz.com › Help › Moz Research Tools › Rank Checker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "3 Oct 2019 - Can I track local keywords in the Rank Checker? ... Rank Checker is available with your Moz Pro subscription and you can reach it through the menu here:.",
                            "pre_snippet": "10/03/2019 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "Rank Checker"
                            ],
                            "links": null
                        },
...


Past year

Parameter: &tbs=qdr:y

Use it to get files indexed in the past year.

past year filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "rank checker",
        "search_param":"&tbs=qdr:y"
    }
]
 
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "6.8128 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241447-1535-0139-0000-8345857373f8",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "6.7226 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "rank checker",
                "search_param": "&tbs=qdr:y",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "rank checker",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbs=qdr%3Ay&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:47:10 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "video",
                        "people_also_ask",
                        "related_searches",
                        "people_also_search"
                    ],
                    "se_results_count": 5220000,
                    "items_count": 101,
                    "items": [
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "sitechecker.pro",
                            "title": "Keyword Rank Checker: Check Google Rankings for a Website",
                            "url": "https://sitechecker.pro/rank-checker/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:HA8btjnSXBcJ:https://sitechecker.pro/rank-checker/+&cd=1&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "sitechecker.pro › rank-checker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "18 Apr 2019 - What Is Keyword Rank Checker and How to Use It Properly? ... This is a tool that shows by which keywords a specific website ranks in Google SERP and on what positions. ... Rank Checker also helps to get valuable data by both your websites and competitors’ websites.",
                            "pre_snippet": "04/18/2019 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "Rank Checker",
                                "ranks"
                            ],
                            "links": [
                                {
                                    "type": "link_element",
                                    "title": "Rank Tracker",
                                    "description": null,
                                    "url": "https://sitechecker.pro/rank-tracker/"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Backlink Checker Tool",
                                    "description": null,
                                    "url": "https://sitechecker.pro/backlinks-checker/"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Website Traffic Checker",
                                    "description": null,
                                    "url": "https://sitechecker.pro/traffic-checker/"
                                }
                            ]
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "moz.com",
                            "title": "Rank Checker Overview - Help Hub - Moz",
                            "url": "https://moz.com/help/research-tools/rank-checker/overview",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:9t5crp_zGacJ:https://moz.com/help/research-tools/rank-checker/overview+&cd=2&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "moz.com › Help › Moz Research Tools › Rank Checker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "3 Oct 2019 - Can I track local keywords in the Rank Checker? ... Rank Checker is available with your Moz Pro subscription and you can reach it through the menu here:.",
                            "pre_snippet": "10/03/2019 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "Rank Checker"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[3]/div[1]",
                            "domain": "www.accuranker.com",
                            "title": "Google Rank Checker • Check your positions in Google » Try ...",
                            "url": "https://www.accuranker.com/google-rank-checker",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:jVvo-HcKu7YJ:https://www.accuranker.com/google-rank-checker+&cd=3&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.accuranker.com › google-rank-checker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "3 Jun 2019 - Try the fastest Google rank checker in the world. See your keyword positions, and how your competitors are ranking. ✅️ Check on both desktop and mobile!",
                            "pre_snippet": "06/03/2019 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "rank checker"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 4,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[4]/div[1]",
                            "domain": "www.accuranker.com",
                            "title": "Keyword Rank Checker » SEO Tracker To Check Positions in ...",
                            "url": "https://www.accuranker.com/keyword-rank-checker",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:WIBieL6p_tEJ:https://www.accuranker.com/keyword-rank-checker+&cd=4&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.accuranker.com › keyword-rank-checker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "15 May 2019 - Try the fastest keyword rank checker in the world. See keyword positions for your site, and how it ranks on both desktop and mobile. ✅️ Instant updates!",
                            "pre_snippet": "05/15/2019 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "rank checker"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 5,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[5]/div[1]",
                            "domain": "ahrefs.com",
                            "title": "Website Authority Checker: Check the \"Authority\" Of Any Domain",
                            "url": "https://ahrefs.com/website-authority-checker",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:-9MH-qU_gBkJ:https://ahrefs.com/website-authority-checker+&cd=5&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "ahrefs.com › website-authority-checker",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "9 Jul 2019 - Free tool to check the \"authority\" of any website based on the quality and ... between Domain Rating (DR) and keyword rankings for 218,713 domains, we found ...",
                            "pre_snippet": "07/09/2019 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "check",
                                "rankings"
                            ],
                            "links": null
                        },
...

Specify A Category

Google offers several results categories for narrowing down the search to, for example, books or news – related results. As for now, Google offers nine search results categories. SERP API, however, has support only for four of them: Videos, Books, News, and Patents. You can get the results for Google Shopping, Images and Maps categories by using the corresponding endpoints.

Parameter: tbm=x

Replace x with one the following categories to see results only for this category:

  • vid – videos
  • bks – books
  • nws – news
  • pts – patents


Videos

Parameter: tbm=vid

Use it to get results related to the “Videos” category.

videos filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "computer",
        "search_param":"tbm=vid"
    }
]
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "8.6259 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241605-1535-0139-0000-aa1ad0fff574",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "8.5293 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "computer",
                "search_param": "tbm=vid",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "computer",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=computer&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbm=vid&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 14:05:36 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "related_searches"
                    ],
                    "se_results_count": 805000000,
                    "items_count": 101,
                    "items": [
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "kano.me",
                            "title": "Computer Kit | Make a computer, learn to code",
                            "url": "https://kano.me/uk/store/products/computer-kit",
                            "cache_url": null,
                            "breadcrumb": "https://kano.me › store › products › computer-kit",
                            "is_image": false,
                            "is_video": true,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "Build your own computer, learn to code with 100+ creative challenges, make your own art, music and games ...",
                            "pre_snippet": "09/22/2019 00:00:00",
                            "extended_snippet": "22 Sep 2019 - Uploaded by Kano Computing",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "computer"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "edu.gcfglobal.org",
                            "title": "Computer Basics: What is a Computer? - GCFLearnFree",
                            "url": "https://edu.gcfglobal.org/en/computerbasics/what-is-a-computer/1/",
                            "cache_url": null,
                            "breadcrumb": "https://edu.gcfglobal.org › computerbasics › what-is-a-computer",
                            "is_image": false,
                            "is_video": true,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "A computer is an electronic device that manipulates information, or data. It has the ability to store, retrieve, and ...",
                            "pre_snippet": "06/07/2016 00:00:00",
                            "extended_snippet": "7 Jun 2016 - Uploaded by GCFLearnFree.org",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "computer"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[3]/div[1]",
                            "domain": "www.ebuyer.com",
                            "title": "What is a computer? - Ebuyer Blog - Ebuyer.com",
                            "url": "https://www.ebuyer.com/blog/2018/05/what-is-a-computer/",
                            "cache_url": null,
                            "breadcrumb": "https://www.ebuyer.com › Home › Guides",
                            "is_image": false,
                            "is_video": true,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "... years ago this month Apple turned desktop computing on its head by launching the iMac. In this blog post we ...",
                            "pre_snippet": null,
                            "extended_snippet": "22 May 2018",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": null,
                            "links": null
                        },
…


Books

Parameter: tbm=bks

Use it to get results related to the “Books” category.

books filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "computer",
        "search_param":"tbm=bks"
    }
]
 
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "16.2685 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241450-1535-0139-0000-18fb47634a8a",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "16.1640 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "computer",
                "search_param": "tbm=bks",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "computer",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=computer&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbm=bks&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:50:19 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic"
                    ],
                    "se_results_count": 151000000,
                    "items_count": 100,
                    "items": [
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "books.google.co.uk",
                            "title": "The Computer Book: An Introduction to Computers and Computing",
                            "url": "https://books.google.co.uk/books?id=HbFrQgAACAAJ&dq=computer&hl=en&sa=X&ved=0ahUKEwi-_eX_nOrnAhWsxoUKHRfAC1wQ6AEIKjAA",
                            "cache_url": null,
                            "breadcrumb": "books.google.co.uk › books",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": null,
                            "pre_snippet": null,
                            "extended_snippet": "Robin Bradbeer, ‎Peter De Bono, ‎Peter Laurie - 1982 - ‎No preview",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "books.google.co.uk",
                            "title": "Reliability in Computer System Design",
                            "url": "https://books.google.co.uk/books?id=1mbNVuxcA4cC&pg=PA1&dq=computer&hl=en&sa=X&ved=0ahUKEwi-_eX_nOrnAhWsxoUKHRfAC1wQ6AEIMjAB",
                            "cache_url": null,
                            "breadcrumb": "books.google.co.uk › books",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "1 INTRODUCTION 1.1 NEED FOR RELIABILITY Nowadays computers have become very complex and sophisticated, and their applications have increased at an alarming rate. For example, according to the Wall Street Journal of January 23, ...",
                            "pre_snippet": null,
                            "extended_snippet": "Balbir S. Dhillon - 1987 - ‎Preview - ‎More editions",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "computers"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[3]/div[1]",
                            "domain": "books.google.co.uk",
                            "title": "Multiple Choice Questions in Computer Science",
                            "url": "https://books.google.co.uk/books?id=RYkyCRB9X2cC&pg=PP6&dq=computer&hl=en&sa=X&ved=0ahUKEwi-_eX_nOrnAhWsxoUKHRfAC1wQ6AEIOzAC",
                            "cache_url": null,
                            "breadcrumb": "books.google.co.uk › books",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "Computer science and technology has become lifeline of the modern industrial and social development. Our civilization is thousands of years old, but computer is just of sixty. In spite of its negligible age compared to the age of human ...",
                            "pre_snippet": null,
                            "extended_snippet": "Ela Kumar - 2008 - ‎Preview",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "Computer",
                                "computer"
                            ],
                            "links": null
                        },
...


News

Parameter: tbm=nws

Use it to get results related to the “News” category.

news filter

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "brexit",
        "search_param":"tbm=nws"
    }
]
 
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "21.4329 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241453-1535-0139-0000-651e295a8f1f",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "21.3736 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "brexit",
                "search_param": "tbm=nws",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "brexit",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=brexit&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbm=nws&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:53:35 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic"
                    ],
                    "se_results_count": 190000000,
                    "items_count": 100,
                    "items": [
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "www.theneweuropean.co.uk",
                            "title": "Iain Duncan-Smith says it's time for experts to handle Brexit as ...",
                            "url": "https://www.theneweuropean.co.uk/top-stories/iain-duncan-smith-calls-for-experts-on-brexit-1-6528371",
                            "cache_url": null,
                            "breadcrumb": "",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": null,
                            "pre_snippet": null,
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "www.express.co.uk",
                            "title": "Brexit LIVE: Boris plots REMAINER CULL as civil servants ...",
                            "url": "https://www.express.co.uk/news/politics/1246424/brexit-news-latest-boris-johnson-eu-trade-talks-emmanuel-macron-political-news",
                            "cache_url": null,
                            "breadcrumb": "",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": null,
                            "pre_snippet": null,
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]",
                            "domain": "www.ft.com",
                            "title": "Half of British boards expect Brexit to damage business",
                            "url": "https://www.ft.com/content/2ee82206-5408-11ea-90ad-25e377c0ee1f",
                            "cache_url": null,
                            "breadcrumb": "",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": null,
                            "pre_snippet": null,
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": null,
                            "links": null
                        },
...


Patents

Parameter: tbm=pts

Use it to get patent results related to your query.
computer Google Search Google Chrome 2020 02 2 3 e1582554658639

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "computer",
        "search_param":"tbm=pts"
    }
]
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "11.5541 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241458-1535-0139-0000-c055e26c0b92",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "11.5061 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "computer",
                "search_param": "tbm=pts",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "computer",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=computer&num=100&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbm=pts&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 12:58:19 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic"
                    ],
                    "se_results_count": 8800000,
                    "items_count": 100,
                    "items": [
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "www.google.co.uk",
                            "title": "Start menu operation for computer user interface ",
                            "url": "https://www.google.co.uk/patents/US8490016?dq=computer&hl=en&sa=X&ved=0ahUKEwiZxrTmnurnAhW4IjQIHRiZC4AQ6AEIKjAA",
                            "cache_url": null,
                            "breadcrumb": "www.google.co.uk/patents/US8490016",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "The Start button on contemporary (e.g., Microsoft Windows®-based) computer shells/user interfaces provides a simple and unambiguous way for even novice ...",
                            "pre_snippet": null,
                            "extended_snippet": "Grant - ‎Filed 6 Oct 2009 - ‎ Issued 16 Jul 2013 - ‎Pasquale DeMaio - ‎Microsoft Corporation",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "computer"
                            ],
                            "links": [
                                {
                                    "type": "link_element",
                                    "title": "Overview",
                                    "description": null,
                                    "url": "https://www.google.co.uk/patents/US8490016?hl=en&dq=computer"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Related",
                                    "description": null,
                                    "url": "https://www.google.com/patents/related/US8490016"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Discuss",
                                    "description": null,
                                    "url": "https://www.google.com/url?ptose&q=//patents.stackexchange.com/redirect/google-patents?patent%3DUS8490016&usg=AOvVaw194JPqRNqEVaIoG14pjmcP"
                                }
                            ]
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "www.google.co.uk",
                            "title": "Micro channel bus computer system with IDE hard drive interface ",
                            "url": "https://www.google.co.uk/patents/US5544334?dq=computer&hl=en&sa=X&ved=0ahUKEwiZxrTmnurnAhW4IjQIHRiZC4AQ6AEIMjAB",
                            "cache_url": null,
                            "breadcrumb": "www.google.co.uk/patents/US5544334",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "A computer system having: a central processing unit (CPU), having a system bus associated therewith, a first bus interface circuit (BIC) in circuit communication ...",
                            "pre_snippet": null,
                            "extended_snippet": "Grant - ‎Filed 22 Dec 1993 - ‎ Issued 6 Aug 1996 - ‎Mark G. Noll - ‎International Business Machines Corporation",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "computer"
                            ],
                            "links": [
                                {
                                    "type": "link_element",
                                    "title": "Overview",
                                    "description": null,
                                    "url": "https://www.google.co.uk/patents/US5544334?hl=en&dq=computer"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Related",
                                    "description": null,
                                    "url": "https://www.google.com/patents/related/US5544334"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Discuss",
                                    "description": null,
                                    "url": "https://www.google.com/url?ptose&q=//patents.stackexchange.com/redirect/google-patents?patent%3DUS5544334&usg=AOvVaw00o9L-4vvmYUIMD_kBgeen"
                                }
                            ]
                        },
                        {
                            "type": "organic",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[6]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[3]/div[1]",
                            "domain": "www.google.co.uk",
                            "title": "Laptop computer base ",
                            "url": "https://www.google.co.uk/patents/US6529369?dq=computer&hl=en&sa=X&ved=0ahUKEwiZxrTmnurnAhW4IjQIHRiZC4AQ6AEIOjAC",
                            "cache_url": null,
                            "breadcrumb": "www.google.co.uk/patents/US6529369",
                            "is_image": true,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "A base for a laptop computer. In one embodiment, the base has an upper surface with a keyboard and a lower surface opposite the upper surface. The lower ...",
                            "pre_snippet": null,
                            "extended_snippet": "Grant - ‎Filed 18 Mar 1998 - ‎ Issued 4 Mar 2003 - ‎Lynne Zarek - ‎Micron Technology, Inc.",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "computer"
                            ],
                            "links": [
                                {
                                    "type": "link_element",
                                    "title": "Overview",
                                    "description": null,
                                    "url": "https://www.google.co.uk/patents/US6529369?hl=en&dq=computer"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Related",
                                    "description": null,
                                    "url": "https://www.google.com/patents/related/US6529369"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Discuss",
                                    "description": null,
                                    "url": "https://www.google.com/url?ptose&q=//patents.stackexchange.com/redirect/google-patents?patent%3DUS6529369&usg=AOvVaw2p9Cb2v9SW9WZTLJp_ujoR"
                                }
                            ]
                        },
          …      

Specify the Number Of Results On a Results Page

By default, SERP API shows 100 results on the page. Now, let’s say you need to retrieve only the first page of SERP and process the remaining 90 results in nine separate batches of only ten results included into each of them. Put simply, in this case you get the default view of SERP with ten results on each page.

  • Parameter: &start=x

Swap out the x with the number of the position that you want to start retrieving results from. For example, you can use the &start=10 if you want to exclude the first ten search results from the SERP API response.

  • Integer: “depth”:y

Unlike other parameters we used in this article depth is a stand-alone integer used to specify the number of results you want to get ( i.e., crawling depth). For, example, by swapping out the y with 10, you will get the first ten results of the search engine results page.

  • Combining the &start=x parameter with the “depth”:y integer

You can also combine the above parameters to get a particular page of Google or make a series of API requests to group results by a certain number. For example, you may want to crawl the first 30 results and include only 10 results into each API response. In the case, you’d need to make three separate requests using different search parameters as well as specify the crawling depth.

First request:
“depth”:10

Use it to get the first 10 results of SERPs.

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "serp api",
        "depth": 10
    }
]
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "3.0190 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241506-1535-0139-0000-ea54cc052a8d",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "2.9650 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "serp api",
                "depth": 10,
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "serp api",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 13:06:51 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "people_also_ask",
                        "related_searches"
                    ],
                    "se_results_count": 1720000,
                    "items_count": 12,
                    "items": [
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "serpapi.com",
                            "title": "Google Search API - SerpApi",
                            "url": "https://serpapi.com/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:LItv_3DO2N8J:https://serpapi.com/+&cd=1&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "serpapi.com",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "SerpApi is a real-time API to access Google search results. We handle the issues of having to rent proxies, solving captchas, and parsing rich structured data for ...",
                            "pre_snippet": null,
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "SerpApi"
                            ],
                            "links": [
                                {
                                    "type": "link_element",
                                    "title": "Google Search API",
                                    "description": null,
                                    "url": "https://serpapi.com/search-api"
                                },
                                {
                                    "type": "link_element",
                                    "title": "SerpApi Playground",
                                    "description": null,
                                    "url": "https://serpapi.com/playground"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Account API",
                                    "description": null,
                                    "url": "https://serpapi.com/account-api"
                                },
                                {
                                    "type": "link_element",
                                    "title": "Search Archive API",
                                    "description": null,
                                    "url": "https://serpapi.com/search-archive-api"
                                }
                            ]
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "geekflare.com",
                            "title": "9 Best SERP API to Scrape Real-time Search Engine Results ...",
                            "url": "https://geekflare.com/serp-api/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:5V-j1z0buU0J:https://geekflare.com/serp-api/+&cd=2&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "geekflare.com › serp-api",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "4 Nov 2019 - Google constantly keeps on changing its SERP structure and overall algorithm, so it's essential to scrape search results via accurate sources.",
                            "pre_snippet": "11/04/2019 00:00:00",
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "SERP"
                            ],
                            "links": null
                        },
                        {
                            "type": "people_also_ask",
                            "rank_group": 1,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]",
                            "items": [
                                {
                                    "type": "people_also_ask_element",
                                    "title": "What is SERP API?",
                                    "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/g-accordion-expander[1]",
                                    "expanded_element": [
                                        {
                                            "type": "people_also_ask_expanded_element",
                                            "featured_title": null,
                                            "url": "https://rapidapi.com/blog/directory/serp/",
                                            "domain": "rapidapi.com",
                                            "title": "Serp API (Overview, Documentation & Alternatives) | RapidAPI",
                                            "description": "API to scrape and parse search engine results. Including Google, Bing, Yahoo! and more. ... SERP API is built to get TOP100 results from the search engines. Keywords data API is built to check search volume and other data for keywords.",
                                            "table": null
                                        }
                                    ]
                                },
                                {
                                    "type": "people_also_ask_element",
                                    "title": "Is Google API free?",
                                    "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[2]/g-accordion-expander[1]",
                                    "expanded_element": [
                                        {
                                            "type": "people_also_ask_expanded_element",
                                            "featured_title": null,
                                            "url": "https://serpstack.com/",
                                            "domain": "serpstack.com",
                                            "title": "serpstack - Free, Real-Time Google Search API",
                                            "description": "Real-Time & Accurate. Google Search Results API Start using the API — It's free ! Our powerful cloud infrastructure is built to withstand high volume API requests without the need of a queue.",
                                            "table": null
                                        }
                                    ]
                                },
                                {
                                    "type": "people_also_ask_element",
                                    "title": "Is scraping Google legal?",
                                    "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[3]/g-accordion-expander[1]",
                                    "expanded_element": [
                                        {
                                            "type": "people_also_ask_expanded_element",
                                            "featured_title": null,
                                            "url": "https://en.wikipedia.org/wiki/Search_engine_scraping",
                                            "domain": "en.wikipedia.org",
                                            "title": "Search engine scraping - Wikipedia",
                                            "description": "Google does not take legal action against scraping, likely for self-protective reasons. However Google is using a range of defensive methods that makes scraping their results a challenging task. ... Google is automatically rejecting User-Agents that seem to originate from a possible automated bot.",
                                            "table": null
                                        }
                                    ]
                                },
                                {
                                    "type": "people_also_ask_element",
                                    "title": "How do I find my Google API?",
                                    "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[4]/g-accordion-expander[1]",
                                    "expanded_element": [
                                        {
                                            "type": "people_also_ask_expanded_element",
                                            "featured_title": null,
                                            "url": "https://developers.google.com/places/web-service/get-api-key",
                                            "domain": "developers.google.com",
                                            "title": "Get an API Key | Places API | Google Developers",
                                            "description": "To get an API key:\nVisit the Google Cloud Platform Console.\nClick the project drop-down and select or create the project for which you want to add an API key.\nClick the menu button and select APIs & Services > Credentials.\nOn the Credentials page, click Create credentials > API key. ...\nClick Close.",
                                            "table": null
                                        }
                                    ]
                                }
                            ]
                        },
 ...


Second request:
"search_param" : "start=10"
"depth" : 10

Use this combination to get the next 10 results on the second search engine results page.

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "computer",
        "search_param":"start=10",
        "depth": 10
    }
]
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "6.6681 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241518-1535-0139-0000-c30e4bb552f9",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "6.6048 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "computer",
                "search_param": "start=10",
                "depth": 10,
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "computer",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=computer&num=10&start=10&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 13:18:21 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "paid",
                        "related_searches"
                    ],
                    "se_results_count": 8050000000,
                    "items_count": 15,
                    "items": [
                        {
                            "type": "paid",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[1]",
                            "title": "Computers | Save Big On A Great Range | ao.com‎",
                            "domain": "ao.com",
                            "breadcrumb": "www.ao.com/",
                            "url": "https://ao.com/computing",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjxy_uio-rnAhUFymQKHcZpBHEYABACGgJwag"
                            },
                            "description": "Pay With PayPal For A Fast Secure Checkout. Buy Now & Join Over 1 Million Happy Customers! Experience Award Winning Service. Plus, If You Find It Cheaper Elsewhere We’ll Match It. Free Delivery. Price Match Promise. 100 Day Returns. Brands: Apple, HP, Microsoft.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[2]",
                            "title": "Desktop Computer Deals | Low Prices And Wide Range‎",
                            "domain": "www.currys.co.uk",
                            "breadcrumb": "www.currys.co.uk/",
                            "url": "https://www.currys.co.uk/gbuk/computing/desktop-pcs/desktop-pcs/317_3055_30057_xx_ba00010707-bv00308577%7Cbv00308578%7Cbv00308581/xx-criteria.html",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjxy_uio-rnAhUFymQKHcZpBHEYABABGgJwag"
                            },
                            "description": "Free Delivery Or Collect In Store Available. With Intel® Core™ Processors Inside. Unbeatable Prices Online. Over 450 Stores. Price Match Promise. Collect in store in 1hr.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[3]",
                            "title": "Buy The Latest PCs | View Our Latest Offers | JohnLewis.com‎",
                            "domain": "www.johnlewis.com",
                            "breadcrumb": "www.johnlewis.com/Offers/Desktops",
                            "url": "https://www.johnlewis.com/electricals/desktop-pcs-imacs/c9600620002",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjxy_uio-rnAhUFymQKHcZpBHEYABADGgJwag"
                            },
                            "description": "We've lowered hundreds of our prices even further. Shop our range now. Free UK...",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 4,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[4]",
                            "title": "Recycle Your Computers Now | Turing Trust | turingtrust.co.uk‎",
                            "domain": "turingtrust.co.uk",
                            "breadcrumb": "www.turingtrust.co.uk/",
                            "url": "https://turingtrust.co.uk/give-computers/",
                            "highlighted": [
                                "computers"
                            ],
                            "extra": {
                                "ad_aclk": "DChcSEwjxy_uio-rnAhUFymQKHcZpBHEYABAAGgJwag"
                            },
                            "description": "Free recycling & data destruction service. Recycle your old computers to help schools!",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "www.cclonline.com",
                            "title": "CCL Computers: Desktop PCs, Gaming PCs, Laptops, PC ...",
                            "url": "https://www.cclonline.com/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:CXupSAR0nkMJ:https://www.cclonline.com/+&cd=11&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "www.cclonline.com",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "CCL specialise in desktop PC computers, laptops, notebooks, netbooks and PC components including motherboards, hard drives, CPUs, graphics cards and ...",
                            "pre_snippet": null,
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "computers"
                            ],
                            "links": null
                        },
...


Third request:
"search_param" : "start=20"
"depth" : 10

Use this combination to get the next 10 results on the third search engine results page.

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/organic/live/advanced

[
    {
        "language_name": "English (United Kingdom)",
        "location_name": "London,England,United Kingdom",
        "keyword": "serp api",
        "search_param":"start=20",
        "depth": 10
    }
]
Response Sample
{
    "version": "0.1.20200221",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "6.8383 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "02241532-1535-0139-0000-c476a814bb88",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "6.7231 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "language_name": "English (United Kingdom)",
                "location_name": "London,England,United Kingdom",
                "keyword": "serp api",
                "search_param": "start=20",
                "depth": 10,
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "serp api",
                    "type": "organic",
                    "se_domain": "google.co.uk",
                    "location_code": 1006886,
                    "language_code": "en-GB",
                    "check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&start=20&hl=en-GB&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
                    "datetime": "2020-02-24 13:32:23 +00:00",
                    "spell": null,
                    "item_types": [
                        "organic",
                        "paid",
                        "related_searches"
                    ],
                    "se_results_count": 1790000,
                    "items_count": 13,
                    "items": [
                        {
                            "type": "paid",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[1]",
                            "title": "Baidu Search API | Lightning Fast Robust API | serpwow.com‎",
                            "domain": "serpwow.com",
                            "breadcrumb": "www.serpwow.com/",
                            "url": "https://serpwow.com/demo/baidu",
                            "highlighted": [
                                "API"
                            ],
                            "extra": {
                                "ad_aclk": "DChcSEwjr7dW0purnAhWXhZEKHQ9UDusYABAAGgJjZQ"
                            },
                            "description": "Best way to scrape Baidu results in your application! No proxy configuration. JSON output. HTML output. Fast API. 99.9% uptime. Real-time data. Free Trial. Worldwide locations. JSON output. Map results. Local geo-located results. HTML output. Real-Time API.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "paid",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[1]/div[3]/div[1]/div[1]/ol[1]/li[2]",
                            "title": "Best Value SERP API | Scrape Search Results | scaleserp.com‎",
                            "domain": "scaleserp.com",
                            "breadcrumb": "www.scaleserp.com/",
                            "url": "https://scaleserp.com/",
                            "highlighted": null,
                            "extra": {
                                "ad_aclk": "DChcSEwjr7dW0purnAhWXhZEKHQ9UDusYABABGgJjZQ"
                            },
                            "description": "Forget proxies. Real-time or batch results. No rate limit. JSON, CSV, HTML. 99.9% uptime. Generous free tier, plans from just $4 a month. Trusted by 1000's of businesses worldwide. Plans from $4 a month. 125 searches/mo Free Tier. From $0.29/1k searches.",
                            "description_rows": null,
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 1,
                            "rank_absolute": 3,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
                            "domain": "spyserp.com",
                            "title": "API documentation - SpySERP",
                            "url": "https://spyserp.com/api",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:aOAilFPkzJAJ:https://spyserp.com/api+&cd=21&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "spyserp.com › api",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "Open SpySERP API available at the next link: https://spyserp.com/panel/api. If description does not specify the use of “POST”, then the query parameters could ...",
                            "pre_snippet": null,
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "API",
                                "api"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 2,
                            "rank_absolute": 4,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]",
                            "domain": "serpstat.com",
                            "title": "Serpstat API how to",
                            "url": "https://serpstat.com/api/",
                            "cache_url": "https://webcache.googleusercontent.com/search?q=cache:kGWWeRSapgUJ:https://serpstat.com/api/+&cd=22&hl=en&ct=clnk&gl=uk",
                            "breadcrumb": "serpstat.com › api",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "This is where your Big Data analysis begins. You are just three steps away from getting tons of valuable data via Serpstat API: Using Serpstat API for commercial ...",
                            "pre_snippet": null,
                            "extended_snippet": null,
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "API"
                            ],
                            "links": null
                        },
                        {
                            "type": "organic",
                            "rank_group": 3,
                            "rank_absolute": 5,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[8]/div[3]/div[9]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[3]/div[1]",
                            "domain": "www.quora.com",
                            "title": "Is there an API for Google search results? - Quora",
                            "url": "https://www.quora.com/Is-there-an-API-for-Google-search-results",
                            "cache_url": null,
                            "breadcrumb": "www.quora.com › Is-there-an-API-for-Google-search-results",
                            "is_image": false,
                            "is_video": false,
                            "is_featured_snippet": false,
                            "is_malicious": false,
                            "description": "No, if you are looking for an API to access Google index with significant volumes ... Also, using SERP API, you can build a powerful rank tracker tool for keywords ...",
                            "pre_snippet": null,
                            "extended_snippet": "19 answers",
                            "amp_version": false,
                            "rating": null,
                            "highlighted": [
                                "SERP API"
                            ],
                            "links": null
                        },
...

Select the Image Size Option

Google Images has a built-in tool for selecting the image size option in SERP: “large,” “medium,” “icon,” or “default that’s applied by default. You can find it under the “Tools” block right beneath the search bar.

Our Google SERP Images API supports URL parameters that will help you emulate this and get data for images of a certain size. To do that, include one of the following code snippets in the “search_param” field of your POST request:

  • Large: tbs=isz:l
  • Medium: tbs=isz:m
  • Icon: tbs=isz:i

select image size

Request Sample

POST: https://api.dataforseo.com/v3/serp/google/images/live/advanced

[
    {
        "language_code": "en",
        "location_code": "200803",
        "keyword": "select image size google",
        "search_param": "tbs=isz:l"
    }
]
Response Sample
{
    "version": "0.1.20201117",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "5.1169 sec.",
    "cost": 0.003,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "12011758-1535-0139-0000-7d7e674258bc",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "5.0366 sec.",
            "cost": 0.003,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "images",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "images",
                "language_code": "en",
                "location_code": "200803",
                "keyword": "select image size google",
                "search_param": "tbs=isz:l",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "select image size google",
                    "type": "images",
                    "se_domain": "google.com",
                    "location_code": 200803,
                    "language_code": "en",
                    "check_url": "https://www.google.com/search?q=select%20image%20size%20google&tbm=isch&&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&tbs=isz%3Al&uule=w+CAIQIFISCYvE6t3wa8SAEVVzQj1RKv8_",
                    "datetime": "2020-12-01 15:58:14 +00:00",
                    "spell": null,
                    "item_types": [
                        "images_search"
                    ],
                    "se_results_count": 0,
                    "items_count": 98,
                    "items": [
                        {
                            "type": "images_search",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "xpath": null,
                            "title": "How to get back 'exact size' and ...",
                            "sub_title": "androidpolice.com",
                            "alt": "How to get back 'exact size' and 'larger than' search filters on Google  Images",
                            "url": "https://www.androidpolice.com/2020/04/13/get-back-exact-size-larger-than-face-photo-full-color-search-filter-google-images/",
                            "source_url": "https://www.androidpolice.com/wp-content/uploads/2019/08/google-image-search-larger-advanced-1.png",
                            "encoded_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ1VfnXTA6xxJQsROtDXD5NUcwKdZ83JZeoOQ&usqp=CAU"
                        },
                        {
                            "type": "images_search",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "xpath": null,
                            "title": "How to get back 'exact size' and ...",
                            "sub_title": "androidpolice.com",
                            "alt": "How to get back 'exact size' and 'larger than' search filters on Google  Images",
                            "url": "https://www.androidpolice.com/2020/04/13/get-back-exact-size-larger-than-face-photo-full-color-search-filter-google-images/",
                            "source_url": "https://www.androidpolice.com/wp-content/uploads/2019/08/google-image-search-exact-size-url-1.png",
                            "encoded_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT4B9rUE72Z6EPp7orzIpf4ulveZxkYMFEc_Q&usqp=CAU"
                        },
                        {
                            "type": "images_search",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "xpath": null,
                            "title": "How to get back 'exact size' and ...",
                            "sub_title": "androidpolice.com",
                            "alt": "How to get back 'exact size' and 'larger than' search filters on Google  Images",
                            "url": "https://www.androidpolice.com/2020/04/13/get-back-exact-size-larger-than-face-photo-full-color-search-filter-google-images/",
                            "source_url": "https://www.androidpolice.com/wp-content/uploads/2019/08/google-image-search-advanced-extension-1.png",
                            "encoded_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR2-sHOGZavwrA2LZcY3tsucSki3mGbnQ1cxA&usqp=CAU"
                        },
                        {
                            "type": "images_search",
                            "rank_group": 4,
                            "rank_absolute": 4,
                            "xpath": null,
                            "title": "How to get back 'exact size' and ...",
                            "sub_title": "androidpolice.com",
                            "alt": "How to get back 'exact size' and 'larger than' search filters on Google  Images",
                            "url": "https://www.androidpolice.com/2020/04/13/get-back-exact-size-larger-than-face-photo-full-color-search-filter-google-images/",
                            "source_url": "https://www.androidpolice.com/wp-content/uploads/2019/08/google-image-search-exact-size-operator.png",
                            "encoded_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSCzg53VaI1cgpFJMxVQ5rRefcUroklpusnQg&usqp=CAU"
                        },
                        {
                            "type": "images_search",
                            "rank_group": 5,
                            "rank_absolute": 5,
                            "xpath": null,
                            "title": "How to get back 'exact size' and ...",
                            "sub_title": "androidpolice.com",
                            "alt": "How to get back 'exact size' and 'larger than' search filters on Google  Images",
                            "url": "https://www.androidpolice.com/2020/04/13/get-back-exact-size-larger-than-face-photo-full-color-search-filter-google-images/",
                            "source_url": "https://www.androidpolice.com/wp-content/uploads/2019/08/google-image-search-missing.png",
                            "encoded_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRfPvkfFFdJqB6UF6OK3HIPO1nzufBBvafHOg&usqp=CAU"
                        },
...

Give It A Go

The examples we listed above represent only a fraction of the parameters you can use for customising the outcomes of SERP API. If you can think of any other advanced search parameters that are worth including in this article – please let us know by dropping a line to our support team.

George Svash

George is the Director of Content Marketing at DataForSEO, an API suite designed to help SEO software companies and agencies gather the SEO data they need for their projects. George is a tech and marketing geek with a deep passion for Big Data and SEO. Having a broad experience in content marketing and a degree in engineering, he is particularly good at explaining complex concepts.

No Comments

Sorry, the comment form is closed at this time.

Embed DataForSeo widget on your website


Embed code:
Preview: