Google Google Search Data Catalogue — Historical Snapshot

Skip to main content

Google Search Help

Sign in

Send feedback on...

This help content & information

General Help Center experience

Next

• Help Center
• Community
• Improve your Google Account

Google Search

Get started with Search Researcher Result (SRR) API

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 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 Search Researcher Result API (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

1. Sign in to the Google Account that was used to request access to the Search Researcher Result API.
2. To begin, you must be approved to use the Search Researcher Result API and have received an email with the Project ID.
3. Go to https://console.cloud.google.com.
4. If displayed, accept the Google Cloud Console Terms of Services.
5. At the top left, click Select a project.
6. To create a new project:
   1. At the top right of the pop-up window, click NEW PROJECT.
   2. Enter a name for the project.
   3. Select the location you want to place the project.
   4. At the bottom right, click Create.
7. To select an existing project:
   1. To find the project you want to open, use the search bar or navigate the folder.
   2. Click the project that you want.
   3. At the bottom right, click Open.

Step 2: Set up the Search Researcher Result API

1. In a new tab, go to https://console.cloud.google.com/apis/library/searchresearcherresults.googleapis.com.
2. To turn on the Search Researcher Result API, click Enable.

Step 3: Authorize the Search Researcher Result API

1. In a new tab, go to https://developers.google.com/oauthplayground.
2. In the section “Step 1 Select & Authorize APIs,”enter this string in the text field: “https://www.googleapis.com/auth/searchresearcherresults.researcherProject.readonly”.
3. At the bottom right, click Authorize APIs.
4. In the screen that displays, click Allow.
5. Click Exchange authorization code for tokens.

Step 4: Send an API request

1. From the application approval email you received, copy your Project ID.
2. In the section “Step 3 Configure request to API,” set the parameters:
3. HTTP Method = POST Request
4. Request URI = "https://searchresearcherresults.googleapis.com/v1/researcherprojects/{ADD YOUR PROJECT ID HERE}:runQuery"
5. Click Enter request body and enter your query parameters “Request Body,” with the format "query": "/search?q={ADD YOUR QUERY HERE}".
   Tip: For more information on how to format queries, go to How to format queries.
6. Click Send the Request.
7. In the left panel, check your result:
8. If the request is successful, the result begins with “HTTP/ 1.1 200 OK”.
9. If the request is unsuccessful, the result begins with “HTTP/ 1.1 403 FORBIDDEN”. Make sure you’re signed in with the same Google Account that was used to request access to the Search Researcher Result API.

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

The API expects one input field named query. The query field value must include the path of the search page you want to use. For example, If you want to search “Google” use the value /search?q=google to create the query https://www.google.com/search?q=google.

You can access the API with a curl request like this:

curl -H "Content-type: application/json" \

-H "Authorization: Bearer {OAuth Credential}" \

-d '{"query": "/search?q=google"}' -X POST \

https://searchresearcherresults.googleapis.com/v1/researcherprojects/1234:runQuery

• Replace {OAuth Credential} with an OAuth token.
• Replace the number 1234 with your Project ID.

If your query is successful, you’ll find a response like this in the htmlContent field:

{

"htmlContent": "\u003c!doctype html\u003e\u003chtml itemscope=\"\"itemtype=\"http://schema.org/SearchResultsPage\"

..."

}

Request parameter examples

Most requests that a browser makes to www.google.com with a path of /search? are supported with the same parameters that a browser issues through HTTP.

Common parameters include:

• &q= Query to execute a search for
• &gl= Specify a country or region
• &hl= Specify a language
• &start= Specify results past page one
• &tbm= Specify a search mode:
• Supported values are isch, vid,``bks, nws

About the format of query results

• The SRR API returns a response in the htmlContent field. The HTML in the SRR response is the same as a request that originates from a browser. If you want to render the response in a browser, Chrome browser is the most compatible.

• When the response is rendered in a browser, some content that may be included in the response doesn’t display on the page. The content that doesn’t display in the browser includes external Javascript and some images.

• You can extract the content you want to use from either the HTML result or the page rendered in the browser.

Tip: Although SRR API requests are authenticated with your Google Account, your account information isn’t used to generate the HTML of the returned results page. The results page reflects a signed-out experience.

Give feedback about this article

Choose a section to give feedback on

Was this helpful?

How can we improve it?

YesNo

Submit

Need more help?

Try these next steps:

Post to the help community Get answers from community members

true

Help

• 1 of 22

Make contributions on Google Search
- 2 of 22

Manage calculator, unit converter & color codes
- 3 of 22

Follow & compare securities
- 4 of 22

Refine Google searches
- 5 of 22

Save links, images & more
- 6 of 22

Create an alert
- 7 of 22

Accessibility in Google Search
- 8 of 22

Discover food ordering with Google
- 9 of 22

Search for TV shows & movies on Google
- 10 of 22

Suggest edits to a place in search results
- 11 of 22

Find out what song plays near you
- 12 of 22

Open translated pages on Search
- 13 of 22

Find books on Google
- 14 of 22

Manage your collections & saved items
- 15 of 22

Use Results Language Filter for Google Search
- 16 of 22

Search Researcher Result API
- 17 of 22

Search Researcher Program
- 18 of 22

Use AI-powered Google Finance in Search
- 19 of 22

Use Google Lens while watching a YouTube Short
- 20 of 22

Create a new Search profile
- 21 of 22

Claim an existing Search profile
- 22 of 22

Manage your Search profile

©2026 Google

• Privacy Policy
• Terms of Service

Language català‎dansk‎Deutsch‎eesti‎español‎español (Latinoamérica)‎euskara‎Filipino‎français‎Gaeilge‎galego‎hrvatski‎Indonesia‎italiano‎latviešu‎lietuvių‎magyar‎Malti‎Melayu‎Nederlands‎norsk‎polski‎português (Brasil)‎română‎slovenčina‎slovenščina‎suomi‎svenska‎Tiếng Việt‎Türkçe‎íslenska‎čeština‎Ελληνικά‎български‎русский‎српски‎українська‎‏עברית‏اردو‏العربية‏فارسیमराठी‎हिन्दी‎বাংলা‎ગુજરાતી‎தமிழ்‎తెలుగు‎ಕನ್ನಡ‎മലയാളം‎ไทย‎中文（简体）‎中文（繁體）‎日本語‎한국어‎English‎

English‎

1. català‎
2. dansk‎
3. Deutsch‎
4. eesti‎
5. español‎
6. español (Latinoamérica)‎
7. euskara‎
8. Filipino‎
9. français‎
10. Gaeilge‎
11. galego‎
12. hrvatski‎
13. Indonesia‎
14. italiano‎
15. latviešu‎
16. lietuvių‎
17. magyar‎
18. Malti‎
19. Melayu‎
20. Nederlands‎
21. norsk‎
22. polski‎
23. português (Brasil)‎
24. română‎
25. slovenčina‎
26. slovenščina‎
27. suomi‎
28. svenska‎
29. Tiếng Việt‎
30. Türkçe‎
31. íslenska‎
32. čeština‎
33. Ελληνικά‎
34. български‎
35. русский‎
36. српски‎
37. українська‎
38. ‏עברית
39. ‏اردو
40. ‏العربية
41. ‏فارسی
42. मराठी‎
43. हिन्दी‎
44. বাংলা‎
45. ગુજરાતી‎
46. தமிழ்‎
47. తెలుగు‎
48. ಕನ್ನಡ‎
49. മലയാളം‎
50. ไทย‎
51. 中文（简体）‎
52. 中文（繁體）‎
53. 日本語‎
54. 한국어‎
55. English‎

Enable Dark Mode

Send feedback on...

This help content & information General Help Center experience

Search

Clear search

Close search

Main menu

Google apps

[ID_REDACTED]

true

Search Help Center

false

true

true

true

Google Help

- Help Center- Community- Google Search

- Privacy Policy- Terms of Service- Submit feedback

true

true

100334

false

false

What is the issue with this selection?

What is the issue with this selection?

Inaccurate - doesn't match what I see in the product

Hard to understand - unclear or translation is wrong

Missing info - relevant but not comprehensive

Irrelevant - doesn’t match the title and / or my expectations

Minor errors - formatting issues, typos, and / or broken links

Other suggestions - ideas to improve the content

Share additional info or suggestions

​

​

Do not share any personal info

Cancel

Submit

By continuing, you agree Google uses your answers, account & system info to improve services, per our Privacy & Terms.

false

false

false