{ "openapi": "3.1.0", "info": { "title": "GovSpendPulse API", "description": "Global government procurement intelligence API. 9 endpoints covering US federal contracts (USASpending.gov), active solicitations (SAM.gov), EU tenders (TED), UK contracts, global development bank opportunities (World Bank/ADB/AfDB/UNGM), agency spending profiles, competitor award analysis, and full contract intelligence briefs. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.", "version": "1.0.0", "contact": { "url": "https://govspendpulse.vercel.app" } }, "servers": [{ "url": "https://govspendpulse.vercel.app" }], "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 payment signature. Send a GET request without this header to receive a 402 with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header." } } }, "security": [{ "x402": [] }], "paths": { "/api/govspend/us-contracts": { "get": { "summary": "US federal contract awards", "description": "Search US federal contract awards via USASpending.gov API v2. Returns top awards by amount with recipient, agency, NAICS, period, and vendor market intelligence. No API key required.", "operationId": "usContracts", "parameters": [ { "name": "keyword", "in": "query", "description": "Search term — e.g. cybersecurity, cloud computing, management consulting", "schema": { "type": "string" } }, { "name": "naics", "in": "query", "description": "NAICS code — e.g. 541512 (computer systems design)", "schema": { "type": "string" } }, { "name": "state", "in": "query", "description": "Two-letter US state code — e.g. VA, CA, TX", "schema": { "type": "string" } }, { "name": "year_from", "in": "query", "description": "Fiscal year start — e.g. 2024, 2025", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "description": "Number of results (5, 10, or 20)", "schema": { "type": "integer", "default": 10 } }, { "name": "lang", "in": "query", "description": "Response language", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Contract award intelligence" }, "402": { "description": "Payment required — x402 USDC on Base" } }, "x-bazaar": { "price_usd": 0.08, "model": "claude-haiku-4-5-20251001", "data_sources": ["USASpending.gov API v2"], "tags": ["us-contracts", "federal-procurement", "usaspending", "naics", "vendor-intelligence"] } } }, "/api/govspend/us-opportunities": { "get": { "summary": "US active solicitations (SAM.gov)", "description": "Search active US federal contract opportunities from SAM.gov. Returns open solicitations with deadlines, set-aside types, NAICS codes, and bid guidance. Uses public web search — no API key required.", "operationId": "usOpportunities", "parameters": [ { "name": "keyword", "in": "query", "description": "Search term — e.g. software development, janitorial, IT support", "schema": { "type": "string" } }, { "name": "naics", "in": "query", "description": "NAICS code filter", "schema": { "type": "string" } }, { "name": "active", "in": "query", "description": "Only return open solicitations", "schema": { "type": "boolean", "default": true } }, { "name": "limit", "in": "query", "description": "Number of results", "schema": { "type": "integer", "default": 10 } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Active solicitation intelligence" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.08, "model": "claude-haiku-4-5-20251001", "data_sources": ["SAM.gov (public web search)"], "tags": ["sam-gov", "solicitations", "rfp", "set-aside", "small-business", "active-bids"] } } }, "/api/govspend/eu-tenders": { "get": { "summary": "EU procurement tenders (TED)", "description": "Search EU procurement notices from TED (Tenders Electronic Daily) covering all 27 EU member states. Returns contract notices with value, authority, CPV category, and deadline. No API key required.", "operationId": "euTenders", "parameters": [ { "name": "keyword", "in": "query", "description": "Search term — e.g. artificial intelligence, renewable energy, cybersecurity", "schema": { "type": "string" } }, { "name": "country", "in": "query", "description": "ISO 2-letter country code — e.g. DE, FR, PL, NL (blank = all EU)", "schema": { "type": "string" } }, { "name": "cpv", "in": "query", "description": "CPV procurement code — e.g. 72000000 (IT services)", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 10 } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "EU tender intelligence" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.08, "model": "claude-haiku-4-5-20251001", "data_sources": ["EU TED API v3"], "tags": ["eu-tenders", "ted-europa", "european-procurement", "cpv", "b2g-europe"] } } }, "/api/govspend/uk-contracts": { "get": { "summary": "UK government contracts", "description": "Search UK government procurement from Contracts Finder and Find a Tender Service. Returns UK public sector contract awards with department, value, sector, and market snapshot.", "operationId": "ukContracts", "parameters": [ { "name": "keyword", "in": "query", "description": "Search term — e.g. digital transformation, facilities management, cyber", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "UK procurement intelligence" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.08, "model": "claude-haiku-4-5-20251001", "data_sources": ["UK Contracts Finder", "Find a Tender Service"], "tags": ["uk-contracts", "contracts-finder", "nhs", "crown-commercial", "b2g-uk"] } } }, "/api/govspend/global-opportunities": { "get": { "summary": "Global procurement opportunities", "description": "Government procurement intelligence beyond US/EU/UK: Australia (AusTender), Canada (CanadaBuys), Asia-Pacific (ADB), Africa (AfDB), MENA, Latin America, and UN system (UNGM). Multi-source synthesis.", "operationId": "globalOpportunities", "parameters": [ { "name": "keyword", "in": "query", "description": "Sector or service — e.g. water infrastructure, health IT, renewable energy", "schema": { "type": "string" } }, { "name": "regions", "in": "query", "description": "Comma-separated regions: australia, canada, asia, africa, latam, mena, un", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Global procurement intelligence" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.15, "model": "claude-sonnet-4-6", "data_sources": ["AusTender", "CanadaBuys", "ADB", "AfDB", "UNGM"], "tags": ["global-procurement", "austender", "adb", "afdb", "ungm", "multilateral", "b2g-global"] } } }, "/api/govspend/agency-intel": { "get": { "summary": "US agency spending intelligence", "description": "Deep spending profile for any US federal agency. Returns top vendors, NAICS codes, procurement vehicles, IDIQ/GWAC contracts, entry strategy, and budget priorities.", "operationId": "agencyIntel", "parameters": [ { "name": "agency", "in": "query", "required": true, "description": "Agency name or abbreviation — e.g. DHS, VA, HHS, DoD, NASA, GSA", "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "Optional focus area — e.g. cybersecurity, cloud, healthcare IT", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Agency intelligence brief" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.15, "model": "claude-sonnet-4-6", "data_sources": ["USASpending.gov", "web synthesis"], "tags": ["agency-intel", "federal-agency", "idiq", "gwac", "procurement-strategy", "b2g-strategy"] } } }, "/api/govspend/competitor-awards": { "get": { "summary": "Competitor federal award analysis", "description": "Who is winning federal contracts in your market space. Returns top vendors by total awards, market concentration analysis, opportunity gaps, and set-aside landscape. Replaces a $5,000 market intelligence report.", "operationId": "competitorAwards", "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Market keyword — e.g. cybersecurity, cloud computing, logistics", "schema": { "type": "string" } }, { "name": "naics", "in": "query", "description": "NAICS code to narrow results", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Competitive landscape intelligence" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.15, "model": "claude-sonnet-4-6", "data_sources": ["USASpending.gov API v2"], "tags": ["competitor-intelligence", "market-share", "federal-awards", "incumbent-analysis", "b2g-competitive"] } } }, "/api/govspend/development-bank": { "get": { "summary": "Development bank procurement", "description": "International development bank procurement opportunities: World Bank, ADB, AfDB, and UN system (UNGM). Includes vendor registration guide for each institution. Covers $200B+ in annual multilateral procurement.", "operationId": "developmentBank", "parameters": [ { "name": "keyword", "in": "query", "description": "Sector or service — e.g. health systems, road construction, education technology", "schema": { "type": "string" } }, { "name": "country", "in": "query", "description": "Borrower country — e.g. Nigeria, Bangladesh, Indonesia", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Development bank procurement intelligence" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.15, "model": "claude-sonnet-4-6", "data_sources": ["World Bank Projects API", "ADB", "AfDB", "UNGM"], "tags": ["world-bank", "adb", "afdb", "ungm", "multilateral-procurement", "international-development"] } } }, "/api/govspend/contract-brief": { "get": { "summary": "Full contract intelligence brief", "description": "Comprehensive intelligence brief on any specific federal contract opportunity. Covers historical awards, incumbent analysis, requirements intelligence, competitive landscape, and bid/no-bid recommendation with win strategy. Replaces a $10,000 BD consulting engagement.", "operationId": "contractBrief", "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Contract title, topic, or solicitation number — e.g. 'DHS zero trust SOC' or 'N0017824R0012'", "schema": { "type": "string" } }, { "name": "agency", "in": "query", "description": "Agency to narrow search — e.g. DHS, Air Force, VA", "schema": { "type": "string" } }, { "name": "naics", "in": "query", "description": "NAICS code", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Contract intelligence brief" }, "402": { "description": "Payment required" } }, "x-bazaar": { "price_usd": 0.20, "model": "claude-sonnet-4-6", "data_sources": ["USASpending.gov", "SAM.gov", "web synthesis"], "tags": ["contract-brief", "bid-intelligence", "capture-management", "bid-no-bid", "win-strategy", "incumbent-analysis"] } } }, "/openapi.json": { "get": { "summary": "OpenAPI specification", "description": "Returns this OpenAPI specification. Free endpoint — no payment required.", "operationId": "getOpenApiSpec", "security": [], "responses": { "200": { "description": "OpenAPI JSON spec" } } } } } }