OpenAPI-driven Python SDK for JustSerpAPI with a stable high-level Client as the public entrypoint.
The documentation center helps you browse endpoint health, versioned API paths, request parameters, and SERP-specific usage notes.
The console provides API key management, subscription status, credit visibility, request logs, usage trends, and credit consumption analytics.
pip install justserpapifrom justserpapi import Client
with Client(api_key="YOUR_API_KEY") as client:
response = client.google.search(
query="coffee shops in New York",
location="New York, NY",
language="en",
)
print(response)
print(response["data"])The high-level surface is generated from OpenAPI and designed to be the default entrypoint:
from justserpapi import Client
client = Client(api_key="YOUR_API_KEY", timeout=20.0)
search = client.google.search(query="best espresso beans", language="en")
light = client.google.search.light(query="best espresso beans", language="en")
maps = client.google.maps.search(query="espresso bars", location="Shanghai")
news = client.google.news.search(query="OpenAI", language="en")
images = client.google.images.search(query="espresso machine")
shopping = client.google.shopping.search(query="espresso tamper")
finance = client.google.finance.search(query="NASDAQ:GOOGL")
scholar = client.google.scholar.search(query="machine learning", language="en")
overview = client.google.ai.overview(url="https://example.com/ai-overview")
print(search["data"])
client.close()High-level responses are plain Python dictionaries that mirror the API's JSON response envelope. The SDK does not auto-unpack data.
The public client exposes the common knobs directly:
from justserpapi import Client
from urllib3.util.retry import Retry
client = Client(
api_key="YOUR_API_KEY",
base_url="https://api.justserpapi.com",
timeout=(5.0, 30.0),
retries=Retry(total=5, backoff_factor=0.5),
)
client.close()api_key: value sent in theX-API-Keyheaderbase_url: API host, defaults tohttps://api.justserpapi.comtimeout: default request timeout injected into high-level methodsretries:urllib3retry configuration; defaults to a conservative retry strategy for the high-level client
The API list below is generated from OpenAPI and shows the current public API categories and endpoint names. See the online API documentation for full request and response details.
Distributed under the MIT License. See LICENSE for more information.