# Alabama Business Registry Scraper (`parseforge/alabama-business-registry-scraper`) Actor

Scrape Alabama Secretary of State business entities by name: ID, type, status, formation date, registered agent and members. Export to CSV, Excel, JSON or XML.

- **URL**: https://apify.com/parseforge/alabama-business-registry-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.68 / 1,000 business record scrapeds

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

![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner-v3.webp)

## 🏛 Alabama Business Registry Scraper

> 🚀 **Export Alabama business entities in seconds.** Search arc-sos.state.al.us by entity name and get clean rows, with no account and no API key.

This Actor reads the Alabama Secretary of State business entity records (arc-sos.state.al.us). It returns one flat row per entity, ready for CSV, Excel, JSON or XML.

| 🎯 Target Audience | 💡 Primary Use Cases |
| --- | --- |
| Sales and lead generation teams | Find registered Alabama companies by name and confirm they are active |
| Lawyers and paralegals | Look up an entity before serving or contacting it |
| Banks, KYC and compliance teams | Check that a counterparty exists and what its standing is |
| Data teams | Seed or refresh an internal company table for Alabama |

### 📋 What the Alabama Business Registry Scraper does

- Searches the official Alabama source named above.
- Search types: EntityName.
- Returns one row per entity with the fields the registry publishes.
- Optional full details pass adds the extra fields the registry shows on each record.
- Reports the registry message when a search is too broad or not accepted, instead of failing silently.
- A search with no results, or input the Actor cannot use, ends the run as succeeded with an empty dataset, a clear status message and no charge.

**Coverage.** Alabama corporations, LLCs, partnerships and other registered entities. Alabama offers name search only. The registry answers US exits only, so the default proxy is Apify Proxy with a United States exit.

### 📊 Output

| Field | Type | Description |
| --- | --- | --- |
| 🏢 `corporateName` | string | Legal name of the entity as the registry prints it |
| 🔢 `documentNumber` | string | Registry file or ID number |
| 🧾 `corporationType` | string | Entity form or type |
| 🚦 `status` | string | Registry status of the entity |
| 📅 `dateFiled` | string | Formation or filing date, as printed |
| 📬 `principalAddress` | object | Principal office address: street, city, state, zip |
| 📮 `mailingAddress` | object | Mailing address: street, city, state, zip |
| 🧑‍💼 `registeredAgent` | object | Registered agent: name and address |
| 👥 `officers` | array | Officers, members or managers: title, name, address |
| 🔗 `detailUrl` | string | Link to the record on the registry site |
| 🕒 `scrapedAt` | string | ISO 8601 timestamp of the extraction |
| ❌ `error` | string | Message on a row with a partial problem, null otherwise |

Real records from a run:

```json
[
  {
    "corporateName": "Mercedes-Benz Assignment Services Americas LLC",
    "documentNumber": "000-614-656",
    "corporationType": "Foreign Limited Liability Company",
    "status": "Exists",
    "dateFiled": "10/22/2007",
    "principalAddress": {
      "street": "ONE MERCEDES-BENZ DRIVE",
      "city": "SANDY SPRINGS",
      "state": "GA",
      "zip": "30328"
    },
    "mailingAddress": {
      "street": "ONE MERCEDES-BENZ DRIVE",
      "city": "SANDY SPRINGS",
      "state": "GA",
      "zip": "30328"
    },
    "registeredAgent": {
      "name": "C T CORPORATION SYSTEM",
      "address": "2 NORTH JACKSON STREET SUITE 605, MONTGOMERY, AL 36104"
    },
    "officers": [],
    "detailUrl": "https://arc-sos.state.al.us/cgi/corpdetail.mbr/detail?corp=000614656&page=name&file=&type=ALL&status=ALL&place=ALL&city=",
    "scrapedAt": "2026-11-12T16:01:39.874Z",
    "error": null
  },
  {
    "corporateName": "Mercedes-Benz Club of Alabama and NW Florida, Inc",
    "documentNumber": "000-648-502",
    "corporationType": "Domestic Non-Profit Corporation",
    "status": "Exists",
    "dateFiled": "09/14/2020",
    "principalAddress": {
      "street": "3504 OLD LEEDS COURT",
      "city": "MOUNTAIN BROOK",
      "state": "AL",
      "zip": "35213-3206"
    },
    "mailingAddress": {
      "street": "3504 OLD LEEDS COURT",
      "city": "MOUNTAIN BROOK",
      "state": "AL",
      "zip": "35213-3206"
    },
    "registeredAgent": {
      "name": "HICKS, WILLIAM E",
      "address": "3504 OLD LEEDS CT, MOUNTAIN BROOK, AL 35213-3206"
    },
    "officers": [
      {
        "title": "Director",
        "name": "(person name as printed by the registry)",
        "address": "1398 CHAPEL ST HOOVER, AL 35253"
      }
    ],
    "detailUrl": "https://arc-sos.state.al.us/cgi/corpdetail.mbr/detail?corp=000648502&page=name&file=&type=ALL&status=ALL&place=ALL&city=",
    "scrapedAt": "2026-11-12T16:01:40.590Z",
    "error": null
  }
]
```

