# GoveBid

> Government tender intelligence API. Aggregates live procurement opportunities from SAM.gov (US federal), TED Europa (EU), UNGM (UN), World Bank, AfDB (African Development Bank), and USA Spending. Designed for AI agents and procurement intelligence platforms.

GoveBid exposes both a REST API and a Model Context Protocol (MCP) endpoint so AI agents can discover live RFPs and bidding opportunities without writing bespoke scrapers per portal.

## API

- [OpenAPI Specification](https://govebid.com/api/v1/openapi.json): Full machine-readable contract.
- [Interactive Docs](https://govebid.com/api/v1/docs): Swagger UI with try-it-now.
- [MCP Endpoint](https://govebid.com/api/v1/mcp): Streamable HTTP transport for AI agents.

## Discovery

- [Agent Card](https://govebid.com/.well-known/agent.json): A2A protocol descriptor with skills.
- [MCP Manifest](https://govebid.com/.well-known/mcp.json): MCP server descriptor with tools.
- [AI Plugin Manifest](https://govebid.com/.well-known/ai-plugin.json): ChatGPT plugin descriptor.

## Authentication

- Get a free API key (no signup): `POST https://govebid.com/api/v1/keys/instant` returns a `gb_…` key.
- Pass the key in the `X-API-Key` HTTP header on every request.
- Free tier: 100 calls/month. Paid tiers: 5k / 50k / 1M.

## Core endpoints

- `GET /api/v1/tenders` — filtered tender list (source, country, sector, value_tier, urgency, deadline).
- `POST /api/v1/tenders/search` — free-text search across the catalog.
- `GET /api/v1/tenders/{id}` — single tender detail.
- `GET /api/v1/public/stats` — unauthenticated catalog overview.
- `GET /api/v1/stats` — aggregated statistics (Starter+ tier).
- `GET /api/v1/scrape-logs` — scrape audit trail (Pro+ tier).

## Data sources

- SAM.gov — US federal contract opportunities.
- TED Europa — EU procurement notices (all 27 member states).
- UNGM — United Nations Global Marketplace.
- World Bank — project procurement notices.
- AfDB — African Development Bank tenders.
- USA Spending — US federal awards.

## Refresh cadence

Tender data is re-scraped every 6 hours. Each record includes `source`, `external_url` (link to original portal), `deadline`, `value_usd`, `country`, and `sector` fields.

## Optional

- [Legal Terms](https://govebid.com/#/terms): Terms of service.
- [Privacy Policy](https://govebid.com/#/privacy): Data handling.
- [Support](mailto:admin@govebid.com): Contact for issues or enterprise inquiries.