serpcheap-django 0.2.0

Django integration for the serp.cheap Google SERP API — app, settings, cached client, management command.

serpcheap-django

Django integration for the serp.cheap Google Search API — real-time Google SERP data (organic results, ads, knowledge graph, page scraping, rank tracking), wrapped as a Django app with settings, cached client, and a management command.

It's the cheapest Google Search API we know of — $0.0003 per cached search, $0.0006 fresh, no monthly minimum (~10× cheaper than SerpApi).

Wraps the serpcheap Python SDK with a Django app, settings-driven config, transparent result caching via Django's cache framework, and a management command.

Install

pip install serpcheap-django

Add the app and configure it in settings.py:

INSTALLED_APPS = [
    # ...
    "serpcheap_django",
]

SERPCHEAP = {
    "API_KEY": os.environ["SERPCHEAP_API_KEY"],  # get one at https://app.serp.cheap
}

Usage

from serpcheap_django import serpcheap

results = serpcheap.search("best running shoes", gl="us")
page = serpcheap.scrape("https://example.com")
rank = serpcheap.rank("example.com", "best running shoes")

Results are cached by default (keyed by query + options) using your default Django cache, so repeat calls don't spend credits. Reach the raw, uncached SDK client when you need it:

from serpcheap_django import get_client

for page in get_client().client.search_pages("best running shoes", to=3):
    ...

Management command

python manage.py serpcheap_search "best running shoes" --gl us --page 1
python manage.py serpcheap_search "best running shoes" --json

Configuration

All keys are optional except API_KEY:

SERPCHEAP = {
    "API_KEY": "...",                       # required
    "BASE_URL": "https://api.serp.cheap",
    "TIMEOUT_MS": 15000,
    "MAX_RETRIES": 2,
    "CACHE": {
        "ENABLED": True,
        "ALIAS": "default",                 # any cache alias from settings.CACHES
        "TTL": 3600,
    },
}

Set CACHE["ENABLED"] = False to disable result caching entirely.

License

MIT