serpapi-sdk-patterns

# SerpApi SDK Patterns ## Overview Production patterns for SerpApi: typed result interfaces, response caching (critical since each search costs credits), multi-engine abstraction, and async search with the Searches Archive API. ## Instructions ### Step 1: Typed Result Interfaces ```typescript interface SerpApiOrganicResult { position: number; title: string; link: string; snippet: string; displayed_link: string; source?: string; } interface SerpApiSearchResult { search_metadata: { id: string; status: string; created_at: string }; search_parameters: Record<string, string>; organic_results: SerpApiOrganicResult[]; answer_box?: { answer?: string; snippet?: string; title?: string }; knowledge_graph?: { title: string; description?: string; type?: string }; related_questions?: Array<{ question: string; snippet: string }>; pagination?: { next: string }; } ``` ### Step 2: Cached Search Client ```typescript import { getJson } from 'serpapi'; import { LRUCache } from 'lru-cache'; const cache = new LRUCache<string, SerpApiSearchResult>({ max: 500, ttl: 3600_000, // 1 hour -- search results are relatively stable }); async function cachedSearch(params: Record<string, any>): Promise<SerpApiSearchResult> { const key = JSON.stringify(params); const cached = cache.get(key); if (cached) return cached; const result = await getJson({ ...params, api_key: process.env.SERPAPI_API_KEY, }) as SerpApiSearchResult; cache.set(key, result); r...