Researchers can now scrape and analyze Search results with the Search Researcher Result API (SRR API). For more information on eligibility criteria, and to apply for access, please visit Google’s Transparency Center.
Learn how to get started with Search Researcher Result (SRR) API.
How SRR API works
- The API takes a URL in a browser then retrieves the HTML we'd return to a browser.
- Some query parameters can’t be accepted and return with an error. If a request includes a non-search URL, an error returns.
- If a request exceeds the number of requests available for the project, an error returns. The request limit is applied on a rolling 24-hours basis.
Tip: You can only use the SRR API for non-commercial purposes, and your use is governed by the Researcher Program AUP and SRR API Terms of Service.
Get started with the SRR API
Important: This API is currently only available for researchers based in the European Union (EU).
Approved researchers can obtain results from Google Search with the Search Researcher Result (SRR) API. To learn more about the Researcher Program, go to the Researcher Program website.
What you need to use the SRR API
To send a request to the SRR API, you need these 3 items:
- A Google Account that’s approved for access
- The Research Product ID that was provided in the application approval email
- A request string of the path page you want to scrape, which begins with “/search?”.
About the SRR API
Approved researchers can send search requests to Google Search and retrieve responses with the Search Researcher Result API (SRR API). The SRR API is an authenticated API that grants each research project a given number of requests per day. The responses returned are nearly the same as a standard HTTP request sent from a browser.
Get started with the SRR API in OAuth Playground
You can verify access and explore send requests with the OAuth Playground. The OAuth tokens and authorization codes from the OAuth Playground are available for a short time, as documented in the tool. While you can continue to refresh the tokens, it’s recommended to write your own application if you plan to use the API for a longer time.
Step 1: Open a project
Step 2: Set up the Search Researcher Result API
Step 3: Authorize the Search Researcher Result API
Step 4: Send an API request
Format queries & interpret results
The SRR API accepts up to 1000 requests a day per project. Once 1000 requests have been sent, the API returns an error. If you send too many requests from your project in a short time, you may also temporarily receive “resource exhaustion” errors.
How to format queries
Request parameter examples
About the format of query results
Search Researcher Program
Search offers academic researchers programmatic access to search results through the Search Researcher Result API (SRR API). This program is intended to facilitate research across a wide range of disciplines.
SRR API
Approved researchers can send search requests to Google Search and retrieve responses with the Search Researcher Result API (SRR API). The SRR API is an authenticated API that grants each research project a given number of requests per day. The responses returned are nearly the same as a standard HTTP request sent from a browser. A small number of third-party features may not be present.
Who can apply
Eligibility criteria for the program includes:
- Be a student, research-focused staff or faculty member affiliated with an accredited, and higher education institution that can grant degrees.
- Have a clear researcher goal, and intend to publish their findings. Research can’t be made available for commercial sale.
- Have no affiliation with Alphabet or Google like not working as an intern, temp, vendor, or consultant.
How to apply
To request access to the SRR API, complete our researcher application https://requestrecords.google.com/researcher/search-form. Each approved project is provided a quota of 1000 queries per day per project.
How the program works
Step 1: Confirm your eligibility. Learn about Eligibility criteria.
Step 2: Submit your application. You can submit your application using the application form link https://requestrecords.google.com/researcher/search-form.
Step 3: Access the API. Learn how to get started with Search Researcher Result SRR API.
Terms & services
To access the API, researchers must agree to the Search-Specific Google Researcher Program Terms of Service.
Secure Sockets Layer search
You get a more secure and private search experience with Secure Sockets Layer (SSL). When you search on Google, you use SSL.
How SSL helps protect your data
SSL encrypts the connection between your computer and Google. This helps prevent others, like Internet cafes, Internet Service Providers, and Wi-Fi hotspots, from seeing your search results page and login information.
Limitations
While SSL helps protect your search results, which may include personal results from Google products like Gmail and Google Calendar, it doesn't provide complete security.
SSL doesn't always hide:
- The fact that you visited google.com
- The search terms you typed
For example, websites you visit from the Google search results page may identify what site you came from or what your search was.
SSL & schools
If SSL interferes with parental controls, monitoring programs, or auditing software at your work or school, learn more about blocking adult content at your school.