IdeaCredIdeaCred

justserpapi/justserpapi-python

43

Python SDK for JustSerpAPI Google APIs: Google Search, News, Images, Videos, Maps, Trends, Scholar, Finance, Hotels, Shopping, Jobs, Lens, Patents, Autocomplete, AI Overview, AI Mode, Local, Shorts, and more — ideal for SERP data extraction, SEO, monitoring, and automation.

What's novel

Python SDK for JustSerpAPI Google APIs: Google Search, News, Images, Videos, Maps, Trends, Scholar, Finance, Hotels, Shopping, Jobs, Lens, Patents, Autocomplete, AI Overview, AI Mode, Local, Shorts, and more — ideal for SERP data extraction, SEO, monitoring, and automation.

Code Analysis

13 files read · 3 rounds

A Python SDK for JustSerpAPI that wraps an OpenAPI-generated HTTP client with a clean, namespaced high-level Client class for calling Google SERP endpoints (search, maps, news, images, shopping, etc.)

Strengths

Clean three-layer architecture (high-level Client → generated API → transport) with a well-designed namespaced API surface, comprehensive exception hierarchy, and a substantial CI/CD tooling script (sdkctl.py) for SDK generation and validation. The high-level Client is genuinely user-friendly with context manager support, sensible defaults, and intuitive resource grouping.

Weaknesses

The Pydantic response models in responses.py are defined but never integrated into the Client — all methods return plain dicts, making the typed models dead code. Tests are limited to mock-based unit tests with no integration coverage, no edge-case testing (malformed responses, empty data, concurrent usage), and no async support despite being a modern SDK.

Score Breakdown

Innovation
3 (25%)
Craft
45 (35%)
Traction
4 (15%)
Scope
39 (25%)

Signal breakdown

Innovation

Not Fork+1
Code Novelty+0
Concept Novelty+0

Craft

Ci+5
Tests+3
Polish+1
Releases+0
Has License+5
Code Quality+21
Readme Quality+15
Recent Activity+7
Structure Quality+5
Commit Consistency+2
Has Dependency Mgmt+5

Traction

Forks+0
Stars+6
Hn Points+0
Watchers+0
Early Traction+0
Devto Reactions+0
Community Contribs+0

Scope

Commits+8
Languages+5
Subsystems+5
Bloat Penalty+0
Completeness+7
Contributors+5
Authored Files+8
Readme Code Match+3
Architecture Depth+5
Implementation Depth+8

Evidence

Commits

633

Contributors

1

Files

26

Active weeks

3

TestsCI/CDREADMELicenseContributing

Repository

Language

Python

Stars

2

Forks

0

License

MIT