pangolinfo-serp 0.2.0

Pangolinfo SERP API SDK - AI Overview SERP and keyword trends data for e-commerce intelligence.

pangolinfo-serp

Pangolinfo SERP API SDK — AI Overview SERP and keyword trends data for e-commerce intelligence.

Built and maintained by PANGOLIN INFO TECH PTE. LTD.

Installation

pip install pangolinfo-serp

Quick start

from pangolinfo_serp import SerpClient

client = SerpClient(token="your_bearer_token")

# AI Overview for a Google search URL
result = client.ai_overview("https://www.google.com/search?q=how+java+work")
print(result["json"])

# Keyword trends comparison
trends = client.keyword_trends(["shoe", "hat"])
print(trends["json"])

Authentication

Grab a free API key from tool.pangolinfo.com, then pass it as the token argument. It is sent as a Bearer token on every request.

client = SerpClient(token="YOUR_TOKEN")

Methods

ai_overview(url, screenshot=False)

Scrapes a Google search result page and returns the AI Overview, organic results, related searches and references.

• url (str, required) — Target Google search URL, e.g. "https://www.google.com/search?q=how+java+work".
• screenshot (bool, optional) — Capture a screenshot of the page.

Posts to POST https://scrapeapi.pangolinfo.com/api/v2/scrape with parserName="googleSearch".

Returns the data object:

{
  "json": {
    "ai_overview": "...",
    "organic": ["..."],
    "related_searches": ["..."],
    "references": ["..."]
  },
  "screenshot": "https://...",
  "taskId": "abc123",
  "url": "https://www.google.com/search?q=..."
}

Example:

with SerpClient(token="TOKEN") as client:
    data = client.ai_overview(
        "https://www.google.com/search?q=best+running+shoes",
        screenshot=True,
    )
    ai = data["json"].get("ai_overview")
    screenshot_url = data.get("screenshot")

keyword_trends(keywords, time_range="today 12-m", region="US", language="en-US")

Returns Google Trends comparison data for one or more keywords.

• keywords (str | list[str], required) — A single keyword or a list of keywords, e.g. "shoe" or ["shoe", "hat"].
• time_range (str, optional) — Time range, e.g. "today 12-m" (default), "today 3-m", "today 1-m".
• region (str, optional) — Region code, e.g. "US" (default), "GB".
• language (str, optional) — Language, e.g. "en-US" (default).

Posts to POST https://scrapeapi.pangolinfo.com/api/v1/google/trends.

Returns the data object:

{
  "json": {
    "keywordsGeoData": {"..."},
    "keywordsRankData": {"..."},
    "timelineData": ["..."],
    "geoMapData": {"..."}
  },
  "taskId": "abc123",
  "url": "https://trends.google.com/..."
}

Example:

with SerpClient(token="TOKEN") as client:
    data = client.keyword_trends(
        ["shoe", "hat"],
        time_range="today 3-m",
        region="US",
        language="en-US",
    )
    timeline = data["json"]["timelineData"]

Configuration

SerpClient accepts optional configuration:

client = SerpClient(
    token="YOUR_TOKEN",
    base_url="https://scrapeapi.pangolinfo.com",  # default
    timeout=120,  # seconds, AI Overview can take 30s+
)

Use it as a context manager to ensure the underlying HTTP connection is closed:

with SerpClient(token="TOKEN") as client:
    ...

Errors

All errors derive from pangolinfo_serp.SerpError:

Exception	When
AuthenticationError	HTTP 401 / 403 — bad or missing token.
APIError	API returns code != 0 or an HTTP error.
TimeoutError	Request times out.

from pangolinfo_serp import SerpClient, APIError, AuthenticationError

try:
    client.ai_overview("https://www.google.com/search?q=java")
except AuthenticationError:
    print("check your token")
except APIError as exc:
    print(f"API error code={exc.code}: {exc}")

Links

• Product page: pangolinfo.com/ai-overview-serp-api
• Documentation: docs.pangolinfo.com
• Get a free API key: tool.pangolinfo.com
• Source code: github.com/Pangolin-spg/pangolinfo-serp

License

MIT — © PANGOLIN INFO TECH PTE. LTD.