{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Leads – New Trucking Companies, Email & Insurance", "description": "New trucking companies from the official FMCSA census for insurance agents, factoring, freight brokers and ELD vendors: filter by registration date, state, fleet, cargo, authority and insurance, or look up USDOT/MC. Email, phone, officers. Daily onlyNew mode. $2 per 1,000.", "version": "0.2", "x-build-id": "nxdTvg9x4A4jpZ3zw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gazidev~fmcsa-carrier-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gazidev-fmcsa-carrier-leads", "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/gazidev~fmcsa-carrier-leads/runs": { "post": { "operationId": "runs-sync-gazidev-fmcsa-carrier-leads", "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/gazidev~fmcsa-carrier-leads/run-sync": { "post": { "operationId": "run-sync-gazidev-fmcsa-carrier-leads", "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 (physical address)", "type": "array", "description": "2-letter state codes, e.g. `TX`, `CA`, `FL`. Leave empty for all states (Canadian provinces and Mexican states also work). Full US state names (e.g. `Georgia`) are accepted too; numbers like `30303` are treated as ZIP codes.", "items": { "type": "string" } }, "registeredWithinDays": { "title": "Registered in the last N days", "minimum": 0, "maximum": 36500, "type": "integer", "description": "New-carrier leads: only USDOT numbers added in the last N days. Ignored when *Registered on/after* is set." }, "registeredAfter": { "title": "Registered on/after (date)", "type": "string", "description": "USDOT registration (add) date, YYYY-MM-DD." }, "registeredBefore": { "title": "Registered on/before (date)", "type": "string", "description": "Optional upper bound, YYYY-MM-DD." }, "city": { "title": "City", "type": "string", "description": "Exact city name (case-insensitive), e.g. `Houston`." }, "zipCodes": { "title": "ZIP codes or prefixes", "type": "array", "description": "Matches ZIP codes starting with these values, e.g. `770` for the Houston area.", "items": { "type": "string" } }, "status": { "title": "USDOT status", "enum": [ "active", "inactive", "pending", "all" ], "type": "string", "description": "FMCSA registration status.", "default": "active" }, "carrierTypes": { "title": "Carrier types", "type": "array", "description": "Any of the selected classes. Empty = all.", "items": { "type": "string", "enum": [ "for-hire", "exempt-for-hire", "private", "passenger" ], "enumTitles": [ "Authorized for-hire", "Exempt for-hire", "Private (own goods)", "Passenger carrier" ] } }, "operation": { "title": "Operation", "enum": [ "any", "interstate", "intrastate" ], "type": "string", "description": "Interstate carriers cross state lines.", "default": "any" }, "cargoTypes": { "title": "Cargo carried", "type": "array", "description": "Carriers that haul any of these cargo classes (from the MCS-150 form).", "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", "US Mail", "Chemicals", "Commodities Dry Bulk", "Refrigerated Food", "Beverages", "Paper Products", "Utilities", "Agricultural/Farm Supplies", "Construction", "Water Well", "Other" ] } }, "hazmat": { "title": "Hazmat", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "Hazardous-materials indicator.", "default": "any" }, "minPowerUnits": { "title": "Min power units (trucks/tractors)", "minimum": 0, "type": "integer", "description": "Fleet size filter. 0 = no minimum." }, "maxPowerUnits": { "title": "Max power units", "minimum": 0, "type": "integer", "description": "E.g. 5 for owner-operators and small fleets." }, "minDrivers": { "title": "Min drivers", "minimum": 0, "type": "integer", "description": "0 = no minimum." }, "maxDrivers": { "title": "Max drivers", "minimum": 0, "type": "integer", "description": "Optional." }, "nameContains": { "title": "Company name contains", "type": "string", "description": "Searches legal and DBA names." }, "mustHaveEmail": { "title": "Only carriers with an email address", "type": "boolean", "description": "Skip records without an email.", "default": false }, "mustHavePhone": { "title": "Only carriers with a phone number", "type": "boolean", "description": "Skip records without a phone.", "default": false }, "mustHaveMcNumber": { "title": "Only carriers with an MC/MX/FF docket number", "type": "boolean", "description": "Typical for for-hire interstate carriers and brokers.", "default": false }, "authorityStatus": { "title": "Operating authority status", "enum": [ "any", "active", "pending", "inactive", "none" ], "type": "string", "description": "Filter on FMCSA operating authority (Motus data). `pending` = authority application awaiting decision, often the carriers still shopping for insurance. Carriers that do not match are skipped and not charged.", "default": "any" }, "insuranceOnFile": { "title": "Liability insurance on file", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Filter on BIPD liability insurance filed with FMCSA. `no` includes carriers without an authority record (e.g. intrastate). Skipped carriers are not charged.", "default": "any" }, "dotNumbers": { "title": "Look up USDOT numbers", "type": "array", "description": "Direct lookup (up to 5,000). When used, the census filters above are ignored (authority / insurance filters and onlyNew still apply).", "items": { "type": "string" } }, "mcNumbers": { "title": "Look up MC / MX / FF numbers", "type": "array", "description": "E.g. `MC123456` or `123456` (up to 2,000). When used, all other filters are ignored.", "items": { "type": "string" } }, "includeAuthority": { "title": "Add operating authority & insurance on file", "type": "boolean", "description": "Common / contract / broker authority status, pending applications or revocations, liability insurance on file (where FMCSA publishes it; newest registrations may not be listed yet). Same price.", "default": true }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest", "largest-fleet", "dot-number" ], "type": "string", "description": "Order of results.", "default": "newest" }, "maxResults": { "title": "Max carriers", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Stop after this many carriers (0 = all matching, up to 200,000). You pay per carrier saved.", "default": 1000 }, "onlyNew": { "title": "Only new carriers (daily schedule mode)", "type": "boolean", "description": "Remember which carriers this search already delivered and return only carriers not delivered before. Ideal for a daily schedule with *Registered in the last N days*. State is kept per search (same filters = same search) in the named key-value store `fmcsa-carrier-leads-state` of your account. Skipped carriers are not charged.", "default": false }, "stateKey": { "title": "State key (optional)", "type": "string", "description": "Optional name for the onlyNew memory, e.g. `tx-insurance-daily`. Runs with the same key share one memory even if their filters differ. Leave empty to derive it from the filters." } } }, "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 } } } } } } } } } }