Documentation • Disclaimer • Mirror

For simple use cases, refer to google-sr

This package provides a set of CSS selectors for parsing Google search results, using tools such as cheerio, etc...

These selectors are compatible only with the search results page returned when the following user-agent is used: Mozilla/5.0 (MSIE 10.0; Windows NT 6.1; Trident/5.0).

Important Considerations:

Google frequently updates their search page structure, which can break these selectors without warning. Unless you have specific requirements that google-sr doesn't meet, we strongly recommend using google-sr instead; it handles selector maintenance and provides a more stable API. Use this package if you:

• Need custom parsing logic beyond what google-sr offers
• Want to integrate selectors into an existing scraping framework
• Require fine-grained control over the parsing process

CommonJS / ESM Notice

Currently this package provides both CommonJS (CJS) and ES Modules (ESM) builds.

Starting in version 3.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.

Links

• API Documentation
• GitHub Repository
• NPM Package
• Discord

Related projects 🥂

• google-sr - Simple tool to programmatically get google search results
• google-that - CLI wrapper around google-sr

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.

Want to support the project? Star it on GitHub ★