# Alabamabids — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and monitor bid opportunities from Alabama Bid Network by date or month, view detailed bid information and results, and browse classified listings all in one place. Stay updated on the latest bids and their outcomes to never miss contracting opportunities in Alabama.

**Category:** Government & Public Data | **Website:** [alabamabids.com/](https://alabamabids.com/) | **Docs:** [parse.bot/marketplace/6f58e834-9f8d-43d7-a5ca-8116afe138fb/alabamabids-com-api](https://parse.bot/marketplace/6f58e834-9f8d-43d7-a5ca-8116afe138fb/alabamabids-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_available_bid_months

Retrieve all available year/month combinations that have bid opportunities listed. Returns a descending chronological list spanning several years of historical data. Each entry includes a direct URL to fetch bids for that month.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_available_bid_months \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_bid_detail

Retrieve details for a single bid solicitation given its full URL. Returns title, scope, added/updated date, and due date when available. The URL is obtained from get_bids_by_date or get_latest_bids results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the bid detail page (from get_bids_by_date or get_latest_bids results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_bid_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_bid_result_detail

Retrieve full details of a single bid result/award given its URL. Includes title, low bidder name, bid amount, opening date, description of the work, and raw page content. The URL is obtained from get_bid_results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the bid result detail page (from get_bid_results results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_bid_result_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_bid_results

Retrieve the list of recent bid results (award announcements) with pagination. Each result includes a summary of the award with the winning bidder and dollar amount, plus a URL for full details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be a positive integer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_bid_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_bids_by_date

Retrieve all bid listings for a specific date. Each bid includes title, scope, bid_id, added/updated date, and detail URL. Dates with no bids return an empty array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `day` | string | Yes | 1 or 2-digit day, zero-padded accepted (e.g. '31'). |
| `month` | string | Yes | 1 or 2-digit month, zero-padded accepted (e.g. '12'). |
| `year` | string | Yes | 4-digit year (e.g. '2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_bids_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"day":"<string>","month":"<string>","year":"<string>"}'
```

### get_bids_by_month

Retrieve the days within a given month and year that have bid opportunities listed. Returns a list of available day entries in descending order. Use the returned day values with get_bids_by_date to fetch actual bid listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | Yes | 1 or 2-digit month, zero-padded accepted (e.g. '04' or '4'). |
| `year` | string | Yes | 4-digit year (e.g. '2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_bids_by_month \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","year":"<string>"}'
```

### get_classified_detail

Retrieve full details of a single classified ad given its URL. Returns title and full page description text. The URL is obtained from get_classifieds results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the classified detail page (from get_classifieds results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_classified_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_classifieds

Retrieve the list of classified ads. The classifieds dataset is small and may contain older listings. Each entry includes title, URL, description snippet, update date, and price when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Optional category filter passed as query parameter to the classifieds page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_classifieds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_latest_bids

Retrieve the latest bid listings from the homepage with pagination support. Returns the most recently posted bid opportunities across all categories. Each page contains up to 20 bids.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be a positive integer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alabamabids-com-api-6f58e834/get_latest_bids \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```