SerpAPI Fixture-First Local Development

Overview

Separate deterministic parsing from live search acquisition so everyday development is fast, private, and allowance-free.

Prerequisites

• A target engine, parameter contract, parser behavior, and repository test framework
• One approved sanitized response per important schema variant
• A policy for fixture review, retention, refresh, and sensitive-field removal

Tool Discipline

Use Read, Glob, and Grep to locate clients, parsers, fixtures, and tests, WebFetch to re-check engine schemas, Write or Edit for adapters and fixtures, and Bash(python3:*) or Bash(npm:*) for local tests or an explicitly approved recorder.

Current Contract

SerpAPI response sections vary by engine, query, geography, device, and upstream search layout. The official Python result is a SerpResults mapping; application code should depend on a narrow local adapter rather than a captured response being universal.