# FMCSA Trucking Scraper - Motor Carriers, Authority & Leads (`scrapesage/fmcsa-trucking-scraper`) Actor Scrape US trucking companies from FMCSA open data: USDOT/MC carriers & brokers with phone, email, fleet size, operating authority, insurance & out-of-service status. Filter by state, operation & registration date for fresh new-carrier leads, plus monitoring. Keyless, no browser. - **URL**: https://apify.com/scrapesage/fmcsa-trucking-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 carrier records 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/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 ## FMCSA Trucking Scraper — US Motor Carriers, Operating Authority & Leads Extract **US trucking companies and motor carriers** straight from the **[FMCSA](https://www.fmcsa.dot.gov/) open-data registry** — every USDOT carrier and MC-number broker with **phone, e-mail, physical & mailing address, fleet size, operating authority, insurance, and out-of-service status**. Filter by **state, operation type, fleet size, and registration date** to pull **fresh new-authority leads**, or look up a full safety-and-authority profile by **USDOT / MC number / company name**. No login, no cookies, no browser, no API key — this actor reads the official **U.S. DOT Socrata open-data API**, which is **keyless, fast, and 100% reliable** (government infrastructure, zero anti-bot). Every carrier row is a ready-to-use **B2B lead**. ### Why this FMCSA / trucking scraper? Most trucking scrapers return a single SAFER snapshot or a thin census row. This actor merges the **full Company Census** (4.45M carriers), the **SMS e-mail census**, the **operating-authority** dataset (MC numbers, broker/common/contract status), **insurance** on file, **out-of-service orders**, and **authority revocations** into one dense record — the **richest motor-carrier dataset in the category**. | Data | Thin scrapers | This actor | |---|---|---| | Legal name, DBA, USDOT # | ✅ | ✅ | | **MC / docket number** | partial | ✅ (operating-authority join) | | **Phone** | ✅ | ✅ | | **E-mail address** | ❌ | ✅ (FMCSA e-mail census) | | Physical **and** mailing address | partial | ✅ both | | Fleet: power units, trucks, buses, drivers, CDLs | partial | ✅ full | | Operation type, hazmat, classification | partial | ✅ | | **Operating authority** (common/contract/broker, authorized-for-hire) | ❌ | ✅ | | **Insurance** requirements + policies on file | ❌ | ✅ | | **Out-of-service** orders + revocations | ❌ | ✅ (lookup mode) | | **Registration date** → fresh new-authority leads | ❌ | ✅ | | Lead score (0–100) | ❌ | ✅ | | Monitoring — only new carriers | ❌ | ✅ | ### Use cases - **Freight & logistics lead generation** — build targeted carrier and broker lists by state, fleet size, and operation type, with phone + e-mail ready for your CRM or dialer. - **New-authority / new-entrant marketing** — the highest-value slice: carriers registered in the last N days need **insurance, factoring, ELDs, fuel cards, dispatch, and compliance services** right now. Filter by `registeredAfter` (or run Monitoring mode daily) to reach them first. - **Carrier vetting & compliance** — look up a carrier's operating authority, insurance on file, and out-of-service / revocation history before you book a load or onboard. - **Insurance & factoring prospecting** — find active for-hire carriers by fleet size and state; see who is required to carry BIPD/cargo coverage and what's on file. - **Market & competitive research** — analyze fleet sizes, operation radius, hazmat share, and registration trends across any state. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **FMCSA Trucking Scraper**, keep **Mode = Carriers**, choose one or more **states** (or leave empty for nationwide), and optionally set **Registered after** for fresh leads. 3. Click **Start** and watch carriers stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "mode": "carriers", "states": ["TX", "CA"], "carrierOperation": "Interstate", "registeredAfter": "2026-05-01", "minPowerUnits": 1, "maxPowerUnits": 25, "includeEmail": true, "enrichAuthority": true, "maxResults": 1000 } ```` - **mode** *(default `carriers`)* — `carriers` discovers/filters carriers from the census (lead generation); `lookup` returns a full profile for the USDOT / MC / company name you pass. - **states** — physical-address state filter (2-letter codes or full names). Empty = nationwide, newest registrations first. - **carrierOperation** — `Any`, `Interstate`, `Intrastate Hazmat`, or `Intrastate Non-Hazmat`. - **registeredAfter / registeredBefore** *(YYYY-MM-DD)* — registration-date window. `registeredAfter` is the key to **fresh new-authority leads**. - **hazmatOnly / activeOnly** — keep only hazmat carriers / only Active-status carriers (Active-only is on by default). - **minPowerUnits / maxPowerUnits / minDrivers** — fleet-size targeting (e.g. set max 5 for owner-operators, min 50 for large fleets). - **companyName** — filter (carriers) or resolve (lookup) by legal name. - **dotNumbers / mcNumbers** — for Lookup mode (or to restrict Carriers mode to specific USDOT numbers). - **includeEmail** *(default true)* — add the FMCSA e-mail address. - **enrichAuthority** *(default true)* — add operating authority (MC#, common/contract/broker status, authorized-for-hire flags, insurance requirements) and insurance policies on file. Always on in Lookup mode. - **maxResults / maxResultsPerState** — caps. **monitorMode** + **monitorStoreName** — only-new-carriers tracking. **proxyConfiguration / socrataAppToken / maxConcurrency** — run tuning. #### Lookup mode ```json { "mode": "lookup", "dotNumbers": ["76830", "244818"], "mcNumbers": ["012892"], "companyName": "SWIFT TRANSPORTATION" } ``` Returns one full profile per carrier: census + contact + operating authority + insurance + out-of-service orders + revocations. ### Output A carrier record (`type: "carrier"`): ```json { "type": "carrier", "dotNumber": "8214454", "legalName": "Optimal Greatness Solutions LLC", "dbaName": null, "operationType": "Interstate", "operationCode": "A", "status": "Active", "isActive": true, "hazmat": false, "carrierClassification": "AUTHORIZED FOR HIRE", "phone": "(404) 520-0327", "email": "dispatch@example.com", "physicalAddress": { "street": "123 Main St", "city": "Houston", "state": "TX", "zip": "77001", "county": "201", "country": "US" }, "mailingAddress": { "street": "PO Box 123", "city": "Houston", "state": "TX", "zip": "77001", "country": "US" }, "powerUnits": 2, "truckUnits": 2, "totalDrivers": 4, "cdlDrivers": 2, "operationRadius": { "interstateBeyond100Miles": 2, "interstateWithin100Miles": 0, "intrastateBeyond100Miles": 0, "intrastateWithin100Miles": 0 }, "registrationDate": "2026-06-13", "ageInDays": 2, "isNewEntrant": true, "mcs150Date": "2026-06-13", "mcNumber": "MC1234567", "operatingAuthority": { "authority": { "common": { "status": "Active", "applicationPending": false, "revocationPending": false }, "contract": null, "broker": null }, "authorizedFor": { "property": true, "passenger": false, "householdGoods": false, "private": false, "enterprise": false }, "insuranceRequirements": { "bipdRequiredThousands": 750, "cargoRequired": false, "bondRequired": false, "bipdOnFile": "750", "cargoOnFile": false, "bondOnFile": false } }, "insurance": [ { "insurer": "Progressive", "type": "BIPD/Primary", "coverageThousands": 1000, "policyNumber": "ABC123", "effectiveDate": "06/01/2026" } ], "saferSnapshotUrl": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=8214454", "leadScore": 84, "scrapedAt": "2026-06-15T12:00:00.000Z" } ``` In **Lookup mode** the record also carries `outOfService` (orders + current OOS flag) and `revocations`. Every other census column FMCSA publishes is passed through under `additionalData`, so you always get the richest possible record. #### What to expect (field coverage) FMCSA fields are operator-reported, so some are populated only when the carrier filed them. Verified against the live registry: | Field | Coverage | |---|---| | USDOT #, legal name, operation type, status, address | ✅ ~100% | | Phone | ✅ very high (FMCSA requires a contact phone) | | Fleet size (power units, drivers) | ✅ high | | **E-mail** | present for carriers that filed one (FMCSA e-mail census subset) | | **MC number / operating authority** | present for carriers/brokers with interstate for-hire authority (intrastate-only carriers have none) | | **Insurance on file** | present for carriers required to carry it | | Out-of-service / revocations | present only when such an event exists (most carriers: none) | A blank field means FMCSA doesn't publish that value for that carrier — not that scraping failed. Nothing is dropped. ### Automate & schedule - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run daily with **Monitoring mode** + `registeredAfter` to capture brand-new carriers the moment they get authority. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger CRM import, a Slack alert, or an outreach sequence the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/fmcsa-trucking-scraper').call({ mode: 'carriers', states: ['TX'], registeredAfter: '2026-05-01', monitorMode: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} carrier leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new carrier leads straight into your CRM or dialer. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get pinged when new carriers register in your states. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find Texas interstate carriers with 1–10 trucks registered this month, with phone and email" and let it run the scraper. ### More scrapers from scrapesage Build a complete **B2B lead-gen & business-intelligence stack** with sibling actors: - **[US Business Formation Scraper](https://apify.com/scrapesage/us-business-formation-scraper)** — newly registered US LLCs & companies (fresh business leads). - **[SAM.gov Scraper](https://apify.com/scrapesage/sam-gov-scraper)** — federal contract opportunities & contacts. - **[USASpending Scraper](https://apify.com/scrapesage/usaspending-scraper)** — federal awards, contractors & recipients. - **[Insurance Agent Scraper](https://apify.com/scrapesage/insurance-agent-scraper)** — multi-carrier insurance agent leads. - **[SEC EDGAR Scraper](https://apify.com/scrapesage/sec-edgar-scraper)** — filings, financials & company contacts. - **[Companies House Scraper](https://apify.com/scrapesage/companies-house-scraper)** — UK companies, directors & PSCs. - **[FEC Campaign Finance Scraper](https://apify.com/scrapesage/fec-campaign-finance-scraper)** — donors, committees & lobbying. - **[Court Records Scraper](https://apify.com/scrapesage/court-records-scraper)** — dockets, opinions & litigation intelligence. ### Tips - **Fresh leads**: set `registeredAfter` to ~30 days ago (or turn on **Monitoring mode** + a daily [Schedule](https://docs.apify.com/platform/schedules)) to capture new-authority carriers before competitors do. - **Owner-operators vs fleets**: use `maxPowerUnits: 5` for small operators, or `minPowerUnits: 50` for large fleets. - **Interstate for-hire**: set `carrierOperation: "Interstate"` and keep `enrichAuthority` on to get MC numbers and authority status — the carriers most likely to need brokers, insurance, and factoring. - **Vetting a specific carrier**: switch to **Lookup mode** and pass the USDOT or MC number for a full authority + insurance + out-of-service profile. - **No proxy needed**: FMCSA open data is a clean government API; the default Apify proxy is plenty. ### FAQ **Where does the data come from?** The official FMCSA / U.S. DOT open-data datasets on `data.transportation.gov` (Company Census, SMS e-mail census, operating authority, insurance, out-of-service orders, revocations) — the same data behind SAFER and L\&I, served as a clean Socrata API. **Do I need an API key or login?** No. The API is keyless. You can optionally add a free Socrata app token to raise the rate limit on very large runs. **How fresh is the data?** FMCSA refreshes these datasets continuously — the census updates daily. New carriers typically appear within a day or two of getting their USDOT number. **How do I get only NEW carriers each run?** Turn on **Monitoring mode** and create a [Schedule](https://docs.apify.com/platform/schedules). Each run emits only USDOT numbers not seen before. Pair it with `registeredAfter` for a pure new-authority feed. **Why is email/MC number sometimes empty?** Not every carrier files an e-mail, and intrastate-only carriers don't hold an MC number / operating authority. Fields are blank only when FMCSA has no value — never because scraping failed. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **Is this legal?** This actor collects publicly available US government data. You are responsible for using it in compliance with applicable laws (e.g. TCPA/CAN-SPAM for outreach) and FMCSA's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `mode` (type: `string`): What to scrape. 'Carriers' discovers/filters motor carriers from the FMCSA census (the main lead-gen engine). 'Lookup' returns a full profile for specific carriers you pass via USDOT, MC number, or company name (census + operating authority + insurance + out-of-service + revocations). ## `states` (type: `array`): Filter carriers by physical-address state. Use 2-letter codes (e.g. TX, CA) or full names. Leave empty to scrape all states (newest registrations first). Ignored in Lookup mode. ## `carrierOperation` (type: `string`): Filter by carrier operation. Interstate carriers cross state lines (most freight/broker leads); Intrastate Hazmat / Non-Hazmat operate within one state. ## `registeredAfter` (type: `string`): Only return carriers registered with FMCSA on or after this date — the key to fresh, high-intent new-authority leads (insurance, factoring, ELD, fuel cards). Leave empty for all. Example: 2026-05-01. ## `registeredBefore` (type: `string`): Only return carriers registered on or before this date. Combine with 'Registered after' for a date window. Leave empty for no upper bound. ## `hazmatOnly` (type: `boolean`): Keep only carriers flagged as transporting hazardous materials. ## `activeOnly` (type: `boolean`): Keep only carriers whose FMCSA status is Active (drops inactive/pending). Recommended for lead generation. ## `minPowerUnits` (type: `integer`): Only keep carriers with at least this many power units (trucks/tractors). Leave empty for no minimum. Great for targeting fleets of a given size. ## `maxPowerUnits` (type: `integer`): Only keep carriers with at most this many power units. Leave empty for no maximum (e.g. set 1–5 to target small owner-operators). ## `minDrivers` (type: `integer`): Only keep carriers with at least this many drivers. Leave empty for no minimum. ## `companyName` (type: `string`): Filter (carriers mode) or resolve (lookup mode) by legal name containing this text. Example: SWIFT TRANSPORTATION. ## `dotNumbers` (type: `array`): USDOT numbers to look up (Lookup mode) or restrict to (Carriers mode). Example: \["76830", "244818"]. ## `mcNumbers` (type: `array`): MC (docket) numbers to look up in Lookup mode — resolved to carriers via the operating-authority dataset. Digits only or with the MC prefix. Example: \["012892", "MC255345"]. ## `includeEmail` (type: `boolean`): Enrich each carrier with the e-mail address on file with FMCSA (from the SMS census). Adds a fast lookup per batch. Recommended for lead generation. ## `enrichAuthority` (type: `boolean`): Enrich each carrier with its operating authority (MC number, common/contract/broker status, authorized-for-hire flags, insurance requirements) and insurance policies on file. Adds extra lookups per batch. Always on in Lookup mode. ## `maxResults` (type: `integer`): Global cap on the total number of carrier records emitted in this run. ## `maxResultsPerState` (type: `integer`): Optional cap per state (carriers mode, when multiple states are selected). 0 = split the global cap evenly across the selected states. ## `deduplicateResults` (type: `boolean`): Emit each USDOT number only once per run. ## `monitorMode` (type: `boolean`): Remember USDOT numbers already returned and emit ONLY carriers not seen in previous runs. Pair with 'Registered after' and Apify Schedules to capture brand-new motor-carrier leads daily. ## `monitorStoreName` (type: `string`): Named key-value store holding the 'already seen' USDOT numbers for monitoring mode. Use a different name per tracked scope (lowercase letters, digits and hyphens only). ## `socrataAppToken` (type: `string`): Optional Socrata app token to raise the FMCSA open-data API throttling limit on very large runs. Not required for normal use. ## `maxConcurrency` (type: `integer`): Maximum parallel fetches (states / enrichment batches). ## `proxyConfiguration` (type: `object`): Proxy settings. FMCSA open data is a clean US-gov API, so the default Apify proxy is plenty (a proxy is not strictly required). ## Actor input object example ```json { "mode": "carriers", "states": [ "TX" ], "carrierOperation": "Any", "hazmatOnly": false, "activeOnly": true, "includeEmail": true, "enrichAuthority": true, "maxResults": 1000, "maxResultsPerState": 0, "deduplicateResults": true, "monitorMode": false, "monitorStoreName": "fmcsa-trucking-monitor", "maxConcurrency": 4, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): All scraped motor-carrier records in the default dataset. # 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 = { "states": [ "TX" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/fmcsa-trucking-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "states": ["TX"] } # Run the Actor and wait for it to finish run = client.actor("scrapesage/fmcsa-trucking-scraper").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 '{ "states": [ "TX" ] }' | apify call scrapesage/fmcsa-trucking-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/fmcsa-trucking-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FMCSA Trucking Scraper - Motor Carriers, Authority & Leads", "description": "Scrape US trucking companies from FMCSA open data: USDOT/MC carriers & brokers with phone, email, fleet size, operating authority, insurance & out-of-service status. Filter by state, operation & registration date for fresh new-carrier leads, plus monitoring. Keyless, no browser.", "version": "0.1", "x-build-id": "6AsmPLhrPIYpPbJLP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~fmcsa-trucking-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-fmcsa-trucking-scraper", "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/scrapesage~fmcsa-trucking-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-fmcsa-trucking-scraper", "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/scrapesage~fmcsa-trucking-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-fmcsa-trucking-scraper", "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": { "mode": { "title": "Mode", "enum": [ "carriers", "lookup" ], "type": "string", "description": "What to scrape. 'Carriers' discovers/filters motor carriers from the FMCSA census (the main lead-gen engine). 'Lookup' returns a full profile for specific carriers you pass via USDOT, MC number, or company name (census + operating authority + insurance + out-of-service + revocations).", "default": "carriers" }, "states": { "title": "States (carriers mode)", "type": "array", "description": "Filter carriers by physical-address state. Use 2-letter codes (e.g. TX, CA) or full names. Leave empty to scrape all states (newest registrations first). Ignored in Lookup mode.", "items": { "type": "string" } }, "carrierOperation": { "title": "Operation type", "enum": [ "Any", "Interstate", "Intrastate Hazmat", "Intrastate Non-Hazmat" ], "type": "string", "description": "Filter by carrier operation. Interstate carriers cross state lines (most freight/broker leads); Intrastate Hazmat / Non-Hazmat operate within one state.", "default": "Any" }, "registeredAfter": { "title": "Registered after (YYYY-MM-DD)", "type": "string", "description": "Only return carriers registered with FMCSA on or after this date — the key to fresh, high-intent new-authority leads (insurance, factoring, ELD, fuel cards). Leave empty for all. Example: 2026-05-01." }, "registeredBefore": { "title": "Registered before (YYYY-MM-DD)", "type": "string", "description": "Only return carriers registered on or before this date. Combine with 'Registered after' for a date window. Leave empty for no upper bound." }, "hazmatOnly": { "title": "Hazmat carriers only", "type": "boolean", "description": "Keep only carriers flagged as transporting hazardous materials.", "default": false }, "activeOnly": { "title": "Active carriers only", "type": "boolean", "description": "Keep only carriers whose FMCSA status is Active (drops inactive/pending). Recommended for lead generation.", "default": true }, "minPowerUnits": { "title": "Min power units (trucks)", "minimum": 0, "type": "integer", "description": "Only keep carriers with at least this many power units (trucks/tractors). Leave empty for no minimum. Great for targeting fleets of a given size." }, "maxPowerUnits": { "title": "Max power units (trucks)", "minimum": 0, "type": "integer", "description": "Only keep carriers with at most this many power units. Leave empty for no maximum (e.g. set 1–5 to target small owner-operators)." }, "minDrivers": { "title": "Min drivers", "minimum": 0, "type": "integer", "description": "Only keep carriers with at least this many drivers. Leave empty for no minimum." }, "companyName": { "title": "Company name contains", "type": "string", "description": "Filter (carriers mode) or resolve (lookup mode) by legal name containing this text. Example: SWIFT TRANSPORTATION." }, "dotNumbers": { "title": "USDOT numbers (lookup mode)", "type": "array", "description": "USDOT numbers to look up (Lookup mode) or restrict to (Carriers mode). Example: [\"76830\", \"244818\"].", "items": { "type": "string" } }, "mcNumbers": { "title": "MC / docket numbers (lookup mode)", "type": "array", "description": "MC (docket) numbers to look up in Lookup mode — resolved to carriers via the operating-authority dataset. Digits only or with the MC prefix. Example: [\"012892\", \"MC255345\"].", "items": { "type": "string" } }, "includeEmail": { "title": "Include email addresses", "type": "boolean", "description": "Enrich each carrier with the e-mail address on file with FMCSA (from the SMS census). Adds a fast lookup per batch. Recommended for lead generation.", "default": true }, "enrichAuthority": { "title": "Include operating authority & insurance", "type": "boolean", "description": "Enrich each carrier with its operating authority (MC number, common/contract/broker status, authorized-for-hire flags, insurance requirements) and insurance policies on file. Adds extra lookups per batch. Always on in Lookup mode.", "default": true }, "maxResults": { "title": "Max results (whole run)", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Global cap on the total number of carrier records emitted in this run.", "default": 1000 }, "maxResultsPerState": { "title": "Max results per state", "minimum": 0, "type": "integer", "description": "Optional cap per state (carriers mode, when multiple states are selected). 0 = split the global cap evenly across the selected states.", "default": 0 }, "deduplicateResults": { "title": "Deduplicate results", "type": "boolean", "description": "Emit each USDOT number only once per run.", "default": true }, "monitorMode": { "title": "Monitoring mode — only new carriers", "type": "boolean", "description": "Remember USDOT numbers already returned and emit ONLY carriers not seen in previous runs. Pair with 'Registered after' and Apify Schedules to capture brand-new motor-carrier leads daily.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store holding the 'already seen' USDOT numbers for monitoring mode. Use a different name per tracked scope (lowercase letters, digits and hyphens only).", "default": "fmcsa-trucking-monitor" }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional Socrata app token to raise the FMCSA open-data API throttling limit on very large runs. Not required for normal use." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Maximum parallel fetches (states / enrichment batches).", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. FMCSA open data is a clean US-gov API, so the default Apify proxy is plenty (a proxy is not strictly required).", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```