Site icon DataForSEO

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
num
start
safe=active
search query
search language
search location
search region
index time frame
search filter
results number
first result index
safe search on
to turn it off: safe=images

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:


Past hour

Parameter: tbs=qdr:h

Use it to get files indexed in the past hour.

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.

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.

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.

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.

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.

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

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.

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.

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:

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.

Exit mobile version