# Florida Business Registry Search (`vivid_astronaut/florida-business-registry-search`) Actor

Search Florida's official business registry (Sunbiz) by entity name. Get corporation details, document numbers, status, registered agents, officers and addresses as clean JSON. Ideal for due diligence, KYB verification and local lead generation.

- **URL**: https://apify.com/vivid\_astronaut/florida-business-registry-search.md
- **Developed by:** [Fabio Suizu](https://apify.com/vivid_astronaut) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 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.

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

## Florida Business Registry (Sunbiz) Search

Florida Business Registry (Sunbiz) Search extracts public business registration records from the official Florida Division of Corporations search site at `search.sunbiz.org`. The actor searches by entity name, reads the Sunbiz search results table, and can visit each entity detail page to collect filing information, principal and mailing addresses, registered agent details, officers or directors, and the most recent annual report year shown on the public record.

The source is the official public Florida business registry. Corporate registration data, officer data, document numbers, registered agent information, addresses, filing dates, and annual report references are published by the state as public records. This actor is designed for teams that need repeatable, structured access to those public records without manually searching the Sunbiz website one company at a time.

Sunbiz is protected by Cloudflare and normally requires a real browser session. For that reason this actor uses Crawlee with Playwright and is configured for Apify Proxy Residential by default. Keep residential proxy enabled for reliable production runs.

### What It Extracts

For every matching search result, the actor returns the corporate name, document number, status, and absolute detail URL. When detail extraction is enabled, each dataset item also includes the entity name, FEI/EIN number when present, filing status, filing date, principal address, mailing address, registered agent name and address, officer or director entries, and the last annual report year found on the page.

The actor never invents missing values. If Sunbiz does not show a field on a record, the output field is set to `null`, and officers are returned as an empty array when no officer section is available.

### Input

The main input is `searchTerms`, an array of business names or name fragments. Use exact names for verification workflows and broader fragments for prospecting or local market research.

`maxResultsPerTerm` limits how many search result rows are processed for each term. The default is 10 so the default run finishes quickly and stays under five minutes in normal conditions.

`includeDetails` controls whether the actor opens entity detail pages. Set it to `false` when you only need names, document numbers, statuses, and links.

`proxyConfiguration` defaults to Apify Proxy Residential. This is intentional because the official Sunbiz site is behind Cloudflare.

### Example Output

```json
{
  "searchTerm": "acme",
  "corporationName": "ACME GLOBAL, INC.",
  "documentNumber": "P06000011111",
  "status": "Active",
  "detailUrl": "https://search.sunbiz.org/Inquiry/CorporationSearch/SearchResultDetail?...",
  "detail": {
    "name": "ACME GLOBAL, INC.",
    "documentNumber": "P06000011111",
    "feiEin": "59-1234567",
    "status": "Active",
    "filingDate": "01/15/2006",
    "principalAddress": "100 Ocean Drive\nSuite 400\nMiami, FL 33139",
    "mailingAddress": "P.O. Box 1234\nMiami, FL 33101",
    "registeredAgent": {
      "name": "RODRIGUEZ, MARIA L",
      "address": "200 Brickell Avenue\nFloor 12\nMiami, FL 33131"
    },
    "officers": [
      {
        "title": "PRES",
        "name": "SMITH, JOHN A",
        "address": "100 Ocean Drive\nSuite 400\nMiami, FL 33139"
      }
    ],
    "lastAnnualReportYear": "2025"
  }
}
````

### Use Cases

Due diligence teams can verify whether a Florida company exists, whether it is active or inactive, when it was filed, and which public addresses and registered agent are on record.

KYB and onboarding teams can use the actor as a first pass for business identity checks before requesting additional documents from customers. The document number and filing status are useful stable identifiers for downstream review.

Local sales and lead generation teams can search by name fragments, neighborhoods, brand terms, or vertical keywords to build lists of Florida entities and route them into CRM enrichment workflows.

Compliance teams can monitor registered agent information and mailing addresses for vendors, counterparties, and portfolio companies that operate in Florida.

Investigators and analysts can quickly collect officer and director names shown in public Sunbiz filings and compare them with other official public data sources.

### Pricing

This actor is intended for pay-per-event pricing. A practical four-tier PPE structure is:

Starter: about $1.50 per 1,000 saved results for lightweight search-only usage.

Standard: about $1.90 per 1,000 saved results for common search and detail extraction workloads.

Business: about $2.30 per 1,000 saved results for higher-volume due diligence and enrichment runs.

Enterprise: about $2.70 per 1,000 saved results for large monitoring or integration workflows that require stronger proxy reliability and operational support.

Actual Store pricing is configured in the Apify Console and may differ from these guide levels.

### FAQ

Is this official data?

The actor reads records from the official Florida Division of Corporations Sunbiz search website. The actor is not affiliated with or endorsed by the State of Florida.

Is the data public?

Yes. Florida corporate registration records available through Sunbiz are public records. Users are responsible for using the data lawfully and respecting privacy, compliance, and contractual obligations that apply to their own use case.

Why does the actor use Playwright?

Sunbiz is behind Cloudflare. A browser-based crawler with residential proxy support is required for reliable access. Plain HTTP requests often receive a challenge page instead of registry data.

Can I run search-only jobs?

Yes. Set `includeDetails` to `false`. The actor will only save the search result rows with name, document number, status, and detail URL.

What happens when a field is missing?

Missing fields are returned as `null`. The parser does not infer FEI/EIN numbers, filing dates, addresses, officers, or report years.

How should I avoid oversized runs?

Start with specific search terms and keep `maxResultsPerTerm` low. Increase it gradually after confirming that the output matches your workflow.

Can this actor monitor companies?

Yes. Schedule repeat runs with exact entity names or stored company names, then compare output changes in your own database or automation.

# Actor input Schema

## `searchTerms` (type: `array`):

Business names or name fragments to search in the Florida Sunbiz business registry.

## `maxResultsPerTerm` (type: `integer`):

Maximum number of search result rows to process for each search term.

## `includeDetails` (type: `boolean`):

Open each entity detail page and extract filing information, addresses, registered agent, officers, and annual report data.

## `proxyConfiguration` (type: `object`):

Apify Proxy configuration. Residential proxy is required because Sunbiz is protected by Cloudflare.

## Actor input object example

```json
{
  "searchTerms": [
    "acme"
  ],
  "maxResultsPerTerm": 10,
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "searchTerms": [
        "acme"
    ],
    "maxResultsPerTerm": 10,
    "includeDetails": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("vivid_astronaut/florida-business-registry-search").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 = {
    "searchTerms": ["acme"],
    "maxResultsPerTerm": 10,
    "includeDetails": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("vivid_astronaut/florida-business-registry-search").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 '{
  "searchTerms": [
    "acme"
  ],
  "maxResultsPerTerm": 10,
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call vivid_astronaut/florida-business-registry-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=vivid_astronaut/florida-business-registry-search",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Florida Business Registry Search",
        "description": "Search Florida's official business registry (Sunbiz) by entity name. Get corporation details, document numbers, status, registered agents, officers and addresses as clean JSON. Ideal for due diligence, KYB verification and local lead generation.",
        "version": "0.1",
        "x-build-id": "hBd7Ed39sNHYmshwM"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/vivid_astronaut~florida-business-registry-search/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-vivid_astronaut-florida-business-registry-search",
                "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/vivid_astronaut~florida-business-registry-search/runs": {
            "post": {
                "operationId": "runs-sync-vivid_astronaut-florida-business-registry-search",
                "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/vivid_astronaut~florida-business-registry-search/run-sync": {
            "post": {
                "operationId": "run-sync-vivid_astronaut-florida-business-registry-search",
                "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",
                "required": [
                    "searchTerms"
                ],
                "properties": {
                    "searchTerms": {
                        "title": "Search terms",
                        "type": "array",
                        "description": "Business names or name fragments to search in the Florida Sunbiz business registry.",
                        "items": {
                            "type": "string",
                            "minLength": 1
                        },
                        "default": [
                            "acme"
                        ]
                    },
                    "maxResultsPerTerm": {
                        "title": "Max results per term",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Maximum number of search result rows to process for each search term.",
                        "default": 10
                    },
                    "includeDetails": {
                        "title": "Include detail pages",
                        "type": "boolean",
                        "description": "Open each entity detail page and extract filing information, addresses, registered agent, officers, and annual report data.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify Proxy configuration. Residential proxy is required because Sunbiz is protected by Cloudflare.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```