# US New Business Leads: New LLC & Company Filings by State (`euroscrape/us-new-companies`) Actor

New LLCs from the Secretary of State of Texas, New York, Colorado, CT, OR, PA and US business licenses (Chicago, Seattle, LA, SF): business formation data, new LLC leads, new companies USA, new businesses USA. New York business leads, Colorado business leads. New business filings alerts.

- **URL**: https://apify.com/euroscrape/us-new-companies.md
- **Developed by:** [EuroScrape](https://apify.com/euroscrape) (community)
- **Categories:** Lead generation, Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 new companies

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## US New Business Leads: New LLC & Company Filings by State

> **For AI agents:** use this Actor for newly registered US companies and LLCs from state registers (Texas, New York, Colorado, Connecticut, Oregon, Pennsylvania) and city business licences (Chicago, Seattle, Los Angeles, San Francisco). Minimal input: `{"daysBack": 5, "states": ["NY", "CO"], "maxItems": 50}`. Returns one row per company with name, legal form, registration date, activity, address and source.

Get the **companies newly filed in the United States**, straight from **official open data**: six state registers (New York, Colorado, Connecticut, Texas, Oregon, Pennsylvania) and four city business-license registers (Chicago, Seattle, Los Angeles, San Francisco). For each new company you get its **legal name, entity type, filing date, address, city, ZIP code**, the **activity (NAICS)** when the source publishes it, and a **link to the official record**. Daily, by state, by city, by keyword, with a monitor and alerts.

**Official data, no key, no login**: the Actor reads the open-data APIs of the states and cities themselves (Socrata), never a reseller. It returns companies only, **never the names of people**.

#### 🤖 At a glance (for people and AI assistants)

- **Use it when** you want **new business leads in the US** (new LLC filings, newly registered companies, new business licenses) from official registers, by state or city, with the filing date.
- **Minimal input**: `{ "daysBack": 7, "states": ["NY", "CO", "CT"], "maxItems": 100 }`
- **Output**: one row per company: `name`, `entityType` (llc, corporation…), `legalForm`, `registeredOn`, `address`, `city`, `postcode`, `stateCode`, `activity` (NAICS, where published), `area` (county), `sourceUrl`; plus one free `summary` row per source.
- **Price**: $3 per 1,000 companies, plus $0.003 per run. **The first 20 companies of every run and the summary rows are free.**
- **Not for**: searching an existing company by name or EIN, finding emails or phone numbers, or states not listed (the Actor covers 6 states and 4 cities whose registers are open data).
- **Look before you run**: the free [new US companies this week](https://euroscrape.com/tools/us-new-companies-this-week) viewer lists a state's latest filings in your browser and writes this Actor's input. New companies per city over 30 days: [new US companies by state and city](https://euroscrape.com/us/new-companies/).

### ✨ Why this Actor

| | |
|---|---|
| 🏛️ **Official registers, not a reseller** | New York Department of State, Colorado and Oregon Secretaries of State, Connecticut Secretary of the State, Texas Comptroller, Pennsylvania Department of State, and the business-license offices of Chicago, Seattle, Los Angeles and San Francisco. Every row links to the official open-data record. |
| 🆕 **Thousands every week** | Filing dates 31 Oct – 6 Nov 2026: 4,598 new companies in New York, 3,194 in Colorado, 918 in Connecticut, 339 in Oregon, plus 284 new business licenses in the four cities. Texas adds about 18,900 a month, Pennsylvania 7,600. |
| 📅 **Exact filing dates** | The official formation, charter or license date, not a crawl date: ask for last week, yesterday, or any window up to 400 days. |
| 🔎 **Filters that matter** | States and cities, city or county, keywords in the name (and in the activity where published), entity type (LLC, corporation, nonprofit, partnership), excluded words (holdings, trust…). |
| 🔔 **Monitor + instant alerts** | Give the search a monitor name and schedule it: each run returns **only companies not delivered before**, so you never pay twice for the same company. New companies can go to **Telegram, Discord, Slack or a webhook** (Make, Zapier, n8n, Google Sheets). |
| 🧾 **Clean, consistent fields** | Ten different registers, one schema: street case fixed, ZIP codes, state codes, entity families, NAICS text where published, county for New York and Pennsylvania. |
| 🔒 **Companies only** | No person's name is ever requested from the registers: no registered agents, organizers, officers or owners. Addresses are returned only when they are the company's own (see the FAQ). |
| ⚡ **Fast and cheap** | 1,500 companies from the ten sources in 7 seconds. $3 per 1,000. |

### 🎯 Use cases

- **New-business leads**: banks, insurers, accountants, payroll and software vendors, web agencies, office and equipment suppliers reach companies in their first days.
- **Local market watch**: every new company in Denver, Brooklyn or Austin this week; every new restaurant or salon licensed in Chicago.
- **Market research**: how many companies are formed per state, county and city, what share are LLCs, which activities (where the register publishes NAICS codes).
- **Data enrichment**: a daily feed of new entities with official identifiers, to match against your CRM or your own register data.

### 🚀 Examples

New companies in New York, Colorado and Connecticut in the last 7 days:

```json
{ "daysBack": 7, "states": ["NY", "CO", "CT"], "maxItems": 100 }
```

New LLCs in Denver and Brooklyn this month:

```json
{ "dateFrom": "2026-11-01", "states": ["CO", "NY"], "locations": ["Denver", "Brooklyn"], "entityTypes": ["llc"] }
```

New dental, coffee and roofing businesses in Connecticut and Chicago (name or NAICS activity), without holdings:

```json
{ "daysBack": 14, "states": ["CT", "CHI"], "keywords": ["dental", "coffee", "roofing"], "excludeKeywords": ["holdings"] }
```

Texas and Oregon, which publish with a delay: go back 30 days:

```json
{ "daysBack": 30, "states": ["TX", "OR"], "maxItems": 500 }
```

Every weekday, only the companies not delivered before, with a Slack alert:

```json
{ "daysBack": 3, "states": ["NY", "CO", "CT"], "monitorName": "new-companies-northeast", "slackWebhookUrl": "https://hooks.slack.com/services/..." }
```

### 📊 Data Report · 7 Nov 2026: one week of new companies in three states

Counted on 7 Nov 2026 in the official registers, filing dates 31 Oct – 6 Nov 2026 (seven days):

| Register | New companies in 7 days | On 6 Nov alone | Share of LLCs | Where |
|---|---:|---:|---:|---|
| New York | 4,598 | 716 | 72 % | Kings County (Brooklyn) 700, Albany 588, New York County (Manhattan) 488, Queens 472, Nassau 427, Suffolk 324 |
| Colorado | 3,194 | 486 | 89 % | Denver 894, Colorado Springs 246, Aurora 195, Fort Collins 86 |
| Connecticut | 918 | 97 | 95 % | Bridgeport, Fairfield, Waterbury |

- **Albany, second county of New York**, is not a start-up hub: it is where registered-agent services receive legal papers for companies based elsewhere. For those companies the register publishes the agent's address, not the company's, and this Actor returns **no address** rather than a wrong one (about 2 companies in 3 in New York).
- **Texas** published 18,918 new companies for 8 Oct – 6 Nov 2026 (Austin 2,957, Houston 2,560, Dallas 1,188), but only 32 for the last seven days: the Comptroller lists a company about ten days after its charter. Ask for 21 to 30 days to get Texas.
- **Oregon** (339 a week) updates its list weekly, **Pennsylvania** (7,604 a month) about monthly; the Actor says so in the log and in the summary row when your window is too recent for them.
- The four cities add new business **licenses** rather than formations: Chicago 103, Seattle 74, San Francisco 60, Los Angeles 47 in the same week.

### 📦 Output (a real company, Connecticut register, filed 7 Nov 2026; street number masked here)

```json
{
  "type": "company",
  "companyNumber": "CT-3546983",
  "name": "Gaynor Digital LLC",
  "tradeName": null,
  "legalForm": "Limited liability company (LLC)",
  "entityType": "llc",
  "registeredOn": "2026-11-07",
  "activity": "Custom Computer Programming Services (NAICS 541511)",
  "address": "•• Daniels Farm Rd, Trumbull, CT 06611",
  "city": "Trumbull",
  "postcode": "06611",
  "area": null,
  "stateCode": "CT",
  "stateName": "Connecticut",
  "sourceCode": "CT",
  "sourceKind": "state_register",
  "source": "Connecticut register (Secretary of the State)",
  "sourceUrl": "https://data.ct.gov/resource/n7gp-d28j.json?accountnumber=3546983&$select=accountnumber,name,status,date_registration,business_type,naics_code,billingcity,billingstate",
  "changeType": null,
  "scrapedAt": "2026-11-07T17:18:05.519Z"
}
```

One free `summary` row per source closes the dataset:

```json
{
  "type": "summary",
  "sourceCode": "CO",
  "source": "Colorado register (Secretary of State)",
  "from": "2026-10-31",
  "to": "2026-11-07",
  "companies": 162,
  "byEntityType": { "llc": 145, "corporation": 15, "nonprofit": 2 },
  "topCities": [{ "city": "Denver", "companies": 40 }, { "city": "Colorado Springs", "companies": 16 }, { "city": "Aurora", "companies": 12 }],
  "newestFilingDate": "2026-11-06",
  "oldestFilingDate": "2026-11-06",
  "publicationDelayNote": null
}
```

Fields: `companyNumber` (source code + official number, unique), `name`, `tradeName` (cities, when it is not a person's name), `legalForm` as published, `entityType` (llc, corporation, nonprofit, partnership, other), `registeredOn`, `activity` (NAICS text and code where published: Connecticut, Chicago, Seattle, Los Angeles, San Francisco), `address`, `city`, `postcode`, `area` (county, community area or neighbourhood), `stateCode`, `stateName`, `sourceCode`, `sourceKind` (`state_register` or `city_licenses`), `source`, `sourceUrl`, `changeType` (`new` with a monitor), `scrapedAt`. Export as JSON, CSV, Excel or XML.

### 💰 Pricing

| Event | Price |
|---|---|
| New company | **$3 / 1,000 companies** |
| Run start | $0.003 |

The 486 companies formed in Colorado on 6 Nov 2026 cost $1.40 (the first 20 are free), plus $0.003 for the run. Summary rows are free, and a run of 20 companies or fewer costs only the $0.003 start fee: test any state or keyword for free. Set a maximum charge per run in the run options: the Actor stops cleanly when it is reached.

### ❓ FAQ

- **Where does the data come from?** From the open-data portals of the states and cities (Socrata APIs): New York `data.ny.gov` (Active Corporations), Colorado `data.colorado.gov` (Business Entities), Connecticut `data.ct.gov` (Business Registry), Texas `data.texas.gov` (Active Franchise Taxpayers, Comptroller), Oregon `data.oregon.gov` (Active Businesses), Pennsylvania `data.pa.gov`, Chicago, Seattle, Los Angeles and San Francisco business-license datasets. All are published by the governments themselves under open licences.
- **Why these 6 states and 4 cities?** They are the registers published as continuously updated open data. Most other states publish nothing machine-readable, or sell bulk files. New states are added when their register opens.
- **How fresh is it?** New York, Colorado and Connecticut: the day after filing. Texas: about ten days after the charter date. Oregon: weekly. Pennsylvania: about monthly. Cities: a few days. The Actor logs a note and fills `publicationDelayNote` when your date window is too recent for a source.
- **Why do many New York companies have no address?** The New York register publishes the address where the company receives legal papers, which is often a registered agent's office in Albany or Manhattan. The Actor compares the recipient's name with the company's name on the register's side and returns the address only when it is the company's own (about 1 in 3). Pennsylvania publishes organizers' addresses: only the city, ZIP and county are returned.
- **Are names of people included?** No. The Actor never requests the columns that carry people's names (registered agents, organizers, officers, owners), and trade names that look like a person's name are dropped. It returns companies: legal entities only, formed in the state (foreign registrations are excluded).
- **Does it search an existing company by name or EIN?** Not in this version: it lists what was filed in the dates you choose. `keywords` filters the names (and the activity where published) within that window.
- **Does it give websites, emails or phones?** No: the registers do not publish them. For new companies **without a website**, see [No-Website Leads](https://apify.com/euroscrape/no-website-leads), which checks the web presence of these same companies.
- **What is `sourceKind`?** `state_register` rows are companies formed in the state; `city_licenses` rows are businesses that obtained a city license (Chicago, Seattle, Los Angeles, San Francisco): often shops and restaurants opening, which may be older companies opening a new location.

*Data sources: New York State Department of State, Colorado Secretary of State, Connecticut Secretary of the State, Texas Comptroller of Public Accounts, Oregon Secretary of State, Pennsylvania Department of State, City of Chicago, City of Seattle, City of Los Angeles, City and County of San Francisco (open data). Not affiliated with any of them.*

### 🔌 API, AI agents and integrations

- **API**: one call runs the Actor and returns the results, `POST https://api.apify.com/v2/acts/euroscrape~us-new-companies/run-sync-get-dataset-items` (see the API tab for Python, JavaScript and cURL).
- **AI agents (MCP)**: add `https://mcp.apify.com?tools=euroscrape/us-new-companies` to Claude, Cursor, VS Code or any MCP client, and the Actor becomes a tool your agent can call.
- **No-code automation**: start runs and pass the results on with Apify's integrations for n8n, Make and Zapier, or with a webhook when a run ends.
- **Exports**: every result set downloads as JSON, CSV, Excel or XML, and can be sent to Google Sheets.
- **Data Reports**: twice a week, EuroScrape turns a run of one of its Actors into a 30-second data report on [LinkedIn](https://www.linkedin.com/company/euroscrape). Follow the page to see what the data looks like.

### 🗓️ Run it on a schedule: only new companies

1. Set your filters and give the search a **monitor name**:

```json
{
  "daysBack": 3,
  "states": ["CO"],
  "locations": ["Denver"],
  "monitorName": "new-companies-denver",
  "webhookUrl": "https://hook.eu1.make.com/your-webhook-id"
}
```

2. In Apify Console, **save it as a task** and add a **schedule** to it (for example every weekday at 9:00).
3. The first run is the baseline: it returns the matching companies and remembers all of them. Every run after that returns **only the companies not delivered before** (`changeType: "new"`). With `daysBack: 3`, a missed day is caught up on the next run, and you pay only for what is new, plus the run start.

**Straight into Google Sheets:** put your Make, Zapier or n8n webhook address in `webhookUrl`. Each run sends one POST `{"count": N, "items": [...]}` with the new companies only (the baseline run sends nothing). Make: Custom webhook → Iterator on `items` → Google Sheets › Add a row.

**Instant alerts:** add `telegramBotToken` + `telegramChatId`, `slackWebhookUrl` or `discordWebhookUrl` to get one message per new company (up to `maxNotifications` per run, 30 by default). Messages carry the name, type, city and filing date, never the street address.

### ⭐ Your feedback

If this Actor saves you time, a short review on Apify Store helps other users find it. Missing a state, a field or a filter? Say it in your review: the most requested features are added first.

### 🔗 More from EuroScrape

- [French Companies: France SIRENE/SIRET Leads, KYB & BODACC](https://apify.com/euroscrape/france-companies): every French company from the official SIRENE register by activity, area and size, with directors, finances, BODACC insolvency check, VAT check and verified emails.
- [Google Maps No-Website Leads: Businesses Without Website](https://apify.com/euroscrape/google-maps-no-website-leads): local businesses on Google Maps that have no website of their own, double-checked: ready-made leads for web agencies.
- [No-Website Leads: New Businesses Without a Website (US, UK, FR)](https://apify.com/euroscrape/no-website-leads): newly registered UK and French companies with no website yet, with the creation date of their domain name.
- [UK Companies House Scraper: Directors, PSCs, Charges, UK Leads](https://apify.com/euroscrape/uk-companies): UK companies by SIC code and location, with directors, websites and emails.
- [Spain New Companies Scraper: BORME Registrations & Directors](https://apify.com/euroscrape/spain-companies): every company incorporated in Spain each weekday, from the official BORME gazette, with address, business purpose, share capital and appointed directors.
- [Impressum Scraper: Imprint Contact, Legal Notice, VAT, Registry](https://apify.com/euroscrape/company-identity): legal identity, registry numbers and VAT IDs from any website, registry-verified.
- [Trusted Shops Reviews Scraper: E-commerce Leads, Shop Leads](https://apify.com/euroscrape/trusted-shops-scraper): online shops of 11 European markets with their company, contacts, rating and review volume, plus customer reviews and alerts on negative ones.
- [Tech Stack Detector: Website Technology Lookup, CMS & Leads](https://apify.com/euroscrape/website-intelligence): technologies, company identity, contacts and sales signals for any website.
- [VAT Validation (VIES): Bulk EU VAT Number Checker & Alerts](https://apify.com/euroscrape/vat-validator): validate VAT numbers in bulk against the EU's official registry, with consultation proof for tax audits and alerts when a customer's number becomes invalid.
- [EU Tenders Scraper: TED Tenders, BOAMP & Tender Alerts](https://apify.com/euroscrape/eu-public-tenders): open tenders and contract awards from all of Europe (TED) and France (BOAMP, DECP), with winners per lot, values in € and daily alerts.
- [Construction Leads France: Building Permits (Sitadel) & Alerts](https://apify.com/euroscrape/france-building-permits): official register of French building permits — housing programmes and commercial buildings with the developer (name, SIREN), address, size and status, and alerts when works start.
- [Eventbrite Scraper: Events, Ticket Prices & Organizer Leads](https://apify.com/euroscrape/eventbrite-scraper): events for any city or online by keyword, category, date and price, with ticket prices, sold-out status, venue and organizer website.
- [France RGE & Qualiopi Scraper: Certified Company Leads](https://apify.com/euroscrape/france-certified-companies): official French lists: RGE contractors (entreprises RGE, artisans RGE, Qualibat, QualiPAC: heat pumps, solar, insulation.
- [Switzerland New Companies Scraper: Swiss Register (SOGC)](https://apify.com/euroscrape/switzerland-companies): new Swiss companies from the official SOGC commercial register publications: UID, legal form, canton, address, purpose, capital, daily, no key, first 20 free.
- [Google Flights Scraper 💰$0.10/1K: Cheapest Dates & Prices](https://apify.com/euroscrape/google-flights-prices): flight prices for any route and dates, cheapest day to fly, typical price range, CO2 and price-drop alerts.
- [Google Hotels Scraper 💰$2/1K (Google Travel): Hotel Prices](https://apify.com/euroscrape/google-hotels-prices): hotel prices for any destination and dates, with the price on every booking site, rate parity, price calendars and alerts.
- [Booking.com Scraper: Hotel Prices, Rate Calendar & Alerts](https://apify.com/euroscrape/booking-prices): Booking.com hotel prices for any city and dates, with guest ratings, deals and price-drop alerts.
- [Ryanair Low Fare Finder: Cheapest Fares, Routes, Days & Alerts](https://apify.com/euroscrape/ryanair-low-fares): Ryanair fare calendars months ahead, every destination under your price cap from any airport, and alerts on drops and new deals.
- [Vinted Search Scraper: 26 Countries, Prices & Alerts](https://apify.com/euroscrape/vinted-scraper): search Vinted across 26 countries, prices with buyer fees, seller ratings, cheapest-country comparison and instant alerts on new listings.
- [EU Second-Hand Marketplace Scraper: Price Gaps in 18 Countries](https://apify.com/euroscrape/eu-marketplace-deals): one search on the top second-hand marketplace of 18 European countries, prices in €, cheapest country and resale margin.
- [Kleinanzeigen Scraper: German Classifieds, Prices & Deal Alerts](https://apify.com/euroscrape/kleinanzeigen-scraper): German classifieds with view counts, full seller details and instant alerts.
- [Marktplaats & 2dehands Scraper: Listings, Bids & Price Alerts](https://apify.com/euroscrape/marktplaats-scraper): the Netherlands and Belgium (2dehands / 2ememain), with bids, views, deal scores and alerts.
- [Subito Scraper: Italian Listings, Cars, Real Estate & Alerts](https://apify.com/euroscrape/subito-scraper): all of Italy, cars and homes with price per m², deal scores and alerts.
- [Wallapop Scraper: Listings, Price Alerts & Deals (Spain, Italy)](https://apify.com/euroscrape/wallapop-scraper): Wallapop in Spain, Italy and Portugal, cars included, around a town with distance, deal scores and alerts.
- [willhaben Scraper: Marketplace, Cars & Real Estate (Austria)](https://apify.com/euroscrape/willhaben-scraper): Austria's marketplace, cars and flats with price per m², deal scores and alerts.
- [AutoScout24 Scraper: Used Car Listings Europe, Deals & Alerts](https://apify.com/euroscrape/autoscout24-scraper): used-car listings from 8 European countries with price, mileage, year and seller, a cross-country price comparison and alerts on new listings and price drops.
- [DVF France Scraper: Sold Property Prices, €/m² & Trends](https://apify.com/euroscrape/france-property-prices): every property sale registered by the French State — real prices, €/m², addresses, GPS, market trends per city and alerts on new sales.
- [DPE Scraper (France): Energy Certificates by Address, F/G List](https://apify.com/euroscrape/france-energy-ratings): official energy certificates of French homes — class, address, consumption, yearly bill — with the F/G energy sieves of any city and alerts on new certificates.
- [Gas Station Prices France: Diesel, E10, SP98 & Cheapest Alerts](https://apify.com/euroscrape/france-fuel-prices): live official prices of all ~10,000 French stations — cheapest Diesel, E10, E85 or LPG around any point, with distances and price-drop alerts.
- [Electricity Prices API (EU): Day-Ahead Hourly & Cheap Hours](https://apify.com/euroscrape/eu-electricity-prices): tomorrow's spot prices for 40+ European bidding zones, the cheapest 3-hour window of each day, negative-price alerts and years of history.
- [App Store Reviews Scraper + Google Play Reviews (All Countries)](https://apify.com/euroscrape/app-reviews): App Store and Google Play reviews in up to 175 countries, rating by version and country, free top charts and keyword ranks.
- [Google Trends Scraper & API (Free): Interest, Regions, Trending](https://apify.com/euroscrape/google-trends-free): interest over time, by region, rising searches, trending now with news.
- [Keyword Suggestions Tool (Free): Google, Amazon & YouTube](https://apify.com/euroscrape/keyword-suggestions-free): long-tail keywords from Google, YouTube, Amazon, Bing.
- [Broken Link Checker & Bulk URL Status Checker (Free)](https://apify.com/euroscrape/bulk-url-checker-free): status codes, redirects, broken links, SEO tags.
- [RSS Feed Reader (Free): Any Feed or Website to JSON, New Items](https://apify.com/euroscrape/rss-feed-reader-free): any feed or website to JSON and CSV, only new items.
- 📰 Data articles, daily data pages and real input/output examples for every Actor: [euroscrape.com](https://euroscrape.com).

* 📰 Data articles, daily data pages and real input/output examples for every Actor: [euroscrape.com](https://euroscrape.com).

# Actor input Schema

## `daysBack` (type: `integer`):

Companies filed in the last N days (by their official filing date). Ignored if 'From date' is set. Texas publishes about 10 days late, Oregon weekly, Pennsylvania monthly: use 21, 14 or 45 days for them.

## `dateFrom` (type: `string`):

First filing date to include (YYYY-MM-DD). Overrides 'Days back'.

## `dateTo` (type: `string`):

Last filing date to include (YYYY-MM-DD). Default: today.

## `states` (type: `array`):

Official open-data sources to read, by code: NY, CO, CT, TX, OR, PA (state registers), CHI, SEA, LA, SF (city licenses). Empty = all ten.

## `locations` (type: `array`):

Keep only companies in these cities (or counties for New York and Pennsylvania, neighbourhoods for San Francisco, community areas for Chicago), e.g. Brooklyn, Denver, Austin. Case does not matter. Empty = everywhere.

## `keywords` (type: `array`):

Keep only companies whose name contains one of these words (Connecticut, Seattle, Los Angeles, San Francisco and Chicago also match the activity), e.g. roofing, dental, coffee, consulting.

## `excludeKeywords` (type: `array`):

Drop companies whose name contains one of these words, e.g. holdings, trust, properties.

## `entityTypes` (type: `array`):

Legal families to keep. Empty = all.

## `includeSummary` (type: `boolean`):

Adds one free 'summary' row per state or city: companies found, by entity type, top cities, filing dates covered, known publication delay.

## `maxItems` (type: `integer`):

Stop after this many companies (summary rows are not counted).

## `monitorName` (type: `string`):

Give your saved search a name and schedule it: the first run is the baseline, every later run returns only companies not delivered before (changeType: "new"). Use different names for different searches.

## `telegramBotToken` (type: `string`):

Get a message for each new company. Create a bot with @BotFather and paste its token.

## `telegramChatId` (type: `string`):

Your chat or group ID (send /start to the bot first).

## `discordWebhookUrl` (type: `string`):

Channel settings → Integrations → Webhooks.

## `slackWebhookUrl` (type: `string`):

Slack app → Incoming Webhooks.

## `webhookUrl` (type: `string`):

One POST per run with {"count": N, "items": \[...]} for the new companies only.

## `maxNotifications` (type: `integer`):

Telegram, Discord and Slack messages per run (the webhook always receives everything).

## Actor input object example

```json
{
  "daysBack": 7,
  "states": [
    "NY",
    "CO",
    "CT"
  ],
  "includeSummary": true,
  "maxItems": 100,
  "maxNotifications": 30
}
```

# Actor output Schema

## `companies` (type: `string`):

One row per newly filed company: name, type, filing date, address, activity, official link.

## `summary` (type: `string`):

Companies per state or city, by entity type, top cities, dates covered.

## `runSummary` (type: `string`):

Counters for this run (sources, companies read and delivered, monitor baseline).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "daysBack": 7,
    "states": [
        "NY",
        "CO",
        "CT"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("euroscrape/us-new-companies").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "daysBack": 7,
    "states": [
        "NY",
        "CO",
        "CT",
    ],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("euroscrape/us-new-companies").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "daysBack": 7,
  "states": [
    "NY",
    "CO",
    "CT"
  ],
  "maxItems": 100
}' |
apify call euroscrape/us-new-companies --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,euroscrape/us-new-companies"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/vgVu1tn9MozNtwlOh/builds/DqbIPoWuqc27h6uC6/openapi.json
