What are Google Search Parameters and How to Use Them With SERP API?


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 Google search parameters can provide plentiful opportunities to SEO geeks and SEO software developers alike.

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

Below you’ll find a complete set of Google search parameters you can use to customise your requests to the SERP API.

Content

Specify a time frame

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

Parameter: &tbs=qdr:x

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

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

Past hour

Parameter: &tbs=qdr:h

Use it to get files indexed in the past hour.


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"rank checker",
					"se_param_add":"&tbs=qdr:h",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.3062 sec.",
    "results_count": 41,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231490291,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:35:38 +00:00",
                "result_position": 1,
                "result_url": "https://wiwibloggs.com/",
                "result_title": "Eurovision News, Polls, Predictions and Rankings — with attitude ...",
                "result_snippet_extra": "",
                "result_snippet": "44 mins ago - Eurovision News, Polls, Predictions and Rankings — with attitude!",
                "results_count": 41,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Ah&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231490291,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:35:38 +00:00",
                "result_position": 2,
                "result_url": "https://www.thestreet.com/",
                "result_title": "TheStreet: Stock Market - Business News, Market Data, Stock Analysis",
                "result_snippet_extra": "",
                "result_snippet": "33 mins ago - How to Position Your Portfolio for Retirement, According to Jim Cramer ... Elon Musk Attorney: 'SEC's Position Is Wrong at Virtually Every Level'. Attorneys for ...",
                "results_count": 41,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Ah&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
...

 


Past 24 hours

Parameter: &tbs=qdr:d

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


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"rank checker",
					"se_param_add":"&tbs=qdr:d",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1056 sec.",
    "results_count": 101,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231510568,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:42:35 +00:00",
                "result_position": 1,
                "result_url": "https://ahrefs.com/tr/big-data",
                "result_title": "SEO Profesyonellerine Büyük Veri'yi Getirmek - Ahrefs",
                "result_snippet_extra": "",
                "result_snippet": "1 day ago - We use backlink data to calculate our proprietary metrics: Ahrefs Rank, Domain Rating and URL Rating. Domains ... Check out their numbers. Share · Tweet ...",
                "results_count": 12900,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Ad&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231510568,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:42:35 +00:00",
                "result_position": 2,
                "result_url": "https://za.pinterest.com/pin/452471093812331003/",
                "result_title": "Free Keyword Rank Checker – Check Your Website Ranking For Free ...",
                "result_snippet_extra": "",
                "result_snippet": "4 hours ago - How to check your google ranking free keyword checker #Bloggingtips #SEO, how to Submit URL To Google, How To Add Your Blog To Google #BlogTips Free ...",
                "results_count": 12900,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Ad&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
...

 

Past week

Parameter: &tbs=qdr:w

Use it to get files indexed during the past week.


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"rank checker",
					"se_param_add":"&tbs=qdr:w",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.0950 sec.",
    "results_count": 102,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231520476,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:46:58 +00:00",
                "result_position": 1,
                "result_url": "https://www.georanker.com/",
                "result_title": "Local SEO Tools, Local Citation Finder and Local Rank Checker ...",
                "result_snippet_extra": "",
                "result_snippet": "6 days ago - Over 150 Countries & 50000+ CITIES, 100% accurate Real-Time Local SERP Rankings Reports, Citation Source Finder, Local SEO Competition Analysis ...",
                "results_count": 32600,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Aw&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231520476,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:46:58 +00:00",
                "result_position": 2,
                "result_url": "https://smallseotools.com/website-checker/",
                "result_title": "Website Checker - Analyse Sites with this Free Tool Online",
                "result_snippet_extra": "",
                "result_snippet": "3 days ago - Improve Your Rankings! Register now on Semrush and find out more details about your website and track your competitors, How and from where they are ...",
                "results_count": 32600,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Aw&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
...

 

Past month

Parameter: &tbs=qdr:m

