justserpapi 1.0.2

Professional Python SDK for JustSerpAPI

JustSerpAPI Python SDK

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

---

🌐 Quick Links

• Official Website: justserpapi.com
• API Documentation: docs.justserpapi.com
• User Dashboard: user.justserpapi.com
• Support: [e-mail]

---

🚀 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.