{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Scraper: USDOT & MC Lookup, Trucking Leads", "description": "Scrape the FMCSA / SAFER motor carrier database with no API key. Look up carriers by USDOT number, MC docket, name, state or fleet and get USDOT status, safety rating, cargo, operating authority, insurance, phone and email. Trucking company data and freight carrier leads as JSON, CSV or Excel.", "version": "0.1", "x-build-id": "IBd7jEPpacTAbbMIv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~fmcsa-carriers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-fmcsa-carriers-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/scrapers_lat~fmcsa-carriers-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-fmcsa-carriers-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/scrapers_lat~fmcsa-carriers-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-fmcsa-carriers-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": { "maxCarriers": { "title": "Max Carriers", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of carrier records to collect. Free Apify plans are capped at 10 per run." }, "withDetails": { "title": "Include operating authority and insurance", "type": "boolean", "description": "When enabled, each carrier is enriched with its MC/docket number, operating-authority status, insurance requirements, and active insurance policies on file (insurer, policy number, coverage amount) from the public FMCSA licensing and insurance feed.", "default": true }, "dotNumbers": { "title": "USDOT Numbers", "type": "array", "description": "Look up exact carriers by USDOT number. When set (with or without MC numbers), all search filters are ignored.", "items": { "type": "string" } }, "mcNumbers": { "title": "MC / Docket Numbers", "type": "array", "description": "Look up carriers by MC, MX or FF docket number, for example MC123310 or 123310. Resolved to the matching USDOT carrier automatically.", "items": { "type": "string" } }, "legalName": { "title": "Legal Name contains", "type": "string", "description": "Match carriers whose legal name contains this text (case-insensitive)." }, "dbaName": { "title": "DBA Name contains", "type": "string", "description": "Match carriers whose doing-business-as name contains this text (case-insensitive)." }, "freeText": { "title": "Free Text Search", "type": "string", "description": "Full-text search across all fields of the carrier record." }, "state": { "title": "State", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR" ], "type": "string", "description": "Two-letter physical state of the carrier." }, "carrierOperation": { "title": "Carrier operation", "enum": [ "Any", "Interstate", "Intrastate Hazmat", "Intrastate Non-Hazmat" ], "type": "string", "description": "Filter by operation type.", "default": "Any" }, "entityType": { "title": "Entity / role", "enum": [ "Any", "Carrier", "Broker", "Shipper", "Freight Forwarder" ], "type": "string", "description": "Filter by the role the company is registered under (carrier, broker, shipper or freight forwarder).", "default": "Any" }, "minPowerUnits": { "title": "Minimum Power Units", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only return carriers operating at least this many power units (trucks, tractors, buses)." }, "maxPowerUnits": { "title": "Maximum Power Units", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only return carriers operating at most this many power units." }, "minDrivers": { "title": "Minimum Drivers", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only return carriers with at least this many drivers." }, "hazmatOnly": { "title": "Hazmat carriers only", "type": "boolean", "description": "When enabled, only carriers flagged for hazardous materials are returned.", "default": false }, "registeredAfter": { "title": "Registered after", "type": "string", "description": "Only carriers first added to the FMCSA register on or after this date (YYYY-MM-DD). Great for new-carrier / new-authority lead feeds." }, "registeredBefore": { "title": "Registered before", "type": "string", "description": "Only carriers first added to the FMCSA register on or before this date (YYYY-MM-DD)." }, "activeOnly": { "title": "Active carriers only", "type": "boolean", "description": "When enabled, only carriers with an active USDOT status are returned.", "default": true }, "withProfileSummary": { "title": "AI carrier profile summary (paid add-on)", "type": "boolean", "description": "Add a plain-English AI summary of each carrier (fleet size, operation type, cargo authority). Opt-in, billed per enriched record; requires a paid Apify plan.", "default": false }, "withRisk": { "title": "AI risk flags (paid add-on)", "type": "boolean", "description": "Surface operational/compliance red flags (inactive status, missing authority, conditional safety rating, stale filings) with a low/medium/high level via AI. Opt-in, billed per enriched record; requires a paid Apify plan.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }