google-search-results

What it is and what it does

This package wraps the SerpApi service, a backend that scrapes and parses search results from multiple search engines and e-commerce platforms. You instantiate a search class, pass your query parameters and API key, and receive standardized JSON results. The package handles HTTP request formatting, response parsing, and result conversion into Python dictionaries, JSON, or objects.

The main value is abstraction: SerpApi handles the fragile work of parsing HTML from different engines, so you get consistent structured data without maintaining scrapers yourself. You pay for API calls rather than managing infrastructure, and the package supports location-specific searches, pagination, batch async queries, and access to search archives and account information.

Use it for:

• Retrieve localized search results from Google or other engines for market research without building custom scrapers.
• Build a price-comparison tool by querying eBay or Home Depot results programmatically.
• Aggregate search results across multiple engines using consistent class interfaces.
• Archive and retrieve historical search results using the Search Archive API for trend analysis.
• Implement batch asynchronous searches to gather large volumes of search data efficiently.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client for querying search results from Google, Bing, Baidu, Yandex, Yahoo, eBay, Home Depot, and other services via the SerpApi backend, which handles parsing and standardization.

Yes, if you need multi-engine search result parsing and can afford SerpApi's pricing. The package is actively maintained, has no external dependencies, and abstracts away HTML parsing complexity. No, if you need free scraping or cannot rely on a third-party API service. The high install friction (mandatory API key and backend service) and inactive release cycle (last update 2023-03-10) are trade-offs for convenience.

Install

google-search-results on PyPI

pip install google-search-results

uv add google-search-results

poetry add google-search-results

Installing google-search-results

Before you install

High install friction: the package has no runtime dependencies but requires an active SerpApi API key to function. Maintenance is active with recent commits (last commit 2026-02-20), though the latest release was 2023-03-10.

License in practice

MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install google-search-results

from google_search_results import GoogleSearch
search = GoogleSearch({
    "q": "coffee",
    "location": "Austin,Texas",
    "api_key": "your_api_key"
})
result = search.get_dict()

Requires a SerpApi API key and an active internet connection to query the SerpApi backend service.

Verify before relying

• Current stability and feature completeness relative to SerpApi's latest API changes since 2023-03-10.
• Rate limits and pricing implications of the SerpApi backend service itself.
• Whether the package supports Python 3.5 and 3.6 in practice despite classifier declarations.

Package facts

Evidence: google_search_results-2.4.2.tar.gz

Keywords: scrape, serp, api, json, search, localized, rank, google, bing, baidu, yandex, yahoo, ebay, scale, datamining, training, machine, ml, youtube, naver, walmart, apple, store, app

Tags

More Utilities packages