{
  "openapi": "3.0.1",
  "info": {
    "title": "FMCSA Motor Carrier Census & Trucking Leads Scraper",
    "description": "Export millions of official FMCSA motor carrier records with USDOT numbers, company contacts, fleet size, drivers, authority, cargo and safety fields. Filter active carriers, states, operation type, fleet size and fresh registrations. No API key required.",
    "version": "1.0",
    "x-build-id": "YDj97N7pc1fgrBQJ6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/logiover~fmcsa-motor-carrier-census-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-logiover-fmcsa-motor-carrier-census-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/logiover~fmcsa-motor-carrier-census-scraper/runs": {
      "post": {
        "operationId": "runs-sync-logiover-fmcsa-motor-carrier-census-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/logiover~fmcsa-motor-carrier-census-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-logiover-fmcsa-motor-carrier-census-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": {
          "maxResults": {
            "title": "Maximum carrier records",
            "minimum": 1,
            "maximum": 500000,
            "type": "integer",
            "description": "Maximum number of matching carriers to save. Raise up to 500,000 for bulk exports.",
            "default": 1000
          },
          "statusCodes": {
            "title": "FMCSA status codes",
            "type": "array",
            "description": "A means active. Use an empty list to include active and inactive census records.",
            "items": {
              "type": "string"
            },
            "default": [
              "A"
            ]
          },
          "states": {
            "title": "Physical address state codes",
            "type": "array",
            "description": "Optional two-letter US state or territory codes, for example TX, CA or FL.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "carrierOperations": {
            "title": "Carrier operation codes",
            "type": "array",
            "description": "Optional FMCSA operation codes: A interstate, B intrastate hazmat, C intrastate non-hazmat.",
            "items": {
              "type": "string",
              "enum": [
                "A",
                "B",
                "C"
              ],
              "enumTitles": [
                "A — Interstate",
                "B — Intrastate hazmat",
                "C — Intrastate non-hazmat"
              ]
            },
            "default": []
          },
          "addedSince": {
            "title": "Added since",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Only carriers added to the census on or after this date. Use YYYY-MM-DD or leave empty.",
            "default": ""
          },
          "nameContains": {
            "title": "Company name contains",
            "type": "string",
            "description": "Case-insensitive fragment matched against legal and DBA names.",
            "default": ""
          },
          "minPowerUnits": {
            "title": "Minimum power units",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers reporting at least this many powered vehicles.",
            "default": 0
          },
          "minDrivers": {
            "title": "Minimum drivers",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers reporting at least this many drivers.",
            "default": 0
          },
          "hasEmail": {
            "title": "Require an email address",
            "type": "boolean",
            "description": "Only return census records with a non-empty contact email.",
            "default": false
          },
          "hazmatOnly": {
            "title": "Hazardous-material carriers only",
            "type": "boolean",
            "description": "Only return records with the FMCSA hazmat indicator.",
            "default": false
          },
          "cargoTypes": {
            "title": "Cargo types",
            "type": "array",
            "description": "Optional cargo categories. A carrier is kept when it reports at least one selected category.",
            "items": {
              "type": "string",
              "enum": [
                "GENERAL_FREIGHT",
                "HOUSEHOLD_GOODS",
                "METAL_SHEETS_COILS",
                "MOTOR_VEHICLES",
                "DRIVE_TOW",
                "LOGS_POLES",
                "BUILDING_MATERIALS",
                "MOBILE_HOMES",
                "MACHINERY",
                "FRESH_PRODUCE",
                "LIQUIDS_GASES",
                "INTERMODAL",
                "PASSENGERS",
                "OILFIELD",
                "LIVESTOCK",
                "GRAIN_FEED",
                "COAL_COKE",
                "MEAT",
                "GARBAGE",
                "US_MAIL",
                "CHEMICALS",
                "DRY_BULK",
                "REFRIGERATED_FOOD",
                "BEVERAGES",
                "PAPER_PRODUCTS",
                "UTILITIES",
                "FARM_SUPPLIES",
                "CONSTRUCTION",
                "WATER_WELL",
                "OTHER"
              ]
            },
            "default": []
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}