talordata-serp 0.1.2

A Python SDK for TalorData SERP API.

TalorData Python SDK

A lightweight Python SDK for the TalorData SERP API, inspired by the developer experience of serpapi-python.

Repository: Talordata/talordata-serp-python

Install

pip install talordata-serp

Quick Start

import os

from talordata_serp import Client

client = Client(api_token=os.getenv("TALORDATA_API_TOKEN"))

results = client.search(
    engine="google",
    q="pizza",
)

print(results["search_metadata"]["status"])
print(results["search_information"]["query_displayed"])

You can also set the token once in your shell:

export TALORDATA_API_TOKEN=your_token

Then use the top-level helper:

import talordata_serp

results = talordata_serp.search(q="pizza", engine="google")
print(results)

Examples

Runnable examples are included in the examples/ directory:

• examples/basic_search.py
• examples/search_with_url.py
• examples/html_output.py

Run one with:

python examples/basic_search.py

API Design

• Client(api_token=...): create a reusable client.
• client.search(...): send a form-encoded POST request to /serp/v1/request and parse JSON automatically.
• client.search_json(...): same as search(), but always returns a plain dict.
• client.search_html(...): return raw HTML/text output.
• talordata_serp.search(...): convenience helper for one-off requests.

Example With URL

The official docs also show url-based requests. The SDK supports that directly:

from talordata_serp import Client

client = Client(api_token="your_token")

results = client.search(
    url="https://www.google.com/search",
    q="pizza",
    json=1,
)

print(results.as_dict())

Notes

• Auth uses the Authorization: Bearer <token> header.
• Requests are sent as application/x-www-form-urlencoded.
• The SDK targets the serp/v1/request endpoint, where json=1 returns parsed JSON data, json=2 returns both html and json, and json=3 returns HTML.
• json=1 is the default mode used by client.search(...).
• Boolean params are normalized to "1" and "0" to match common form API expectations.