# US State DOT Construction Bid & Lettings Aggregator (`jungle_synthesizer/us-state-dot-construction-bid-lettings-aggregator`) Actor Scrapes highway and bridge construction bid-letting calendars from US state DOTs and federal SAM.gov. Covers upcoming bid openings, awarded contracts, engineer estimates, and DBE goals. Sources: Florida DOT and SAM.gov NAICS 237xxx solicitations. - **URL**: https://apify.com/jungle\_synthesizer/us-state-dot-construction-bid-lettings-aggregator.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Lead generation, Business, Automation - **Stats:** 2 total users, 1 monthly users, 70.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## US State DOT Construction Bid & Lettings Aggregator Scrapes highway and bridge construction bid-letting calendars from US state DOTs and federal solicitation databases. Returns structured contract data — project name, letting date, estimated value, DBE goals, NAICS codes, and awarded contractor info — from Florida DOT and SAM.gov in a single clean dataset. Two sources cover the construction contracting pipeline from federal solicitations down to state-level bid openings. No API key required. No proxies. ### US State DOT Aggregator Features - **Extracts SAM.gov federal solicitations** — construction contracts, pre-solicitations, awards, and sources-sought notices for NAICS 237xxx codes (highway, pipeline, power/comms, and other heavy civil). Covers all 50 states. - **Scrapes Florida DOT upcoming bid-letting calendars** — project tables organized by letting date, covering 30–60 active contracts per run with proposal IDs, counties, and work types. - **Filters by state, NAICS code, and active-only status** — narrow SAM.gov results to a specific state or work category, or pull the full national picture. - **Captures engineer estimates and awarded contract data** — estimated value ranges, awarded amounts, awarded contractor names, and award dates when available. - **Tracks DBE participation goals** — disadvantaged business enterprise targets included where reported. - **Returns plan document URLs** — direct links to bid packages and specification PDFs. - **Multi-source, single schema** — SAM.gov and FDOT records normalize to the same output fields with a `source_jurisdiction` field to tell them apart. - **Pure HTTP scraping** — no browser rendering required for either source. ### What Can You Do With Construction Bid Data? - **General contractors** — Track upcoming letting dates and bid deadlines across states before competitors see the posting. - **Subcontractors and suppliers** — Find active solicitations in your service region, filtered by NAICS code, and reach prime contractors early. - **DBE/MBE firms** — Identify contracts with active DBE goals for targeted outreach to primes awarded those contracts. - **Market intelligence teams** — Monitor awarded contract volumes and values by state, agency, and work type to track DOT spending patterns. - **CRM and lead generation pipelines** — Feed awarded contractor names and project details into prospecting workflows without manual lookups. - **Researchers and analysts** — Build time-series datasets of public construction procurement activity across state and federal sources. ### How It Works 1. **Choose a source.** Set `source` to `samgov`, `fdot`, or `all`. The default `all` runs SAM.gov first, then appends FDOT data in a single run. 2. **SAM.gov mode** hits the internal search API at `sam.gov/api/prod/sgs/v1/search/` with your NAICS codes, optional state filter, and keyword. Paginates until `maxItems` is reached or the result set is exhausted. 3. **FDOT mode** fetches the letting calendar page, walks the accordion sections by date, and extracts project rows from each letting table — proposal ID, county, work type, and plan document links. 4. **Output normalizes** both sources into the same 21-field schema. `source_jurisdiction` tells you where each record came from. Records missing a field return `null`. ### US State DOT Aggregator Input ```json { "source": "all", "naicsCodes": ["237310", "237120", "237130", "237990"], "state": "FL", "keyword": "bridge", "activeOnly": true, "maxItems": 100 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `source` | string | `all` | Which source to scrape: `all`, `samgov`, or `fdot` | | `naicsCodes` | array | `["237310","237120","237130","237990"]` | NAICS codes to filter SAM.gov results. Only applies to SAM.gov mode. | | `state` | string | — | Two-letter state abbreviation to filter SAM.gov by place of performance (e.g., `FL`, `TX`). Optional. | | `keyword` | string | — | Keyword to filter SAM.gov results (e.g., `bridge`, `highway`, `resurfacing`). Optional. | | `activeOnly` | boolean | `true` | When true, returns only currently active SAM.gov opportunities. | | `maxItems` | integer | `100` | Maximum total records to return across all sources. | #### SAM.gov only — national bridge solicitations ```json { "source": "samgov", "naicsCodes": ["237310"], "keyword": "bridge", "activeOnly": true, "maxItems": 50 } ``` #### FDOT only — full Florida letting calendar ```json { "source": "fdot", "maxItems": 200 } ``` ### US State DOT Aggregator Output Fields Records from both sources share a common schema. Fields not available for a given record return `null`. #### SAM.gov record example ```json { "source_jurisdiction": "samgov", "bid_id": "DTFH70-25-R-00012", "project_name": "Bridge Deck Rehabilitation, I-95 Corridor, Broward County", "work_type": "Solicitation", "naics_code": "237310", "state": "FL", "county": null, "location_description": "Broward County, FL", "estimated_value_low": 5000000, "estimated_value_high": 10000000, "letting_date": null, "bid_due_date": "2026-07-15T17:00:00.000Z", "dbe_goal_percent": null, "prime_contractor_awarded": null, "awarded_amount": null, "awarded_date": null, "plan_documents_url": "https://sam.gov/opp/abc123/view", "status": "active", "url": "https://sam.gov/opp/abc123/view", "scrapedAt": "2026-06-10T12:00:00.000Z", "raw": null } ``` #### FDOT record example ```json { "source_jurisdiction": "fdot", "bid_id": "T4218", "project_name": "SR 80 Resurfacing, Hendry County", "work_type": "Resurfacing", "naics_code": "237310", "state": "FL", "county": "Hendry", "location_description": null, "estimated_value_low": null, "estimated_value_high": null, "letting_date": "August 20, 2026", "bid_due_date": null, "dbe_goal_percent": null, "prime_contractor_awarded": null, "awarded_amount": null, "awarded_date": null, "plan_documents_url": "https://www.fdot.gov/contracts/plans/T4218", "status": "advertised", "url": "https://www.fdot.gov/contracts/lettings/letting-project-info.shtm", "scrapedAt": "2026-06-10T12:00:00.000Z", "raw": null } ``` | Field | Type | Description | |-------|------|-------------| | `source_jurisdiction` | string | Data source identifier: `samgov` or `fdot` | | `bid_id` | string | Source-native contract or solicitation number | | `project_name` | string | Title or name of the project or solicitation | | `work_type` | string | Type of construction work (Bridge, Highway, Resurfacing, etc.) | | `naics_code` | string | NAICS code for the work type (e.g., `237310`) | | `state` | string | US state abbreviation for the project location | | `county` | string | County or locality where the project is located | | `location_description` | string | Free-text project location or route description | | `estimated_value_low` | number | Low-end estimated contract value in USD | | `estimated_value_high` | number | High-end estimated contract value in USD | | `letting_date` | string | Scheduled bid opening or letting date | | `bid_due_date` | string | Response or proposal due date (ISO-8601) | | `dbe_goal_percent` | number | Disadvantaged Business Enterprise participation goal percentage | | `prime_contractor_awarded` | string | Name of awarded prime contractor (post-letting) | | `awarded_amount` | number | Final awarded contract amount in USD | | `awarded_date` | string | Date contract was awarded (ISO-8601) | | `plan_documents_url` | string | URL to bid or plan documents (PDF or portal) | | `status` | string | Contract lifecycle status: `advertised`, `active`, `awarded`, or `cancelled` | | `url` | string | Canonical source URL for this record | | `scrapedAt` | string | ISO-8601 timestamp when this record was scraped | | `raw` | object | Source-specific extra fields not normalized into the schema | ### 🔍 FAQ #### How do I scrape federal highway construction contracts? US State DOT Construction Bid & Lettings Aggregator queries the SAM.gov internal search API at `sam.gov/api/prod/sgs/v1/search/` — no registration or API key required. Set `source` to `samgov`, supply your NAICS codes, and optionally filter by state and keyword. #### What data can I get from SAM.gov construction solicitations? US State DOT Construction Bid & Lettings Aggregator returns solicitation number, project title, place of performance (state and locality), estimated value range, bid due date, NAICS code, work type, department and agency name, and a direct link to the SAM.gov listing. Awarded contracts also include contractor name, awarded amount, and award date. #### How do I get Florida DOT bid-letting data? Set `source` to `fdot`. The actor scrapes the FDOT bid-letting calendar page and extracts all project rows organized by letting date — proposal IDs, county, work type, and plan document links for upcoming bid openings. #### How much does this actor cost to run? US State DOT Construction Bid & Lettings Aggregator uses the `2606_basic` pricing profile with a coefficient of 1.3. A typical run retrieving 100 records costs a few cents. Both sources are API-based or light HTML scraping, so compute time is short. #### Does this actor need proxies or an API key? Neither. SAM.gov and the Florida DOT letting calendar are both public government resources. The actor runs without proxies and without any credentials. *** ### Need More Features? Need additional state DOTs, NAICS coverage, or custom field mapping? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use US State DOT Construction Bid & Lettings Aggregator? - **Two sources, one run** — SAM.gov federal coverage plus Florida DOT state-level lettings combined in a single normalized dataset, no separate workflows needed. - **Zero credentials** — both sources are public government data; the actor needs no API key, no proxy, and no account setup to return results. - **Clean, consistent output** — 21 normalized fields across both sources, with `source_jurisdiction` as the discriminator, so downstream pipelines don't need separate parsers. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `source` (type: `string`): Which source(s) to scrape. 'all' (default) runs all available sources, 'samgov' fetches federal construction solicitations from SAM.gov, 'fdot' fetches Florida DOT upcoming bid lettings. ## `naicsCodes` (type: `array`): NAICS construction codes to filter SAM.gov results. Default: 237310 (Highway/Street/Bridge), 237120 (Oil/Gas Pipeline), 237130 (Power/Communication Lines), 237990 (Other Heavy/Civil). ## `activeOnly` (type: `boolean`): If true, only returns currently active SAM.gov opportunities. ## `keyword` (type: `string`): Optional keyword to filter SAM.gov results (e.g., 'bridge', 'highway', 'resurfacing'). ## `state` (type: `string`): Two-letter US state abbreviation to filter SAM.gov results by place of performance (e.g., 'CA', 'TX', 'FL'). ## `maxItems` (type: `integer`): Maximum number of records to return across all sources. Default 100. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "source": "all", "naicsCodes": [ "237310", "237120", "237130", "237990" ], "activeOnly": true, "maxItems": 10 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "source": "all", "naicsCodes": [ "237310", "237120", "237130", "237990" ], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/us-state-dot-construction-bid-lettings-aggregator").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "source": "all", "naicsCodes": [ "237310", "237120", "237130", "237990", ], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/us-state-dot-construction-bid-lettings-aggregator").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "source": "all", "naicsCodes": [ "237310", "237120", "237130", "237990" ], "maxItems": 10 }' | apify call jungle_synthesizer/us-state-dot-construction-bid-lettings-aggregator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/us-state-dot-construction-bid-lettings-aggregator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US State DOT Construction Bid & Lettings Aggregator", "description": "Scrapes highway and bridge construction bid-letting calendars from US state DOTs and federal SAM.gov. Covers upcoming bid openings, awarded contracts, engineer estimates, and DBE goals. Sources: Florida DOT and SAM.gov NAICS 237xxx solicitations.", "version": "0.1", "x-build-id": "crhUs5f2Hl8Diz1Yh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~us-state-dot-construction-bid-lettings-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-us-state-dot-construction-bid-lettings-aggregator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~us-state-dot-construction-bid-lettings-aggregator/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-us-state-dot-construction-bid-lettings-aggregator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~us-state-dot-construction-bid-lettings-aggregator/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-us-state-dot-construction-bid-lettings-aggregator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "source": { "title": "Data Source", "enum": [ "all", "samgov", "fdot" ], "type": "string", "description": "Which source(s) to scrape. 'all' (default) runs all available sources, 'samgov' fetches federal construction solicitations from SAM.gov, 'fdot' fetches Florida DOT upcoming bid lettings.", "default": "all" }, "naicsCodes": { "title": "NAICS Codes (SAM.gov only)", "type": "array", "description": "NAICS construction codes to filter SAM.gov results. Default: 237310 (Highway/Street/Bridge), 237120 (Oil/Gas Pipeline), 237130 (Power/Communication Lines), 237990 (Other Heavy/Civil).", "items": { "type": "string" } }, "activeOnly": { "title": "Active Only (SAM.gov)", "type": "boolean", "description": "If true, only returns currently active SAM.gov opportunities.", "default": true }, "keyword": { "title": "Keyword Filter (SAM.gov)", "type": "string", "description": "Optional keyword to filter SAM.gov results (e.g., 'bridge', 'highway', 'resurfacing')." }, "state": { "title": "State Filter (SAM.gov)", "type": "string", "description": "Two-letter US state abbreviation to filter SAM.gov results by place of performance (e.g., 'CA', 'TX', 'FL')." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to return across all sources. Default 100.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```