{"openapi":"3.1.0","info":{"title":"Patent Index API","version":"1.0.0","description":"CPC G06N (machine learning) patent snapshot: semantic search, landscape stats, new filings, downloads. Snapshot built 2026-10-09, publications 2025-10-01 to 2026-10-09, sourced from Google Patents with per-document CPC verification.","contact":{"name":"Richardson Dackam","url":"https://x.com/richardsondx"}},"servers":[{"url":"https://patents.nshipyard.com"}],"paths":{"/api/stats":{"get":{"summary":"Landscape aggregates","responses":{"200":{"description":"Filings per month, top assignees, CPC subgroups, top inventors"}}}},"/api/search":{"post":{"summary":"Semantic patent search (top 20 with similarity scores)","description":"Requires sign-in. Free tier: 10 searches/month. Premium: unlimited.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"}},"required":["q"]}}}},"responses":{"200":{"description":"Ranked results"},"401":{"description":"Sign-in required"},"402":{"description":"Free quota exhausted"},"503":{"description":"OpenAI key not configured"}}}},"/api/patent/{pubnum}":{"get":{"summary":"Patent detail","parameters":[{"name":"pubnum","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Bibliographic record"},"404":{"description":"Not in snapshot"}}}},"/api/weekly":{"get":{"summary":"New this week","responses":{"200":{"description":"Last-7-days filings grouped by assignee"}}}},"/api/download":{"get":{"summary":"Download the snapshot","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Full normalized dataset"}}}}}}