{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Scraper: USDOT & Trucking Companies", "description": "US trucking companies and motor carriers from the official FMCSA Census, no API key. USDOT lookup, or filter by state, city, ZIP, cargo, fleet size, hazmat, authority and registration date. Safety rating, website domain, suspect-fleet flag. Sole proprietors filtered out. No officer names or phones.", "version": "0.1", "x-build-id": "d9UcKkWK5KaFMNAn8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/responsible_front_evw~us-trucking-companies-fmcsa/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-responsible_front_evw-us-trucking-companies-fmcsa", "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/responsible_front_evw~us-trucking-companies-fmcsa/runs": { "post": { "operationId": "runs-sync-responsible_front_evw-us-trucking-companies-fmcsa", "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/responsible_front_evw~us-trucking-companies-fmcsa/run-sync": { "post": { "operationId": "run-sync-responsible_front_evw-us-trucking-companies-fmcsa", "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 codes of the carrier's physical address, for example TX, CA, FL, OH. Leave empty for the whole US.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Optional: exact city names as filed with FMCSA, for example HOUSTON, DALLAS. Combine with a state to avoid homonyms.", "items": { "type": "string" } }, "zipPrefixes": { "title": "ZIP code prefixes", "type": "array", "description": "Optional: ZIP codes or their first digits, for example 770 (Houston area) or 33101.", "items": { "type": "string" } }, "dotNumbers": { "title": "USDOT numbers (lookup)", "type": "array", "description": "Optional: look up these USDOT numbers (up to a few hundred per run). Combine with 'Only active carriers' = off to also get inactive ones.", "items": { "type": "string" } }, "nameContains": { "title": "Name contains", "type": "string", "description": "Optional: text in the legal or DBA name, for example LOGISTICS, COLD, EXPRESS." }, "activeOnly": { "title": "Only active carriers", "type": "boolean", "description": "Only USDOT numbers with status 'Active' in the census.", "default": true }, "addedWithinDays": { "title": "Registered in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Optional: only carriers whose USDOT number was added in the last N days (new trucking companies). The census is updated daily." }, "addedSince": { "title": "Registered since (date)", "type": "string", "description": "Optional: only carriers added on or after this date, YYYY-MM-DD." }, "updatedSince": { "title": "MCS-150 updated since (date)", "type": "string", "description": "Optional: only carriers that updated their MCS-150 registration form on or after this date, YYYY-MM-DD." }, "classifications": { "title": "Operation classification", "type": "array", "description": "Optional: keep carriers with any of these classifications.", "items": { "type": "string", "enum": [ "AUTHORIZED FOR HIRE", "EXEMPT FOR HIRE", "PRIVATE PROPERTY", "PRIVATE PASSENGER, BUSINESS", "PRIVATE PASSENGER, NON-BUSINESS", "MIGRANT", "U.S. MAIL", "FEDERAL GOVERNMENT", "STATE GOVERNMENT", "LOCAL GOVERNMENT", "INDIAN TRIBE", "OTHER" ], "enumTitles": [ "Authorized for hire", "Exempt for hire", "Private property", "Private passenger, business", "Private passenger, non-business", "Migrant", "U.S. mail", "Federal government", "State government", "Local government", "Indian tribe", "Other" ] } }, "carrierOperations": { "title": "Carrier operation", "type": "array", "description": "Optional: interstate, intrastate hazmat or intrastate non-hazmat.", "items": { "type": "string", "enum": [ "A", "B", "C" ], "enumTitles": [ "Interstate", "Intrastate hazmat", "Intrastate non-hazmat" ] } }, "cargoTypes": { "title": "Cargo carried", "type": "array", "description": "Optional: keep carriers that haul any of these cargo types.", "items": { "type": "string", "enum": [ "genfreight", "household", "metalsheet", "motoveh", "drivetow", "logpole", "bldgmat", "mobilehome", "machlrg", "produce", "liqgas", "intermodal", "passengers", "oilfield", "livestock", "grainfeed", "coalcoke", "meat", "garbage", "usmail", "chem", "drybulk", "coldfood", "beverages", "paperprod", "utility", "farmsupp", "construct", "waterwell", "cargoothr" ], "enumTitles": [ "General freight", "Household goods", "Metal: sheets, coils, rolls", "Motor vehicles", "Drive/tow away", "Logs, poles, beams, lumber", "Building materials", "Mobile homes", "Machinery, large objects", "Fresh produce", "Liquids/gases", "Intermodal containers", "Passengers", "Oilfield equipment", "Livestock", "Grain, feed, hay", "Coal/coke", "Meat", "Garbage/refuse", "U.S. mail", "Chemicals", "Commodities dry bulk", "Refrigerated food", "Beverages", "Paper products", "Utilities", "Agricultural/farm supplies", "Construction", "Water well", "Other" ] } }, "hazmatOnly": { "title": "Only hazmat carriers", "type": "boolean", "description": "Only hazmat carriers.", "default": false }, "withOperatingAuthorityOnly": { "title": "Only carriers with an MC/MX/FF docket number", "type": "boolean", "description": "Keeps carriers that have at least one operating-authority docket number.", "default": false }, "minPowerUnits": { "title": "Minimum power units (trucks/tractors)", "minimum": 0, "type": "integer", "description": "Minimum power units (trucks/tractors)." }, "maxPowerUnits": { "title": "Maximum power units", "minimum": 0, "type": "integer", "description": "Maximum power units." }, "minDrivers": { "title": "Minimum drivers", "minimum": 0, "type": "integer", "description": "Minimum drivers." }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest", "fleet", "dot" ], "type": "string", "description": "Sort by.", "default": "newest" }, "onlyNewSinceLastRun": { "title": "Only new since last run (alerts)", "type": "boolean", "description": "Skip carriers this same search already returned in earlier runs, so you do not pay twice for the same company. Ideal for a daily schedule.", "default": false }, "maxItems": { "title": "Max companies", "minimum": 1, "type": "integer", "description": "Maximum number of companies to return (you pay per company).", "default": 100 }, "maxScannedRows": { "title": "Max census rows to scan", "minimum": 100, "type": "integer", "description": "Safety limit on rows read from the census, including skipped sole proprietors and already-seen carriers.", "default": 5000 }, "requestDelaySecs": { "title": "Pause between API requests (seconds)", "minimum": 1, "type": "integer", "description": "Minimum 1 second (the open data portal asks for 1 second between requests).", "default": 2 } } }, "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 } } } } } } } } } }