# Usa Business Leads Extractor (`b2b_lead_generation/usa-business-leads-extractor`) Actor

The ultimate USA B2B contact finder. Query and extract verified business leads instantly by target categories or primary registry classifications. High-velocity lookup returning direct phone numbers, public emails, websites, and physical locations.

- **URL**: https://apify.com/b2b\_lead\_generation/usa-business-leads-extractor.md
- **Developed by:** [B2B Lead Generation](https://apify.com/b2b_lead_generation) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 results

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## USA Business Leads Extractor 💼✨

<p align="center">
  <img src="https://imgur.com/TLfq9Ca.png" alt="USA Business Leads Extractor Banner" style="max-width:100%; border-radius:14px; width:680px;" />
</p>

#### ⚡ Instant USA B2B Contact Finder & Professional Leads Extractor

Deploy a state-of-the-art contact intelligence solution to search, filter, and extract verified **American business leads and professional services contacts** across thousands of specialized industries. Powered by a high-velocity lookup engine, this extractor delivers immediate, frictionless access to verified business names, direct phone numbers, email addresses, official websites, and complete physical locations.

Whether you are compiling targeted B2B contact lists, fueling outbound sales pipelines, or driving enterprise recruitment campaigns, this extractor lets you define precise query parameters and download structured leads in seconds—completely bypassing traditional web scraping delays, IP blocks, and costly CAPTCHA-solving configurations.

---

### 🎯 High-Value Capabilities

* **Targeted Industry Search**: Extract leads from professional service sectors, including custom home builders, expert arborists, certified estheticians, financial planners, veterinary clinics, legal consultants, and more.
* **Registry-Level Filtering**: Narrow your search to primary business classifications or registry categories to retrieve highly relevant contacts with zero waste.
* **Flexible Matching Logic**: Toggle between *Any Character Match* (partial substring matching to capture related fields) and *Full Word Match* (strict word boundary matching to ensure precise listings).
* **Adjustable Output Limits**: Conduct small test runs of 100 listings or compile large-scale enterprise campaigns of up to 100,000 listings in a single run.
* **Multi-Keyword Processing**: Enter multiple category keywords or classification filters simultaneously. The extractor automatically processes, deduplicates, and aggregates results into a clean, unified file.

---

### 💼 High-Impact Use Cases

* **B2B Outbound Outreach**: Build laser-targeted contact lists of active US professional services firms for high-converting direct cold-calling, physical mailers, or localized B2B campaigns.
* **Cold Email Prospecting**: Populate your sales funnels and automated sequences with verified public email addresses mapped directly to specific industry categories.
* **Market Density Analysis**: Evaluate local competitor density and evaluate business counts by cross-referencing states, cities, or zip codes in your exported files.
* **Data Enrichment**: Update or expand your current CRM contact lists with verified telephone contacts, physical addresses, and active website URLs.

---

### ⚙️ Input Configuration

The extractor is fully customizable. For optimal results, we recommend defining at least one keyword in the `categories` list or choosing at least one category in the `sourceCategories` list.

#### Parameter Breakdown

| Field Name | Type | Description |
|:---|:---|:---|
| **Categories** (`categories`) | `array` | Specific keywords to search within business names or sub-categories. Case-insensitive and supports multi-line lists (e.g., `tree`, `builder`, `design`). |
| **Source Categories** (`sourceCategories`) | `array` | Pre-defined primary professional directory registries to filter by (e.g., `Arborists`, `Builders`, `Estheticians`). |
| **Match Type** (`matchType`) | `select` | Choose retrieval strictness: <br>• `any_character`: Matches any partial substring (e.g., `design` matches `Interior Designers`, `Graphic Design`). <br>• `full_word`: Enforces strict word boundaries to avoid unrelated partial matches. |
| **Leads Limit** (`limit`) | `integer` | Maximum number of structured leads to return. <br>• **Min:** `100` <br>• **Max:** `100,000` <br>• **Default:** `500` |

---

#### Configuration Examples

##### 🔍 Example 1: Standard Sector Query
Retrieve professional contacts from a single primary classification.
```json
{
    "sourceCategories": ["Arborists"],
    "matchType": "any_character",
    "limit": 1000
}
````

##### 🔍 Example 2: Multi-Sector Prospecting Run

Combine multiple registry categories into a single, merged B2B campaign list.

```json
{
    "sourceCategories": ["Arborists", "Builders", "Estheticians"],
    "matchType": "any_character",
    "limit": 5000
}
```

##### 🔍 Example 3: Laser-Focused Keyword Matching

Filter directories by specific high-intent keyword phrases with strict word-boundary matching.

```json
{
    "categories": ["Tree service", "Arborist care"],
    "sourceCategories": ["Arborists"],
    "matchType": "full_word",
    "limit": 2500
}
```

***

### 📊 Output Data Format

Results are delivered in real-time. Once the run completes, you can download your leads in **JSON, CSV, Excel, XML, or HTML** formats directly from the platform console.

#### Sample Record (JSON)

```json
{
    "name": "Acme Arborist Services",
    "categories": "Tree service;Arborists;Stump removal;Tree care;Emergency tree service",
    "phone": "+12125550199",
    "email": "contact@acmearborists.com",
    "address": "123 Maple Ave, Los Angeles, CA 90001",
    "website": "https://www.acmearborists.com/",
    "source_category": "Arborists",
    "scrapedAt": "2026-06-08T10:28:36.000Z"
}
```

#### Column Specifications

| Key | Type | Description |
|:---|:---|:---|
| `name` | `string` | The official business or registered practitioner name. |
| `categories` | `string` | Semicolon-separated secondary industry tags and service descriptions. |
| `phone` | `string` | Standardized telephone contact number for direct outreach. |
| `email` | `string` | Publicly listed direct contact email address (where available). |
| `address` | `string` | Complete physical location, including street address, city, state, and ZIP. |
| `website` | `string` | Verified URL of the business website. |
| `source_category` | `string` | The primary professional directory category used to retrieve the listing. |
| `scrapedAt` | `string` | ISO UTC timestamp recording the exact time of lead retrieval. |

***

### 📂 Primary Supported Registry Sectors

Filter by these primary classification values in `sourceCategories` or use them directly as keywords in your search:

#### 🏠 Construction, Building & Home Services

- `Builders`: Custom home builders, construction contractors, and residential builders.
- `Log_Home_Builders`: Specialized log cabin and rustic timber home construction builders.
- `Home_Inspectors`: Certified residential and commercial property inspectors.
- `Handymen`: General property repair, home maintenance, and handyperson services.
- `Siding_and_window_companies`: Exterior renovation, siding installation, and window replacement contractors.
- `Tile_Installation`: Professional tiling, ceramic, and stone flooring installers.
- `Garage_door_companies`: Garage door installation, repair, and overhead door service providers.
- `Pool_companies`: Swimming pool builders, maintenance, and pool cleaning service providers.
- `Mold_Remediation_Companies`: Certified mold inspection, removal, and water damage restoration firms.
- `Septic_Tank_Installation_Companies`: Septic system design, excavation, and tank installation contractors.
- `Well_Installation_Companies`: Water well drilling, pump installation, and well-water service professionals.
- `Chimney_sweeps`: Chimney inspection, cleaning, and fireplace repair technicians.
- `Radon_Mitigation_Companies`: Radon gas testing and home mitigation ventilation system installers.

#### ⚕️ Health, Medicine & Wellness

- `Veterinarians`: Animal hospitals, veterinary clinics, and pet doctors.
- `Psychologists`: Licensed clinical psychologists, therapists, and mental health counselors.
- `Orthodontists`: Orthodontic clinics, teeth alignment, and braces specialists.
- `Podiatrists`: Foot and ankle medical specialist clinics.
- `Endodontist`: Endodontic dental care, root canal specialist clinics.
- `Periodontists`: Periodontal gum disease therapy and dental implant specialists.
- `Optometrist`: Optometry clinics, eye doctors, and vision care centers.
- `Estheticians`: Professional skincare clinics, facial treatments, and aesthetic beauty providers.
- `Message_Therapists`: Massage therapists, spa clinics, and bodywork practitioners.
- `Occupational_Therapists` / `Occupational_Therapist`: Specialized physical/occupational rehabilitation therapists.
- `Nutritionists`: Nutritional counselors, weight loss clinics, and dietary health advisors.
- `Homeopath`: Homeopathic medicine practitioners and natural remedy advisors.
- `Holistic_Medicine_Practitioner` / `Holistic_Medicine_Practices`: Holistic medical care clinics and doctors.
- `Reiki_Therapist`: Energy healing practitioners and Reiki therapy centers.
- `Integrative_Medicine_Practices`: Integrative medical practitioners blending traditional and complementary healthcare.
- `Pain_Management_Centers`: Specialized clinical centers for chronic pain management.
- `Nursing_Home`: Assisted living facilities, nursing homes, and senior residential care homes.

#### 🎨 Design, Arts & Creative Industries

- `Interior_Designers`: Interior design firms, home decorators, and space planning consultants.
- `Graphic_Design_Companies`: Professional graphic design studios, branding firms, and creative agencies.
- `Event_Photography`: Wedding photographers, portrait artists, and corporate event photo studios.
- `Art_Galleries`: Contemporary art galleries, exhibitions, and fine art dealers.
- `Film_Production_Company`: Video production studios, commercial filming companies, and cinematography firms.
- `Custom_Jewelry_Designers`: Custom jewelry design houses, bespoke ring creators, and fine jewelers.
- `Dance_Studios`: Dance instruction schools, choreographers, and dance studios.
- `Music_Instructor`: Music schools, private piano/guitar teachers, and vocal coaches.

#### 💼 Professional Services & Consulting

- `Arborists`: Tree surgeons, tree care services, and professional arborist consultants.
- `Financial_Planner`: Wealth advisors, investment planners, and personal finance consultants.
- `Business_Broker`: Business brokerage firms, commercial transaction advisors, and business M\&A brokers.
- `mortgage_brokers`: Licensed mortgage brokers, home loan advisors, and refinancing specialists.
- `Executive_Search_Firm`: Headhunters, staffing agencies, and professional talent acquisition firms.
- `Private_investigators`: Private detective agencies and licensed background investigators.
- `Structural_Engineers`: Certified structural engineering consultants and building blueprint assessors.
- `Travel_Agents`: Specialized travel consultancies, vacation planners, and travel advisors.
- `Moving_Companies`: Local and interstate moving, packing, and relocation services.
- `Tailoring_and_Alterations`: Custom clothing tailoring, suit fittings, and alteration shops.
- `Blacksmith`: Custom ironworkers, hand-forged metal artists, and blacksmithing shops.

#### 🍕 Food, Dining & Entertainment

- `Bakeries`: Artisan bakeries, custom wedding cake designers, and pastry shops.
- `Pizzerias`: Pizza restaurants, delivery parlors, and Italian dining locations.
- `Delis`: Specialty delicatessens, sandwich shops, and fine food delis.
- `Diners`: Traditional American diners and breakfast restaurants.
- `Brazilian_Steakhouses`: Fine Brazilian rodizio and steakhouse dining establishments.
- `Breweries_`: Craft breweries, microbreweries, and local taprooms.
- `Escape_Rooms`: Interactive escape game venues and entertainment centers.

#### ⛵ Leisure, Sports & Outdoors

- `Boat_Rentals`: Boat charters, yacht rentals, and marine recreation services.
- `Yacht_Broker`: Professional yacht brokers and marine vessel dealers.
- `Outdoor_Adventure_Guides`: Wilderness guides, outdoor recreation instructors, and eco-tour guides.
- `Horse_Boarding_Stable`: Equestrian centers, horse boarding, and riding lesson stables.
- `SCUBA_Instructor`: Certified scuba diving instruction, dive shops, and underwater tour guides.
- `Skydiving_instructor`: Skydiving training schools and tandem jump operations.
- `Shooting_Range`: Licensed firing ranges, gun safety instruction, and shooting sports complexes.
- `Golf_Coursees`: Golf courses, country clubs, and professional golf resorts.

#### ⚡ Technical, Trade & Specialty

- `Locksmiths`: Emergency locksmiths, key cutting, and commercial security installers.
- `Equipment_rental`: Heavy machinery, tool rentals, and party/event equipment hire.
- `Solar_Panel_Sales_and_Installation`: Solar energy consultants, solar panel installers, and clean-energy companies.
- `Manufactured_home_sales`: Prefabricated, mobile, and manufactured home sales centers.
- `Thermal_Energy_Company`: Geothermal and thermal energy design or service providers.
- `Taxidermists`: Professional animal taxidermy services.
- `Private_Tutor`: Private academic tutoring, test prep, and educational consultants.
- `Wedding_Planning`: Wedding planning agencies, bridal consultants, and event coordinators.
- `Psychic`: Psychic readings, tarot card readers, and spiritual consultants.

<p align="center">
  <img src="https://imgur.com/0maVi0S.png" alt="USA Business Leads Extractor Primary Sectors" style="max-width:100%; border-radius:14px; width:680px;" />
</p>

#### 🔗 Comprehensive Category Reference

For a complete listing of all indexed registry categories, refer to the online index:
👉 [All USA Business Leads Categories Directory](https://github.com/kawsarlog/automatic-text/blob/main/USA%20Business%20Leads%20Extractor.txt)

***

### 🗺️ Geographic Coverage

Our high-velocity index tracks and retrieves business details across all **50 United States**. You can easily filter or segment your exported lists by state, city, or ZIP code. Top metropolitan regions include:

- **California (CA):** Los Angeles, San Diego, San Jose, San Francisco, Fresno, Sacramento, Oakland, Anaheim.
- **New York (NY):** New York City, Brooklyn, Queens, Buffalo, Rochester, Yonkers, Albany.
- **Texas (TX):** Houston, San Antonio, Dallas, Austin, Fort Worth, El Paso, Arlington, Plano.
- **Florida (FL):** Jacksonville, Miami, Tampa, Orlando, St. Petersburg, Tallahassee, Fort Lauderdale.
- **Illinois (IL):** Chicago, Aurora, Rockford, Joliet, Naperville, Springfield, Peoria, Champaign.
- **Pennsylvania (PA):** Philadelphia, Pittsburgh, Allentown, Erie, Reading, Scranton, Harrisburg.

***

### 💡 Pro Tips for Maximum Lead Quality

1. **Broaden Initial Searches**: Use broad root keywords in your search (e.g., `service` instead of `tree service`) to capture multiple related business listings in a single pass.
2. **Batch Multiple Classifications**: To build comprehensive campaigns, pass multiple primary categories (e.g., `["Arborists", "Builders"]`) in the `sourceCategories` array.
3. **Enhance Match Precision**: If you receive too many adjacent results, change the `matchType` parameter to `full_word` to enforce strict string boundaries.
4. **Post-Extraction Filtering**: Extract your leads to the desired limit, download them as a CSV, and use spreadsheet filters (Excel, Google Sheets) to instantly filter for records that contain verified emails or phone numbers.

***

### 🔄 Automated B2B Integrations & Workflows

Connect the **USA Business Leads Extractor** directly with your active software stack using native integrations:

- **Spreadsheets**: Auto-sync and append extracted leads to Google Sheets in real-time.
- **CRM Systems**: Push fresh contact records directly into Salesforce, HubSpot, ActiveCampaign, or Pipedrive.
- **Workflows**: Connect via Zapier, Make, or webhooks to instantly trigger automated cold outreach sequences or validation pipelines.

<p align="center">
  <img src="https://imgur.com/n9Z1gwP.png" alt="B2B Integration Workflows" style="max-width:100%; border-radius:12px; width:680px;" />
</p>

***

### ❓ Frequently Asked Questions

> **Do I need to configure proxy settings?**
> No proxy configuration is required. The extractor runs on a fully optimized, high-performance search pipeline, delivering instant results without IP blocks, rate limits, or scraping delays.

> **Why do some leads not contain an email address?**
> Email addresses are only extracted when they are listed publicly by the business. For leads without emails, the extractor provides verified direct-dial telephone numbers, website URLs, and physical addresses, allowing for multi-channel outreach (phone, mail, contact forms).

> **Can I search for multiple categories simultaneously?**
> Yes. Enter multiple categories (one per line) in either the `categories` or `sourceCategories` fields. The extractor will query them in sequence and automatically deduplicate any overlapping records.

> **Why did my run finish with fewer results than the requested limit?**
> The extractor will stop once it reaches your specified limit OR when there are no more matching records for your selected category keywords in the directories. If this happens, try using broader search keywords to expand your target pool.

# Actor input Schema

## `categories` (type: `array`):

List of industry categories to filter (e.g. 'Tree service', 'Arborist', 'Dentist'). Leave empty to ignore or filter by source categories only.

Full list of all USA Business Leads Service Categories: https://github.com/kawsarlog/automatic-text/blob/main/USA%20Business%20Leads%20Extractor.txt

## `sourceCategories` (type: `array`):

List of source categories to filter (e.g. 'Arborists', 'Builders', 'Estheticians'). Leave empty to ignore or filter by general categories only.

## `matchType` (type: `string`):

Choose between 'Any Character Match' (partial substring search) and 'Full Word Match' (checks exact word boundaries).

## `limit` (type: `integer`):

Maximum number of leads to return (min 100, max 100,000).

## Actor input object example

```json
{
  "categories": [
    "Tree service"
  ],
  "sourceCategories": [
    "Arborists"
  ],
  "matchType": "any_character",
  "limit": 500
}
```

# 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 = {
    "categories": [
        "Tree service"
    ],
    "sourceCategories": [
        "Arborists"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("b2b_lead_generation/usa-business-leads-extractor").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 = {
    "categories": ["Tree service"],
    "sourceCategories": ["Arborists"],
}

# Run the Actor and wait for it to finish
run = client.actor("b2b_lead_generation/usa-business-leads-extractor").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "categories": [
    "Tree service"
  ],
  "sourceCategories": [
    "Arborists"
  ]
}' |
apify call b2b_lead_generation/usa-business-leads-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=b2b_lead_generation/usa-business-leads-extractor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Usa Business Leads Extractor",
        "description": "The ultimate USA B2B contact finder. Query and extract verified business leads instantly by target categories or primary registry classifications. High-velocity lookup returning direct phone numbers, public emails, websites, and physical locations.",
        "version": "0.0",
        "x-build-id": "GzeaIafPLdLA4UzQd"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/b2b_lead_generation~usa-business-leads-extractor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-b2b_lead_generation-usa-business-leads-extractor",
                "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/b2b_lead_generation~usa-business-leads-extractor/runs": {
            "post": {
                "operationId": "runs-sync-b2b_lead_generation-usa-business-leads-extractor",
                "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/b2b_lead_generation~usa-business-leads-extractor/run-sync": {
            "post": {
                "operationId": "run-sync-b2b_lead_generation-usa-business-leads-extractor",
                "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": {
                    "categories": {
                        "title": "Categories",
                        "type": "array",
                        "description": "List of industry categories to filter (e.g. 'Tree service', 'Arborist', 'Dentist'). Leave empty to ignore or filter by source categories only.\n\nFull list of all USA Business Leads Service Categories: https://github.com/kawsarlog/automatic-text/blob/main/USA%20Business%20Leads%20Extractor.txt",
                        "items": {
                            "type": "string"
                        }
                    },
                    "sourceCategories": {
                        "title": "Source Categories",
                        "type": "array",
                        "description": "List of source categories to filter (e.g. 'Arborists', 'Builders', 'Estheticians'). Leave empty to ignore or filter by general categories only.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "matchType": {
                        "title": "Match Type",
                        "enum": [
                            "any_character",
                            "full_word"
                        ],
                        "type": "string",
                        "description": "Choose between 'Any Character Match' (partial substring search) and 'Full Word Match' (checks exact word boundaries).",
                        "default": "any_character"
                    },
                    "limit": {
                        "title": "Leads Limit",
                        "minimum": 100,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Maximum number of leads to return (min 100, max 100,000).",
                        "default": 500
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
