What Are Search Engine 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 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 safe search ( off , moderate , strict ) |
Yahoo | p vl vc |
search query search language search country |
q hl gl uule tbs start safe=active |
search query search language search location search region index time frame search filter 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:
- 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 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&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&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&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&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&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&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 }, ...
Select the Image Size Option
Google Images has a built-in tool for selecting the image size option in SERP: “large,” “medium,” “icon,” or “default that’s applied by default. You can find it under the “Tools” block right beneath the search bar.
Our Google SERP Images API supports URL parameters that will help you emulate this and get data for images of a certain size. To do that, include one of the following code snippets in the “search_param” field of your POST request:
- Large:
tbs=isz:l
- Medium:
tbs=isz:m
- Icon:
tbs=isz:i
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.