Use it to get files indexed in the past month.


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"rank checker",
					"se_param_add":"&tbs=qdr:m",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1263 sec.",
    "results_count": 100,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231524397,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:50:03 +00:00",
                "result_position": 1,
                "result_url": "https://www.serprobot.com/",
                "result_title": "Free SERP checker - google ranking check | serprobot.com",
                "result_snippet_extra": "",
                "result_snippet": "15 Mar 2019 - Free SERP check, track and monitor your search engine keyword ranking quickly and accurately.",
                "results_count": 65900,
                "result_extra": "people_also_ask,videos",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Am&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231524397,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:50:03 +00:00",
                "result_position": 2,
                "result_url": "https://myrankaware.com/",
                "result_title": "Accurate Keyword Rank Checker for Google, Yahoo, Bing. FREE Trial",
                "result_snippet_extra": "",
                "result_snippet": "12 Mar 2019 - Accurate keyword rank checker software to track SERP position of your website on search engine Google, Bing, and Yahoo. Must-have SEO tool, FREE Trial.",
                "results_count": 65900,
                "result_extra": "people_also_ask,videos",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Am&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231524397,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:50:03 +00:00",
                "result_position": 3,
                "result_url": "https://thecontentworks.uk/google-rankings-check/",
                "result_title": "Google Rankings Check - Best free website rank checker tools + our ...",
                "result_snippet_extra": "",
                "result_snippet": "9 Mar 2019 - It's easy to check where your website ranks in search engines like Google. There are free online rank checker tools and paid-for rankings checkers which give ...",
                "results_count": 65900,
                "result_extra": "people_also_ask,videos",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Am&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
...

 

Past 11 months

Parameter: &tbs=qdr:m11

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


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"rank checker",
					"se_param_add":"&tbs=qdr:m11",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1198 sec.",
    "results_count": 100,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231767627,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 12:09:22 +00:00",
                "result_position": 1,
                "result_url": "https://ahrefs.com/keyword-rank-checker",
                "result_title": "Keyword Rank Checker By Ahrefs: Track Your Keyword Rankings",
                "result_snippet_extra": "",
                "result_snippet": "26 Dec 2018 - 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.",
                "results_count": 465000,
                "result_extra": "videos,people_also_ask",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Am11&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231767627,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 12:09:22 +00:00",
                "result_position": 2,
                "result_url": "https://smallseotools.com/keyword-position/",
                "result_title": "Keyword Rank Checker - A Free online Google keyword position ...",
                "result_snippet_extra": "",
                "result_snippet": "30 Sep 2018 - To check the keyword rank in Google ranking, use our free Keyword Position Checker. Just enter the domain name, keywords and search engine and click the ...",
                "results_count": 465000,
                "result_extra": "videos,people_also_ask",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Am11&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231767627,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 12:09:22 +00:00",
                "result_position": 3,
                "result_url": "https://www.serprobot.com/",
                "result_title": "Free SERP checker - google ranking check | serprobot.com",
                "result_snippet_extra": "",
                "result_snippet": "3 hours ago - Free SERP check, track and monitor your search engine keyword ranking quickly and accurately.",
                "results_count": 465000,
                "result_extra": "videos,people_also_ask",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Am11&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
...

 

Past year

Parameter: &tbs=qdr:y

Use it to get files indexed in the past year.


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"rank checker",
					"se_param_add":"&tbs=qdr:y",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.2195 sec.",
    "results_count": 99,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231549706,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:53:08 +00:00",
                "result_position": 1,
                "result_url": "https://ahrefs.com/keyword-rank-checker",
                "result_title": "Keyword Rank Checker By Ahrefs: Track Your Keyword Rankings",
                "result_snippet_extra": "",
                "result_snippet": "26 Dec 2018 - 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.",
                "results_count": 564000,
                "result_extra": "videos,people_also_ask",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Ay&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231549706,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 496329,
                "post_key": "rank checker",
                "result_datetime": "2019-03-25 09:53:08 +00:00",
                "result_position": 2,
                "result_url": "https://smallseotools.com/keyword-position/",
                "result_title": "Keyword Rank Checker - A Free online Google keyword position ...",
                "result_snippet_extra": "",
                "result_snippet": "30 Sep 2018 - To check the keyword rank in Google ranking, use our free Keyword Position Checker. Just enter the domain name, keywords and search engine and click the ...",
                "results_count": 564000,
                "result_extra": "videos,people_also_ask",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=rank%20checker&num=100&tbs=qdr%3Ay&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
…

 

Specify a category

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

Parameter: tbm=x

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

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

Books

