SerpAPI Production Readiness Review
Overview
Fail closed on missing evidence and distinguish deterministic fixture confidence from the separately approved live canary.
Prerequisites
- Immutable release reference, service owner, deployment plan, rollback target, and decision deadline
- Current SerpAPI documentation and Account API capacity evidence
- Test, security, privacy, reliability, cost, and operational receipts
Tool Discipline
Use Read, Glob, and Grep to verify repository and deployment evidence, WebFetch to re-check current vendor contracts, and Write or Edit only for the readiness record and redacted remediation evidence.
Current Contract
Search behavior varies by engine and optional result sections; 429 can mean throughput or allowance exhaustion; standard records have documented retention while ZeroTrace changes storage and debugging behavior. Production readiness therefore depends on the selected engine, account, data class, and gateway—not a generic SDK smoke test.
Authentication
Require server-side SERPAPI_KEY, an approved secret lifecycle, authenticated gateway callers, and proof that credentials and key-bearing URLs are absent from artifacts, logs, fixtures, and client bundles.
Instructions
- Pin the release SHA and verify dependency, schema, formatting, lint, unit, fixture, integration, security, and deployment gates.
- Confirm engine-specific parameter allowlists, normalized optional schemas, bounded pagination, timeouts, and retry classifications.
- Verify secret isolation, caller authorization, abuse controls, redaction, data purpose, cache/log retention, and ZeroTrace decision.
- Compare forecast demand and concurrency with current Account API searches left and hourly throughput; reserve incident headroom.
- Prove metrics, alerts, runbooks, support escalation, search-ID correlation, incident response, key rotation, and rollback.
- Run preview failure paths and an explicitly approved one-search canary; reconcile result status, latency, and capacity.
- Record PASS, CONDITIONAL, or FAIL with evidence per control, named exceptions, expiry dates, approvers, and rollback trigger.
Approval Boundaries
This review does not grant deployment, secret, plan, retention, or live-search authority. Every mutation follows the owning system's approval process.
Output
Return the pinned release, control matrix, evidence links, live-canary receipt, capacity snapshot, exceptions and expiries, decision, approvers, and rollback trigger.
Error Handling
| Condition | Response |
|---|---|
| Required evidence is stale or missing | Mark the control failed; do not infer readiness. |
| Canary cannot run safely | Record the limitation and keep the launch blocked or explicitly conditional. |
| Capacity has insufficient headroom | Reduce demand or obtain an approved account change before launch. |
| Rollback is untested | Fail production readiness. |
Example
release=sha256:...; deterministic_gates=pass; secret_flow=pass; capacity=headroom-confirmed; canary=pass; rollback=pass; decision=PASS; approvals=recorded
Resources
Next Steps
Attach the signed decision to the release and schedule review of every time-bounded exception.