typicalninjagoogle-sr
Modern JavaScript / TypeScript tools for fetching and parsing Google search results
Features
- No API key needed
- First-class TypeScript support
- Works in Node.js, Bun, and Deno
- Modular result parsers
Install
Not supported in browser environments.
npm install google-sr
# Or with pnpm/yarn or https://bun.sh
pnpm add google-sr
yarn add google-sr
bun add google-sr
# we also provide builds on https://jsr.io/@typical/google-sr/
npx jsr add @typical/google-sr
CommonJS / ESM Notice
Currently this package provides both CommonJS (CJS) and ES Modules (ESM) builds.
Starting in version 7.x (subject to change), we plan to publish ESM-only releases and remove the CJS build.
As a result, you will no longer be able to use require() to import this package; you must use import instead.
(If you’re on Node.js v20 or later, you can still use require() with ESM modules natively. See release note)
Note: This only affects Node.js users. Runtimes like Bun and Deno already support ESM natively.
See this gist and our GitHub discussion for migration help.
Usage
google-sr is modular, use only the parsers relevant to your search. Here’s a simple example:
import { search, OrganicResult, TranslateResult, ResultTypes } from "google-sr";
const results = await search({
query: "translate hello to japanese",
parsers: [TranslateResult, OrganicResult],
});
console.log(results[0].type === ResultTypes.TranslateResult); // true
console.log(results);
Output Example
[
{
type: 'TRANSLATE',
sourceLanguage: 'English (detected)',
translationLanguage: 'Japanese',
sourceText: 'hello',
translatedText: 'こんにちは'
},
{
type: 'ORGANIC',
link: '...',
description: "Konnichiwa – ...",
title: '18 ...'
}
]
More examples available at: apps/examples
Links
Tests
Tests use vitest. Run:
pnpm run test
Disclaimer
This project is not sponsored, endorsed, or affiliated with Google in any way.
This repository is provided "as is" without warranty of any kind and is intended solely for educational and research purposes. The authors and contributors assume no responsibility for any issues, damages, or losses that may arise from its use.
By using this project, you acknowledge that you are solely responsible for complying with applicable laws and platform Terms of Service. Use at your own discretion and risk.
License
This repository and the code inside it is licensed under the Apache-2.0 License. Read LICENSE for more information.