# US BidNet Direct Tenders Scraper | State & Local Bids (`automatic/us-bidnet-tenders-scraper`) Actor

US state, local and federal solicitations from BidNet Direct: title, state, publication and closing dates, agency type and the notice link, with keyword, state, category, open/closed and date filters. A daily new-only feed for bid teams and tender-alert services.

- **URL**: https://apify.com/automatic/us-bidnet-tenders-scraper.md
- **Developed by:** [Philip Kirkbride](https://apify.com/automatic) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 solicitations

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## US BidNet Direct Tenders Scraper

US state, local, member-agency and federal solicitations from BidNet Direct (www.bidnetdirect.com). Get one clean row per bid: solicitation id, title, state, publication and closing dates with their time zone, how many days are left, the pool the bid comes from, and the public page for the notice. Where BidNet Direct publishes them, rows also carry the issuing organisation, the description, the procurement method, the question deadline, the submission and pricing terms, and the buyer's own notice link.

Use it for bid monitoring and alerts: schedule a daily run by keyword, state, category or closing window and send new bids to email, Slack or a spreadsheet.

### Use cases

- Watch every new state or local bid for your keywords, across all 50 states.
- Track bids closing in the next two weeks so nothing is missed.
- Follow one buyer or one purchasing group's new solicitations.
- Feed a tender-alert service or an internal bid pipeline.
- Keep the buyer's own notice link next to each opportunity.

### Also available

The US and international tenders suite: pick the job.

| Actor | Use when |
|---|---|
| **BidNet Direct Tenders (this Actor)** | US state and local bids |
| [SAM.gov Opportunities](https://apify.com/automatic/sam-gov-opportunities-scraper) | US federal RFPs, set-asides and awards |
| [UNGM UN Tenders](https://apify.com/automatic/ungm-tenders-scraper) | UN agency procurement notices |
| [World Bank Tenders](https://apify.com/automatic/worldbank-tenders-scraper) | World Bank-funded bids in 120+ countries |
| [UK Find a Tender](https://apify.com/automatic/uk-procurement-tenders-scraper) | UK tenders, awards and contracts |

### Use it as a daily feed

Turn on **Only new or changed since the last run** (`onlyNewSinceLastRun`) and run the
Actor on a schedule with the same input. It then returns only solicitations this search has
not delivered before, or whose watched fields changed since the last run, so there is
nothing to deduplicate on your side.

- Every returned row carries `changeType` (`new` or `changed`) and `changedFields`.
- The first run has no saved history, so it returns everything and reports
  `feed.firstRun` in the run's OUTPUT.
- The history lives in the named key-value store `us-bidnet-tenders-scraper-feed-state`,
  one record per search. Leave `stateKey` empty to name the record from the input, so
  different searches keep separate histories; set a name to share one or to start over.
- The watched fields are the title, the closing date, the status and the documents.
- An entry leaves the history once its deadline is more than 90 days past and it has not
  been delivered in the last 90 days, so the history stays bounded.

The run still reads up to `maxResults` solicitations to notice changes, so set
`maxResults` to the size of the daily feed you want.

With the flag off (the default) the Actor returns every match, exactly as before.

### What it returns

Every row has `tenderId`, `tenderNumber`, `country`, `category`, `title`, `titleEnglish`, `description`, `buyer`,
`bidType`, `purchasingGroup`, `procurementMethod`, `status`, `publishedAt`, `deadlineAt`,
`deadlineZone`, `questionsDeadline`, `daysLeft`, `state`, `location`, `estimatedValue`,
`currency`, `documents`, `sourceUrl`, `url`, `detailIssue`, `membersOnlyFields`,
`sourceQuery`, `source` and `scrapedAt`. Full notice pages add `projectNumber`,
`bidSubmissionType`, `pricing`, `sourceId` and `buyerLocation`.

- `tenderId` is the solicitation id at the end of its BidNet Direct link.
- `bidType` is `stateAndLocal`, `memberAgency` or `federal`, as BidNet Direct groups bids.
- `publishedAt` and `deadlineAt` are ISO 8601 with the time zone the notice prints
  (`-05:00` etc.) when a time is published, and a date alone when only a date is shown.
  `deadlineZone` repeats the printed label (`EST`, `EDT`, `MST`, `PST`, …).
- `daysLeft` is the days the open list says are left before the deadline.
- `state` is the two-letter code, `location` the state name BidNet Direct prints.
- `documents` holds the buyer's own notice link when the page publishes one, otherwise it
  is null: BidNet Direct keeps its own document downloads and buyer contacts for
  registered members, and this Actor never signs in. `membersOnlyFields` names exactly
  which fields a given page hid.
- Bids listed as closed keep the details BidNet Direct publishes for them, which is
  usually the issuing organisation, the description and the buyer's notice link.
- A federal notice usually carries the agency, the description and the original sam.gov
  link, so you can open the source notice directly.
- Solicitations that come from a buyer's own portal (the full notice layout) also carry
  the reference number, project number, procurement method, question deadline, bid
  submission type and pricing basis.
- Rows are deduplicated on `tenderId`.

### Input

| Field | Type | Default | What it does |
|---|---|---:|---|
| `keyword` | string | `""` | Words matched by BidNet Direct's own search, e.g. `roof replacement`. It matches more than the title, so some rows do not show the word in their title. Up to 200 characters. |
| `state` | string | `any` | Two-letter US state or territory code, e.g. `TX`. |
| `category` | string | `any` | Industry sector, e.g. `Construction`. |
| `agencyType` | string | `any` | `stateAndLocal`, `memberAgency` or `federal`. |
| `status` | string | `open` | `open`, `closed` (the recently published archive) or `any` (the open list first, then the closed one). |
| `publishedFrom`, `publishedTo` | string | `""` | Publication date window, `YYYY-MM-DD`. |
| `deadlineFrom`, `deadlineTo` | string | `""` | Closing date window, `YYYY-MM-DD`. |
| `maxResults` | integer | `20` | Maximum solicitations returned, 1 to 2000. |
| `includeDetails` | boolean | `true` | Read each solicitation's own page. Slower, and the only way to get the closing time, the time zone, the buyer and the description. |
| `onlyNewSinceLastRun` | boolean | `false` | Return only new or changed solicitations since the last run. |
| `stateKey` | string | `""` | Optional name for the saved feed state. |

All filters are optional and combine. An empty input returns the 20 most recently
published open solicitations.

### Example queries

Run with `{}` to get the newest 20 open bids — the Console default.

Roofing bids in Texas:

```json
{"keyword": "roof", "state": "TX", "maxResults": 50}
```

Everything in construction that closes in the next fortnight:

```json
{
  "category": "Construction",
  "deadlineFrom": "2026-11-10",
  "deadlineTo": "2026-11-24",
  "maxResults": 200
}
```

Federal bids only, published this week:

```json
{"agencyType": "federal", "publishedFrom": "2026-11-04", "maxResults": 100}
```

Closed dredging bids from the recent archive:

```json
{"status": "closed", "keyword": "dredging", "maxResults": 25}
```

### Output example

```json
{"source":"www.bidnetdirect.com","country":"US","tenderId":"444226645063","tenderNumber":null,"title":"Critical Repair - 2601 Farnell Dr. - Roof Replacement","titleEnglish":"Critical Repair - 2601 Farnell Dr. - Roof Replacement","description":"Remove existing roofing materials down to bare decking. Check all roof trusses/rafters and repair/replace as needed to ensure that new roof structure is flat and smooth without rises or depressions in roof system.","buyer":"City of Mobile","bidType":"stateAndLocal","purchasingGroup":null,"category":null,"procurementMethod":null,"status":"closed","publishedAt":"2026-11-06T13:11:00-05:00","deadlineAt":"2026-11-10T01:00:00-05:00","deadlineZone":"EST","daysLeft":null,"state":"AL","location":"Alabama","estimatedValue":null,"currency":null,"documents":[{"name":"Original notice","url":"https://www.cityofmobile.gov/bids/?bid=4273","type":"sourceNotice","format":"link","publishedAt":null}],"sourceUrl":"https://www.cityofmobile.gov/bids/?bid=4273","url":"https://www.bidnetdirect.com/alabama/solicitations/closed-bids/statewide/Critical-Repair-2601-Farnell-Dr-Roof-Replacement/444226645063?origin=0&target=view","detailIssue":null,"membersOnlyFields":["tenderNumber"],"sourceQuery":"status closed","changeType":null,"changedFields":null,"scrapedAt":"2026-11-10T06:51:06+00:00"}
```

### Limits and caveats

- **Members-only fields.** BidNet Direct shows the issuing organisation, the solicitation
  number, the description, the documents and the buyer contact for open bids to
  registered members only. This Actor does not sign in, so those fields are null on such
  rows and `membersOnlyFields` says which ones. The bid title, state, dates, time zone,
  days left and purchasing group are always delivered.
- **The closed archive is where the details are.** Closed bids usually print the issuing
  organisation, the description and the buyer's own notice link, so a `status: closed`
  run gives you the fullest rows.
- **A single search reaches 10,000 rows.** BidNet Direct's own pager stops at 400 pages of
  25\. Narrow a wide search with a keyword, a state or a date window; the run says so in
  the status message when it stops there.
- **The closed list is the recent window.** Around 6.4 million closed bids are listed;
  without a keyword or state filter a run reads the roughly one month nearest to today.
  Add a keyword or state to reach older ones.
- **Deadline windows are applied to the rows a run reads.** The list is ordered by
  publication date, newest first, so a deadline-only search reads from the newest
  publication date onwards. Combine it with a keyword or state for a narrow, cheap run.
- `estimatedValue` and `currency` are reserved and always null: no contract estimate is
  published anonymously. An engineer's estimate inside a description stays in the
  description text and is not turned into a number.
- If one solicitation's page cannot be read, the row is still delivered with
  `detailIssue` explaining what was missing.
- If the source cannot be read, the run stops with a plain status message; rows already
  collected stay in the dataset.
- If nothing matches, the run succeeds with an empty dataset.

### FAQ

**How fresh is the data?** Every run reads BidNet Direct live.

**Why is the buyer empty on some rows?** That notice prints the issuing organisation for
registered members only. `membersOnlyFields` names the fields the page hid.

**How do I get only new bids each day?** Turn on *Only new or changed since the last run*
and schedule the Actor with the same input.

**Can I get federal bids only?** Set `agencyType` to `federal`; those notices also carry
the original sam.gov link.

**What happens when nothing matches?** The run succeeds with 0 rows and a plain status
message.

**Can I run it on a schedule?** Yes. Save the input, add a schedule in the Apify Console
— daily is usual for bid alerts — and choose where the results should go (email, webhook,
Google Sheets or your own server).

**How long does a run take?** About half a minute for the 20-row default with details. Turn
`includeDetails` off for a faster, list-only sweep.

### Price

You pay for what you get: **$0.004 per delivered solicitation**, plus a run-start charge
of $0.005 per GB of memory — the default 512 MB run is one start charge, so $0.005.

| Run | Solicitations | Cost |
|---|---:|---:|
| Console default (20, details on) | 20 | $0.085 |
| One state and a keyword | 100 | $0.405 |
| Open federal bids | 1,000 | $4.005 |

The start charge applies even when a run finds nothing, and solicitations that are not
delivered are not charged. Platform usage is included in the price.

### Support

For questions or issues, contact us from the Actor page.

# Actor input Schema

## `keyword` (type: `string`):

Words matched by BidNet Direct's own search, e.g. 'roof replacement' or 'janitorial'. It matches more than the title, so some rows do not show the word in their title. Up to 200 characters.

## `state` (type: `string`):

Two-letter US state or territory code, or 'any' for every location. e.g. TX, CA, DC.

## `category` (type: `string`):

Industry sector as BidNet Direct classifies it.

## `agencyType` (type: `string`):

Which pool of buyers to read: every solicitation, state and local agencies, member agencies of a purchasing group, or federal notices.

## `status` (type: `string`):

Open solicitations, the recently published closed archive, or both (the open list is read first).

## `publishedFrom` (type: `string`):

Earliest publication date, YYYY-MM-DD (inclusive).

## `publishedTo` (type: `string`):

Latest publication date, YYYY-MM-DD (inclusive).

## `deadlineFrom` (type: `string`):

Only solicitations whose response deadline falls on or after this date, YYYY-MM-DD.

## `deadlineTo` (type: `string`):

Only solicitations whose response deadline falls on or before this date, YYYY-MM-DD.

## `maxResults` (type: `integer`):

Stop after this many solicitations (deduplicated on the solicitation id).

## `includeDetails` (type: `boolean`):

Read each solicitation's own page: the closing and publication time with its time zone, and — where the platform publishes them openly — the issuing organisation, the description and the original notice link. One page read per solicitation, slower.

## `onlyNewSinceLastRun` (type: `boolean`):

Return only solicitations this search has not delivered before, or whose title, deadline, status or documents changed since the last run. Keep the same input and schedule to get a clean daily feed.

## `stateKey` (type: `string`):

Optional name for the saved feed state. Leave empty to derive it from the input, so different searches keep separate histories. Set a new name to start the feed over.

## Actor input object example

```json
{
  "keyword": "",
  "state": "any",
  "category": "any",
  "agencyType": "any",
  "status": "open",
  "publishedFrom": "",
  "publishedTo": "",
  "deadlineFrom": "",
  "deadlineTo": "",
  "maxResults": 20,
  "includeDetails": true,
  "onlyNewSinceLastRun": false,
  "stateKey": ""
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keyword": "",
    "state": "any",
    "category": "any",
    "agencyType": "any",
    "status": "open",
    "publishedFrom": "",
    "publishedTo": "",
    "deadlineFrom": "",
    "deadlineTo": "",
    "maxResults": 20,
    "includeDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("automatic/us-bidnet-tenders-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keyword": "",
    "state": "any",
    "category": "any",
    "agencyType": "any",
    "status": "open",
    "publishedFrom": "",
    "publishedTo": "",
    "deadlineFrom": "",
    "deadlineTo": "",
    "maxResults": 20,
    "includeDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("automatic/us-bidnet-tenders-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keyword": "",
  "state": "any",
  "category": "any",
  "agencyType": "any",
  "status": "open",
  "publishedFrom": "",
  "publishedTo": "",
  "deadlineFrom": "",
  "deadlineTo": "",
  "maxResults": 20,
  "includeDetails": true
}' |
apify call automatic/us-bidnet-tenders-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automatic/us-bidnet-tenders-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/K64dMu8oAyvXlIefQ/builds/yqGQgVIDr02abOneX/openapi.json