Parameter: tbm=bks

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


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"computer",
					"se_param_add":"tbm=bks",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.0759 sec.",
    "results_count": 100,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231850074,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 68626,
                "post_key": "computer",
                "result_datetime": "2019-03-25 13:05:19 +00:00",
                "result_position": 1,
                "result_url": "https://books.google.co.uk/books?id=HbFrQgAACAAJ&dq=computer&hl=en&sa=X&ved=0ahUKEwjtsdPXrZ3hAhVOMqwKHf0MBsEQ6AEIKDAA",
                "result_title": "The Computer Book: An Introduction to Computers and Computing",
                "result_snippet_extra": "Robin Bradbeer, \u200ePeter De Bono, \u200ePeter Laurie - 1982 - \u200eNo preview",
                "result_snippet": "",
                "results_count": 96900000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=computer&num=100&tbm=bks&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231850074,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 68626,
                "post_key": "computer",
                "result_datetime": "2019-03-25 13:05:19 +00:00",
                "result_position": 2,
                "result_url": "https://books.google.co.uk/books?id=THie6tt-2z8C&printsec=frontcover&dq=computer&hl=en&sa=X&ved=0ahUKEwjtsdPXrZ3hAhVOMqwKHf0MBsEQ6AEILjAB",
                "result_title": "The Elements of Computing Systems: Building a Modern Computer from ...",
                "result_snippet_extra": "Noam Nisan, \u200eShimon Schocken - 2005 - \u200ePreview - \u200eMore editions",
                "result_snippet": "The emerging computer system can be built by following the chapters, although this is only one option, since the projects are self-contained and can be done or skipped in any order.",
                "results_count": 96900000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=computer&num=100&tbm=bks&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
...

 

News

Parameter: tbm=nws

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


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"brexit",
					"se_param_add":"tbm=nws",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1232 sec.",
    "results_count": 100,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231857355,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 3295796,
                "post_key": "brexit",
                "result_datetime": "2019-03-25 13:10:42 +00:00",
                "result_position": 1,
                "result_url": "https://www.independent.co.uk/news/uk/politics/brexit-no-deal-eu-planning-theresa-may-commons-vote-a8838476.html",
                "result_title": "Brexit: EU says it has completed its no-deal preparations",
                "result_snippet_extra": "",
                "result_snippet": "",
                "results_count": 235000000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=brexit&num=100&tbm=nws&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231857355,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 3295796,
                "post_key": "brexit",
                "result_datetime": "2019-03-25 13:10:42 +00:00",
                "result_position": 2,
                "result_url": "https://www.telegraph.co.uk/politics/2019/03/25/brexit-latest-news-theresa-may-meet-cabinet-amid-pressure-leadership/",
                "result_title": "Brexit latest news: Theresa May expected to hold third vote on deal ...",
                "result_snippet_extra": "",
                "result_snippet": "",
                "results_count": 235000000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=brexit&num=100&tbm=nws&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231857355,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 3295796,
                "post_key": "brexit",
                "result_datetime": "2019-03-25 13:10:42 +00:00",
                "result_position": 3,
                "result_url": "https://www.independent.co.uk/news/uk/politics/brexit-vote-today-theresa-may-deal-letwin-amendment-explained-a8838321.html",
                "result_title": "Brexit: Which amendments are MPs voting on today?",
                "result_snippet_extra": "",
                "result_snippet": "",
                "results_count": 235000000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=brexit&num=100&tbm=nws&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },

...

 

Videos