### ✨ Why choose this Actor

- **Official source.** Every row comes from arc-sos.state.al.us, not from a resold list.
- **Honest columns.** Only the columns the registry fills are in the output.
- **No charge for nothing.** Empty searches, rejected input and refused searches produce no billed result.
- **Plain HTTP.** No browser, no captcha solving, no workaround for site protections.
- **Clean tables.** Fixed column order, ready for CSV, Excel, JSON or XML.

### 🚀 How to use

1. Create a free Apify account. New accounts get $5 in free credit: [sign up here](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the Alabama Business Registry Scraper and click **Try for free**.
3. Choose the search type and type the name or number.
4. Set the maximum number of businesses you want.
5. Keep **Include full details** on if you need the extra fields, or turn it off for a faster list.
6. Click **Start**. When the run finishes, open the **Storage** tab and download CSV, Excel, JSON or XML, or pull the rows through the Apify API.

### 💼 Business use cases

#### Lead generation

Search a company name and keep only the entities with an active status, so your outreach list does not contain dissolved companies.

#### Counterparty checks

Confirm that a Alabama company exists, what type it is and when it was formed before you sign or pay.

#### Compliance and onboarding

Add a registry lookup to a KYC or supplier-onboarding flow through the Apify API.

### 🔌 Automating

- **Make and Zapier**: run the Actor on a schedule and push new entities into a CRM or a spreadsheet.
- **Airbyte**: sync the dataset into a warehouse.
- **Apify Scheduler**: run daily, weekly or hourly with no external tooling.

### ❓ Frequently Asked Questions

#### 🔍 Which searches does it support?

Entity name only. That is all the Alabama public search offers.

#### 🌎 Why a US proxy?

The Alabama host only answers connections from the United States.

#### 👥 What are members?

Alabama lists members, managers and officers on the detail page. They are returned in the officers column.

#### 📅 Why is a date or address empty?

Alabama prints "Not provided" for some fields. The Actor leaves them empty.

#### 🔑 Do I need an account or API key for the registry?

No. The Actor reads the public registry. There is nothing to sign up for and no key to paste.

#### 🧾 Is this personal data?

The Actor returns business entity records as the registry publishes them. It does not look anyone up elsewhere and adds nothing to what the registry prints. Use the data in line with the privacy and marketing laws that apply to you.

#### 📦 How many records can I export?

As many as the registry returns for the search, up to 1,000,000 on a paid plan. Free accounts are limited to 10 records per run.

#### 🛑 What happens when the registry does not answer?

If the registry keeps refusing the connection after a few retries, the run ends as failed with a message that says so, and nothing is charged. A search that simply finds nothing ends as succeeded with no rows.

#### 💰 What am I charged for?

One result per business record delivered. Empty searches, rejected input and refused searches are not charged for results. The prices are on the Pricing tab of the Actor page.

#### 📤 Which formats can I export?

CSV, Excel, JSON and XML from the Storage tab, or through the Apify API.

### 🔗 Recommended Actors

- [Sunbiz Florida Business Scraper](https://apify.com/parseforge/sunbiz-florida-business-scraper) for Florida business entities.
- [Colorado Business Registry Scraper](https://apify.com/parseforge/colorado-business-registry-scraper) for Colorado entities.

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge).

**🆘 Need Help?** [Open our contact form](https://tally.so/r/BzdKgA)

> **⚠️ Disclaimer:** This is an independent tool and is not affiliated with, endorsed by, or connected to any state agency. It collects only publicly available data.

# Actor input Schema

## `searchTerm` (type: `string`):

An Alabama entity name or part of it. Alabama offers a name search only in this database.

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

Maximum number of business records to collect. Free users are limited to 10 items, paid users can collect up to 1,000,000. Use 1 or more; 0 or a negative number ends the run with no results and no charge.

## `searchType` (type: `string`):

What the search term is matched against.

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

Open the registry page of each entity for the extra fields (addresses, registered agent, officers where the registry publishes them). One extra request per entity; turn it off for a faster list.

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

Proxy used for registry requests. The Alabama host only answers United States addresses, and the default Apify datacenter proxy (no country selected) gives one. Do not pin another country. The Actor uses only the exit you choose here and does not switch to another one by itself.

## Actor input object example

```json
{
  "searchTerm": "Mercedes",
  "maxItems": 10,
  "searchType": "EntityName",
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

Key fields in a readable table.

## `fullData` (type: `string`):

Complete dataset with every field.

# 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 = {
    "searchTerm": "Mercedes",
    "maxItems": 10,
    "searchType": "EntityName",
    "includeDetails": true,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/alabama-business-registry-scraper").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 = {
    "searchTerm": "Mercedes",
    "maxItems": 10,
    "searchType": "EntityName",
    "includeDetails": True,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/alabama-business-registry-scraper").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 '{
  "searchTerm": "Mercedes",
  "maxItems": 10,
  "searchType": "EntityName",
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call parseforge/alabama-business-registry-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/alabama-business-registry-scraper"
        }
    }
}
```

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/QPAbo9YqQ2GlDZUzh/builds/d8hZYYgEbLYx4htNd/openapi.json
