talordata-serp 0.1.0

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

For development and publishing helpers:

pip install -e ".[dev]"

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 /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.
• Boolean params are normalized to "1" and "0" to match common form API expectations.

Build And Publish

Build distributions locally:

python -m build

Check the generated artifacts:

python -m twine check dist/*

Upload to PyPI:

python -m twine upload dist/*