Skip to content

justserpapi/justserpapi-python

Repository files navigation

JustSerpAPI Logo

JustSerpAPI Python SDK

PyPI version Python Versions Documentation License

The most reliable and high-performance SERP API for Google Search, Maps, News, Shopping, and more.


🌐 Quick Links


🚀 Overview

JustSerpAPI provides a comprehensive suite of tools to scrape and parse search engine results in real-time. This Python SDK allows you to integrate Google Search, Maps, Images, News, Shopping, and AI-powered overviews directly into your Python applications with full type safety and high performance.

Key Features

  • Full Google Coverage: Search, Maps, News, Shopping, Finance, Images, and Patents.
  • AI-Powered: Access Google AI Overviews and AI Search modes.
  • Easy Integration: Built-in authentication, automatic retries, and clean models.
  • Type Safety: Full PEP 484 type hints support for a great developer experience.

🛠 Installation

Install the package via pip:

pip install justserpapi

📖 Getting Started

To start using the SDK, you need an API Key. You can get one from the User Dashboard.

Simple Search Example

import justserpapi
from justserpapi.api.google_api_api import GoogleAPIApi
from pprint import pprint

# Configure the SDK
configuration = justserpapi.Configuration(
    host="https://api.justserpapi.com"
)
configuration.api_key['ApiKeyAuth'] = 'YOUR_API_KEY_HERE'

# Initialize the API client
with justserpapi.ApiClient(configuration) as api_client:
    # Create an instance of the Google API
    api_instance = GoogleAPIApi(api_client)
    
    try:
        # Search for "coffee shops in New York"
        response = api_instance.search(
            query="coffee shops in New York",
            location="New York,NY",
            language="en"
        )
        pprint(response)
    except justserpapi.ApiException as e:
        print(f"Exception when calling API: {e}")

🍱 Supported APIs

Service Method Description
Google Search search() Core Google search results (Organic, Ads, etc.)
Google Maps maps_search() Local business listings and place details
Google AI ai_overview() Extract AI-generated summaries from Google
Google Images images_search() High-quality image search results
Google News news_search() Real-time news results
Google Shopping shopping_search() Comprehensive product and price data

Check out the Full Documentation for a complete list of endpoints and parameters.


🛡️ Authentication

The API uses an API Key passed in the X-API-Key header. In the SDK, this is managed via the Configuration object:

configuration.api_key['ApiKeyAuth'] = 'YOUR_API_KEY'

⚖️ License

Distributed under the MIT License. See LICENSE for more information.


Proudly maintained by the JustSerpAPI Team.

About

Python SDK for JustSerpAPI Google APIs: Google Search, News, Images, Videos, Maps, Trends, Scholar, Finance, Hotels, Shopping, Jobs, Lens, Patents, Autocomplete, AI Overview, AI Mode, Local, Shorts, and more — ideal for SERP data extraction, SEO, monitoring, and automation.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors