{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Scraper — USDOT, MC, Phone, Email", "description": "Scrape the official FMCSA motor carrier census: USDOT and MC number, the phone and email the carrier filed with the DOT, officer name, full address, fleet size, driver counts, hazmat flag and registration date. Filter by state, fleet size, operation type or new-entrant date.", "version": "0.1", "x-build-id": "rJURrNFfTRdpX5PJl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~fmcsa-carrier-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-fmcsa-carrier-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/scrapersdelight~fmcsa-carrier-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-fmcsa-carrier-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/scrapersdelight~fmcsa-carrier-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-fmcsa-carrier-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": { "states": { "title": "States", "type": "array", "description": "Two-letter state codes of the carrier's physical address, e.g. TX, CA, FL. Leave empty for all states.", "default": [], "items": { "type": "string" } }, "registeredAfter": { "title": "Registered on or after", "type": "string", "description": "YYYY-MM-DD. This is the new-entrant feed: carriers that just received a USDOT number are the hottest lead for insurance, factoring and ELD vendors. The census updates daily.", "default": "" }, "registeredBefore": { "title": "Registered on or before", "type": "string", "description": "YYYY-MM-DD.", "default": "" }, "carrierOperation": { "title": "Operation type", "enum": [ "all", "interstate", "intrastate" ], "type": "string", "description": "Interstate carriers cross state lines and are federally regulated; intrastate operate within one state.", "default": "all" }, "activeOnly": { "title": "Active carriers only", "type": "boolean", "description": "Exclude carriers the FMCSA has marked inactive.", "default": true }, "minPowerUnits": { "title": "Minimum fleet size", "minimum": 0, "type": "integer", "description": "Minimum power units (trucks/tractors). 0 = no minimum. Use 5+ to skip owner-operators.", "default": 0 }, "maxPowerUnits": { "title": "Maximum fleet size", "minimum": 0, "type": "integer", "description": "Maximum power units. 0 = no maximum.", "default": 0 }, "hazmatOnly": { "title": "Hazmat carriers only", "type": "boolean", "description": "Only carriers flagged as transporting hazardous materials.", "default": false }, "requireEmail": { "title": "Only carriers with an email", "type": "boolean", "description": "Drop carriers whose filed contact field holds no usable email address. Applied to the parsed value, so you never receive — or pay for — a contactless row.", "default": false }, "requirePhone": { "title": "Only carriers with a phone", "type": "boolean", "description": "Drop carriers with no filed phone number.", "default": false }, "dotNumbers": { "title": "Specific USDOT numbers", "type": "array", "description": "Look up exact carriers by USDOT number. Overrides the other filters for those rows.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort", "enum": [ "newest", "oldest", "largest" ], "type": "string", "description": "Newest first gives you the new-entrant feed; largest first gives you the biggest fleets.", "default": "newest" }, "maxItems": { "title": "Maximum carriers", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Stop after this many carriers. 0 = unlimited (the census holds ~4.5 million).", "default": 500 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. This is a US government open-data API with no anti-bot, so a proxy is not needed and only adds cost." } } }, "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 } } } } } } } } } }