Parameter: tbm=vid

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


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"computer",
					"se_param_add":"tbm=vid",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1369 sec.",
    "results_count": 100,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231869996,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 68626,
                "post_key": "computer",
                "result_datetime": "2019-03-25 13:19:01 +00:00",
                "result_position": 1,
                "result_url": "https://www.khanacademy.org/computing/computer-science/how-computers-work2/v/khan-academy-and-codeorg-what-makes-a-computer-a-computer",
                "result_title": "What Makes a Computer, a Computer? (video) | Khan Academy",
                "result_snippet_extra": "1 Mar 2018 - Uploaded by Khan Academy Partners",
                "result_snippet": "Inventor and designer May-Li Khoe and virtual reality designer Nat Brown introduce the four features that all ...",
                "results_count": 2430000000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=computer&num=100&tbm=vid&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231869996,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 68626,
                "post_key": "computer",
                "result_datetime": "2019-03-25 13:19:01 +00:00",
                "result_position": 2,
                "result_url": "https://www.khanacademy.org/computing/computer-science/how-computers-work2/v/khan-academy-and-codeorg-introducing-how-computers-work",
                "result_title": "Introducing How Computers Work (video) | Khan Academy",
                "result_snippet_extra": "16 Jan 2018 - Uploaded by Khan Academy Partners",
                "result_snippet": "Microsoft founder Bill Gates gives a quick overview of the entire How Computers Work series.",
                "results_count": 2430000000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=computer&num=100&tbm=vid&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231869996,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 68626,
                "post_key": "computer",
                "result_datetime": "2019-03-25 13:19:01 +00:00",
                "result_position": 3,
                "result_url": "https://kano.me/store/uk/products/computer-kit",
                "result_title": "Computer Kit | Make a computer, learn to code - Kano",
                "result_snippet_extra": "14 Sep 2018 - Uploaded by Kano Computing",
                "result_snippet": "Build your own computer, learn to code with 100+ creative challenges, make your own art, music and games ...",
                "results_count": 2430000000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=computer&num=100&tbm=vid&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
…

 

Patents

Parameter: tbm=pts

Use it to get patent results related to your query.


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"computer",
					"se_param_add":"tbm=pts",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1646 sec.",
    "results_count": 100,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231885192,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 68626,
                "post_key": "computer",
                "result_datetime": "2019-03-25 13:38:52 +00:00",
                "result_position": 1,
                "result_url": "https://www.google.co.uk/patents/US6195708?dq=computer&hl=en&sa=X&ved=0ahUKEwjksPKYtZ3hAhVR8HMBHQZlBz0Q6AEIJzAA",
                "result_title": "Computer system where giving and receiving a data between programs ...",
                "result_snippet_extra": "Grant - \u200eFiled 30 Sep 1997 - \u200e Issued 27 Feb 2001 - \u200eMasahiko Sugimoto - \u200eFujitsu Limited",
                "result_snippet": "A computer system which operates by means of a plurality of programs and which controls the giving and receiving of data between programs in memory, the ...",
                "results_count": 5320000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=computer&num=100&tbm=pts&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4231885192,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 68626,
                "post_key": "computer",
                "result_datetime": "2019-03-25 13:38:52 +00:00",
                "result_position": 2,
                "result_url": "https://www.google.co.uk/patents/US3627995?dq=computer&hl=en&sa=X&ved=0ahUKEwjksPKYtZ3hAhVR8HMBHQZlBz0Q6AEILjAB",
                "result_title": "Computer system event counter",
                "result_snippet_extra": "Grant - \u200eFiled 19 Jan 1970 - \u200e Issued 14 Dec 1971 - \u200eCharles D Warner Jr - \u200eComputer Synectics Inc",
                "result_snippet": "An electronic systems event counter network for counting the number of times a computing system event occurs by monitoring a system signal line. The network ...",
                "results_count": 5320000,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=computer&num=100&tbm=pts&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
          …      

 

Specify the number of results on the 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 Google SERP with ten results on each page.

  • Parameter: &start=x

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

  • Integer: “se_deep”:y

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

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

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

First request: “se_deep”:10

Use it to get the first 10 results of SERPs.


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"key":"serp api",
					"se_deep": 10,
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1586 sec.",
    "results_count": 16,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4234333357,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 1783359,
                "post_key": "serp api",
                "result_datetime": "2019-03-26 09:46:39 +00:00",
                "result_position": 1,
                "result_url": "https://serpapi.com/",
                "result_title": "SerpApi: Google Search Results API",
                "result_snippet_extra": "",
                "result_snippet": "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 ...",
                "results_count": 962000,
                "result_extra": "related_search",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
...
                       {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4234333357,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 1783359,
                "post_key": "serp api",
                "result_datetime": "2019-03-26 09:46:39 +00:00",
                "result_position": 10,
                "result_url": "https://www.quora.com/Is-Google-intentionally-trying-to-kill-rank-checking-SERP-lookup-by-closing-their-Web-API-What-other-sources-are-there-for-grabbing-SERP-data-Do-SEOs-have-a-gameplan-for-when-the-Google-API-gets-shut-down",
                "result_title": "Is Google intentionally trying to kill rank checking (SERP lookup ...",
                "result_snippet_extra": "",
                "result_snippet": "6 Aug 2017 - I believe rank checking is grossly overrated and largely a waste of time. Particularly given the increasingly personalized (and localized) nature of search results, ...",
                "results_count": 962000,
                "result_extra": "related_search",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            }
 ...

 

Second request:
"se_param_add" : "start=10"
"se_deep" : 10

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


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"se_param_add":"start=10",
					"se_deep": 10,
					"key":"serp api",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1012 sec.",
    "results_count": 12,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4234351877,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 1783359,
                "post_key": "serp api",
                "result_datetime": "2019-03-26 09:55:35 +00:00",
                "result_position": 1,
                "result_url": "http://serpcloud.com/serp/developer",
                "result_title": "Developer API - Rank Tracker Service | SERP Checker | SEO Software",
                "result_snippet_extra": "",
                "result_snippet": "The SERP Cloud API facilitates the user to access and control the data (Categories, Keywords, Projects, SEO stats and Social stats) based on URL commands.",
                "results_count": 2,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&start=10&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
…
        {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4234351877,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 1783359,
                "post_key": "serp api",
                "result_datetime": "2019-03-26 09:55:35 +00:00",
                "result_position": 10,
                "result_url": "https://serpmetrics.com/",
                "result_title": "SERPmetrics: Search Engine Rank Tracking API",
                "result_snippet_extra": "",
                "result_snippet": "Hassle free SERP ranking data. SERPmetrics is a robust search engine rank monitoring platform with a full featured API built specifically for SEO agencies, tool ...",
                "results_count": 2,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&start=10&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            }
        ],
...

 

Third request:
"se_param_add" : "start=20"
"se_deep" : 10

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


Request Sample

{
	"data":
		{
			"here is supposed to be your post ID 1":
				{
					"se_name":"google.co.uk",
					"se_language":"English",
					"loc_name_canonical":"London,England,United Kingdom",
					"se_param_add":"start=20",
					"se_deep": 10,
					"key":"serp api",
					"priority": 2
				}
				
		}
}

Response Sample

{
    "status": "ok",
    "results_time": "0.1423 sec.",
    "results_count": 14,
    "results": {
        "organic": [
            {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4234396017,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 1783359,
                "post_key": "serp api",
                "result_datetime": "2019-03-26 10:19:46 +00:00",
                "result_position": 1,
                "result_url": "https://stackoverflow.com/questions/4584191/api-script-to-determine-a-websites-serp",
                "result_title": "API/Script to determine a website's SERP? - Stack Overflow",
                "result_snippet_extra": "4 answers",
                "result_snippet": "Recently Google changed HTML structure of SERP pages, so old scraping scripts do not work. I rewrote my old SERP script to address new changes, please ...",
                "results_count": 3,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&start=20&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            },
…
           {
                "post_id": "here is supposed to be your post ID 1",
                "task_id": 4234396017,
                "se_id": 22,
                "loc_id": 1006886,
                "key_id": 1783359,
                "post_key": "serp api",
                "result_datetime": "2019-03-26 10:19:46 +00:00",
                "result_position": 10,
                "result_url": "https://serpbook.com/",
                "result_title": "SerpBook - Rank Tracker Providing Real Time Data",
                "result_snippet_extra": "",
                "result_snippet": "SERP Tracking since 2011. Founded in late 2011, SerpBook rank tracker was ... Read the Founder's Story. Navigate. Help Center · Developers / API · Affiliates.",
                "results_count": 3,
                "result_extra": "",
                "result_stat": [],
                "result_spell": "",
                "result_spell_type": "",
                "result_se_check_url": "https://www.google.co.uk/search?q=serp%20api&num=10&start=20&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS"
            }
        ],
...

 

Give it a go

The examples we listed above represent only a fraction of parameters you can use for customising the outcomes of SERP API. If there are any other advanced Google Search Parameters you think are worth including in this article – please let us know by dropping a comment below. We’ll do our best to keep it up to date.

In the meantime, give a go to SERP API. You’d be surprised how many opportunities it can provide to your project. And the best part is you can test it for free.
Get free SERP API credits

No Comments

Post a Comment