{
  "openapi": "3.0.1",
  "info": {
    "title": "FMCSA Trucking Scraper – New Carrier Leads, USDOT/MC Census",
    "description": "FMCSA trucking scraper for the official USDOT census, updated daily. New trucking companies and carrier leads by state, fleet size, cargo and add date. USDOT, MC number, phone, email, insurance and authority status. $2 per 1,000 leads. No login or API key.",
    "version": "0.1",
    "x-build-id": "ZXWgarsvOBfX0qcJA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dedicated_crest~fmcsa-trucking-carrier-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dedicated_crest-fmcsa-trucking-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/dedicated_crest~fmcsa-trucking-carrier-leads/runs": {
      "post": {
        "operationId": "runs-sync-dedicated_crest-fmcsa-trucking-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/dedicated_crest~fmcsa-trucking-carrier-leads/run-sync": {
      "post": {
        "operationId": "run-sync-dedicated_crest-fmcsa-trucking-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",
            "type": "array",
            "description": "US state abbreviations to include, for example TX, CA, FL. Leave empty for all states.",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Optional city filters. Use 'City, ST' (for example 'Dallas, TX') to pin the state, or a city name alone. Combined with States when both are set.",
            "items": {
              "type": "string"
            }
          },
          "zipCodes": {
            "title": "ZIP codes / prefixes",
            "type": "array",
            "description": "Optional ZIP codes or prefixes, for example 75201 or 752.",
            "items": {
              "type": "string"
            }
          },
          "dotNumbers": {
            "title": "USDOT numbers (lookup)",
            "type": "array",
            "description": "Look up specific USDOT numbers (DOT number lookup / list enrichment). When set, other filters are used as additional constraints.",
            "items": {
              "type": "string"
            }
          },
          "mcNumbers": {
            "title": "MC / MX / FF docket numbers (lookup)",
            "type": "array",
            "description": "Look up companies by MC / MX / FF docket number, for example MC150578 or 150578.",
            "items": {
              "type": "string"
            }
          },
          "nameContains": {
            "title": "Name contains",
            "type": "string",
            "description": "Optional text that must appear in the legal or DBA name, for example LOGISTICS."
          },
          "entityType": {
            "title": "Entity type",
            "enum": [
              "any",
              "carrier",
              "broker",
              "carrier_and_broker",
              "freight_forwarder",
              "shipper"
            ],
            "type": "string",
            "description": "Registered entity type from the census: motor carriers, freight brokers, both, freight forwarders, shippers, or any.",
            "default": "any"
          },
          "operationTypes": {
            "title": "Operation type",
            "type": "array",
            "description": "Optional carrier operation type: interstate, intrastate hazmat, or intrastate non-hazmat. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "interstate",
                "intrastate_hazmat",
                "intrastate_non_hazmat"
              ],
              "enumTitles": [
                "Interstate",
                "Intrastate hazmat",
                "Intrastate non-hazmat"
              ]
            }
          },
          "classification": {
            "title": "Operation classification",
            "enum": [
              "any",
              "for_hire",
              "private_property",
              "exempt_for_hire",
              "private_passenger"
            ],
            "type": "string",
            "description": "MCS-150 operation classification: authorized for-hire, private property, exempt for-hire, private passenger, or any.",
            "default": "any"
          },
          "usdotStatus": {
            "title": "USDOT status",
            "enum": [
              "active",
              "inactive",
              "any"
            ],
            "type": "string",
            "description": "USDOT registration status. Default is active only.",
            "default": "active"
          },
          "authorityStatus": {
            "title": "Operating authority (MC) status",
            "enum": [
              "any",
              "active",
              "broker_active",
              "pending",
              "none"
            ],
            "type": "string",
            "description": "Filter by FMCSA Licensing & Insurance operating-authority status (any, any active authority, active broker authority, pending application / new entrants, or no active authority). Applied after the census query, so add a state or city filter for large searches.",
            "default": "any"
          },
          "minPowerUnits": {
            "title": "Min power units (fleet size)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum trucks/tractors (power units), for example 5. Leave empty for no minimum."
          },
          "maxPowerUnits": {
            "title": "Max power units",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum power units, for example 10 for small fleets or owner-operators. Leave empty for no maximum."
          },
          "minDrivers": {
            "title": "Min drivers",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum total drivers, for example 3. Leave empty for no minimum."
          },
          "maxDrivers": {
            "title": "Max drivers",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum total drivers, for example 10. Leave empty for no maximum."
          },
          "cargoTypes": {
            "title": "Cargo types (any of)",
            "type": "array",
            "description": "Cargo carried (MCS-150). Matches companies that haul any of the selected cargo types. Leave empty for all cargo.",
            "items": {
              "type": "string",
              "enum": [
                "general_freight",
                "household_goods",
                "metal_sheets_coils_rolls",
                "motor_vehicles",
                "drive_tow_away",
                "logs_poles_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",
                "dry_bulk",
                "refrigerated_food",
                "beverages",
                "paper_products",
                "utilities",
                "agricultural_farm_supplies",
                "construction",
                "water_well",
                "other"
              ],
              "enumTitles": [
                "General Freight",
                "Household Goods",
                "Metal Sheets Coils Rolls",
                "Motor Vehicles",
                "Drive Tow Away",
                "Logs Poles 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",
                "Dry Bulk",
                "Refrigerated Food",
                "Beverages",
                "Paper Products",
                "Utilities",
                "Agricultural Farm Supplies",
                "Construction",
                "Water Well",
                "Other"
              ]
            }
          },
          "hazmatOnly": {
            "title": "Hazmat carriers only",
            "type": "boolean",
            "description": "If true, only carriers flagged as hazardous-materials carriers.",
            "default": false
          },
          "safetyRatings": {
            "title": "Safety rating",
            "type": "array",
            "description": "Optional FMCSA safety ratings to include: satisfactory, conditional, unsatisfactory, or not rated. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "satisfactory",
                "conditional",
                "unsatisfactory",
                "not_rated"
              ],
              "enumTitles": [
                "Satisfactory",
                "Conditional",
                "Unsatisfactory",
                "Not rated"
              ]
            }
          },
          "addedAfter": {
            "title": "USDOT added on/after",
            "type": "string",
            "description": "Only companies whose USDOT number was added on or after this date (new carriers). Format YYYY-MM-DD."
          },
          "addedBefore": {
            "title": "USDOT added on/before",
            "type": "string",
            "description": "Only companies whose USDOT number was added on or before this date. Format YYYY-MM-DD."
          },
          "requirePhone": {
            "title": "Only with phone",
            "type": "boolean",
            "description": "If true, skip records that have no phone number in the census.",
            "default": false
          },
          "requireEmail": {
            "title": "Only with email",
            "type": "boolean",
            "description": "If true, skip records that have no public email in the census.",
            "default": false
          },
          "includeAuthorityData": {
            "title": "Include authority status & history",
            "type": "boolean",
            "description": "If true (default), join FMCSA Licensing & Insurance authority status, BIPD insurance on file, and authority grant/revocation dates.",
            "default": true
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of companies to save and charge for (0 = no limit). Use a small number (for example 15) for a fast first run. The run also stops cleanly when your Maximum cost per run is reached.",
            "default": 25
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}