{
  "openapi": "3.0.1",
  "info": {
    "title": "Secretary of State Business Search, KYB & New LLCs - 28 States",
    "description": "KYB business entity search across 28 US states + DC Secretary of State registers: company name in, entity id, status, type, formation date, registered agent, officers, addresses and filing history out. Plus new LLC and corporation filings by date from 11 states. $0.0015 per record.",
    "version": "0.2",
    "x-build-id": "xKRrQZdVGU5EmRVuG"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~new-business-filings-contact-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-new-business-filings-contact-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~new-business-filings-contact-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-new-business-filings-contact-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~new-business-filings-contact-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-new-business-filings-contact-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": {
          "mode": {
            "title": "What to do",
            "enum": [
              "entitySearch",
              "newFilings"
            ],
            "type": "string",
            "description": "Entity search (KYB): look company names up in each state's official business register. New filings: pull brand-new LLCs and corporations registered in a date window.",
            "default": "entitySearch"
          },
          "companyName": {
            "title": "Company name",
            "type": "string",
            "description": "The business to look up, e.g. Tesla or Acme Holdings LLC. Searched in every selected state's register."
          },
          "companyNames": {
            "title": "Company names (bulk)",
            "type": "array",
            "description": "Several businesses in one run (up to 100). Each name is searched in every selected state; duplicates are removed.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "Which states to search. Leave empty for every state the chosen mode covers: 29 registers in entity search (Alaska only when you select it: its register is a 79 MB download), 11 in new filings. Each option says which mode covers it; a state the chosen mode does not cover is skipped and named in the run summary.",
            "items": {
              "type": "string",
              "enum": [
                "AK",
                "AL",
                "AR",
                "AZ",
                "CO",
                "CT",
                "DC",
                "DE",
                "FL",
                "HI",
                "IA",
                "ID",
                "KY",
                "MA",
                "MN",
                "MO",
                "MS",
                "ND",
                "NJ",
                "NM",
                "NY",
                "OR",
                "PA",
                "RI",
                "SD",
                "TX",
                "WA",
                "WI",
                "WV",
                "WY"
              ],
              "enumTitles": [
                "Alaska (AK) - entity search",
                "Alabama (AL) - entity search",
                "Arkansas (AR) - entity search",
                "Arizona (AZ) - entity search",
                "Colorado (CO) - entity search + new filings",
                "Connecticut (CT) - entity search + new filings",
                "District of Columbia (DC) - entity search + new filings",
                "Delaware (DE) - entity search",
                "Florida (FL) - entity search + new filings",
                "Hawaii (HI) - entity search",
                "Iowa (IA) - entity search + new filings",
                "Idaho (ID) - entity search",
                "Kentucky (KY) - entity search",
                "Massachusetts (MA) - entity search",
                "Minnesota (MN) - entity search",
                "Missouri (MO) - entity search",
                "Mississippi (MS) - entity search + new filings",
                "North Dakota (ND) - entity search",
                "New Jersey (NJ) - entity search",
                "New Mexico (NM) - entity search",
                "New York (NY) - entity search + new filings",
                "Oregon (OR) - entity search + new filings",
                "Pennsylvania (PA) - entity search + new filings",
                "Rhode Island (RI) - new filings",
                "South Dakota (SD) - entity search",
                "Texas (TX) - entity search + new filings",
                "Washington (WA) - entity search",
                "Wisconsin (WI) - entity search",
                "West Virginia (WV) - entity search",
                "Wyoming (WY) - entity search"
              ]
            },
            "default": []
          },
          "matchMode": {
            "title": "Name match",
            "enum": [
              "contains",
              "starts",
              "exact"
            ],
            "type": "string",
            "description": "Contains: every business whose name includes your words. Starts with: names beginning with them. Exact: the registered legal name (punctuation and spacing ignored, so \"Tesla Inc\" finds \"TESLA, INC.\"). Registers whose own search only matches from the start of the name return starts-with matches in contains mode (see the README table).",
            "default": "contains"
          },
          "maxResultsPerState": {
            "title": "Max results per state",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Cap on records per company name in each state. Raise it for broad names that match many businesses.",
            "default": 25
          },
          "includeDetails": {
            "title": "Include details (officers, agent, addresses)",
            "type": "boolean",
            "description": "Open each matching record's detail page where the register keeps officers, the registered agent, addresses and filing history there. Off = a faster name, status and id check. Same price either way.",
            "default": true
          },
          "residentialFallback": {
            "title": "Retry blocked registers through a residential proxy",
            "type": "boolean",
            "description": "When a register refuses the direct connection twice, try once more through a US residential proxy before reporting it as not answered.",
            "default": true
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 0,
            "maximum": 366,
            "type": "integer",
            "description": "New filings from this many days ago through today (each state's own local date). Ignored when \"Filed on or after\" is set. Florida and Rhode Island are selected by the date the state published the file. Max 366.",
            "default": 7
          },
          "sinceDate": {
            "title": "Filed on or after (YYYY-MM-DD)",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Optional fixed start date for new filings. Overrides \"Days back\"."
          },
          "untilDate": {
            "title": "Filed on or before (YYYY-MM-DD)",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Optional end date for new filings. Defaults to today."
          },
          "entityKinds": {
            "title": "Entity kinds",
            "type": "array",
            "description": "New filings: keep only these kinds (empty = all). \"assumed-name\" is an Oregon assumed business name (DBA).",
            "items": {
              "type": "string",
              "enum": [
                "llc",
                "corporation",
                "nonprofit",
                "partnership",
                "assumed-name",
                "other"
              ],
              "enumTitles": [
                "LLC",
                "Corporation",
                "Nonprofit",
                "Partnership (LP, LLP, LLLP)",
                "Assumed business name (Oregon DBA)",
                "Other (trusts, cooperatives)"
              ]
            },
            "default": []
          },
          "includeForeign": {
            "title": "Include foreign registrations",
            "type": "boolean",
            "description": "New filings: foreign = formed in another state or country and registered here (often an existing company expanding). Switch off to keep only businesses formed in the state.",
            "default": true
          },
          "excludeCommercialAgents": {
            "title": "Only owner-side registered agents",
            "type": "boolean",
            "description": "New filings: drop filings whose registered agent is a commercial registered-agent, formation, law or accounting firm. What remains lists the owner, an insider or the business itself as agent. Unclassified agents are kept.",
            "default": false
          },
          "requireContact": {
            "title": "Only filings with a contact",
            "type": "boolean",
            "description": "New filings: keep only filings that carry a business email, an agent phone, or a named contact person.",
            "default": false
          },
          "zipPrefixes": {
            "title": "ZIP codes or prefixes",
            "type": "array",
            "description": "New filings: keep only filings whose address ZIP starts with one of these (e.g. 331 for Miami, 80202). Rhode Island publishes no business address, so a ZIP filter removes its filings.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "nameKeywords": {
            "title": "Name keywords",
            "type": "array",
            "description": "New filings: keep only entities whose name contains one of these words (case-insensitive), e.g. roofing, dental. Sent to the source as a filter where it supports one.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyNew": {
            "title": "Only filings not delivered before (monitor mode)",
            "type": "boolean",
            "description": "New filings: remember every filing delivered with these filters and skip it on later runs - schedule the actor daily with a 7-14 day window and every filing is delivered and charged once.",
            "default": false
          },
          "maxItems": {
            "title": "Max filings",
            "minimum": 1,
            "type": "integer",
            "description": "New filings: stop after this many filings (the cost cap), shared fairly across the selected states.",
            "default": 100
          },
          "socrataAppToken": {
            "title": "Socrata app token (optional)",
            "type": "string",
            "description": "New filings: optional free app token from any Socrata portal (e.g. data.colorado.gov) for very large runs. Not needed normally."
          },
          "proxyConfiguration": {
            "title": "Proxy (new filings)",
            "type": "object",
            "description": "New filings: every source is a public government feed, so a direct connection is the default. A request that fails direct is retried once through a US residential proxy automatically.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}