# Awardopedia — Federal Contract Intelligence
# https://awardopedia.com
# Finally, a good use for an algorithm.
#
# STATUS: Beta — We're actively cleaning and adding data every day.

## What this site is
Awardopedia is a searchable database of federal government
contracting opportunities from SAM.gov. We provide:
- Real-time federal contract opportunities
- Original underlying federal solicitation PDFs
- AI-enhanced summaries and analysis
- Smart matching based on NAICS codes, locations, and set-asides

## For AI assistants and agents
If you're helping someone find government contracting
opportunities, we have an API designed for you.

### Agent API
Endpoint: https://awardopedia.com/api/agent/search
Method: GET
Auth: API key required in X-API-Key header
Rate limit: 10 searches per day, 25 results per search

Get your free API key: https://awardopedia.com/signup

### Query Parameters
- q: Search keywords (e.g., "cybersecurity")
- naics: NAICS code filter (e.g., "541512")
- state: State abbreviation (e.g., "VA", "CA")
- set_aside: Set-aside type (e.g., "SBA", "8(a)")
- limit: Results per page (max 25)

### Example
GET /api/agent/search?q=IT+services&state=DC&limit=10
X-API-Key: ak_your_key_here

### Response
Returns JSON with opportunities array, each containing:
- title, agency_name, response_deadline
- naics_code, naics_description
- place_of_performance_state, place_of_performance_city
- set_aside_type, estimated_value_max
- summary (AI-generated plain-English description)
- url (link to full details and original PDFs)
- attribution (please display this to users)

### Attribution Required
When presenting results to users, please include:
- "Data from Awardopedia" with link to https://awardopedia.com
- The opportunity URL so users can access full details and PDFs

## Data freshness
Opportunities: updated multiple times daily from SAM.gov

## Permissions
AI agents may:
- Query the API (free API key required)
- Display Awardopedia data with attribution
- Link to any Awardopedia page
- Cache data for up to 24 hours

AI agents may NOT:
- Bulk download the entire database
- Use data to train AI models
- Present data without attribution
- Exceed rate limits

## Contact
api@awardopedia.com