# San Francisco Business Registry Search (DataSF open data) (`pennant/sf-registered-businesses`) Actor

Search San Francisco registered business locations from the Treasurer & Tax Collector: new businesses, restaurants, contractors, salons and more, by NAICS code, neighborhood, ZIP or start date. Businesses only; no personal names.

- **URL**: https://apify.com/pennant/sf-registered-businesses.md
- **Developed by:** [Pennant](https://apify.com/pennant) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 business location 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/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

## San Francisco Business Registry Search (DataSF open data)

**Pennant** — Official public records as clean, tested data feeds.

Search the business locations registered with the **San Francisco Office of the Treasurer & Tax Collector**, published on DataSF (the City's open data portal) and refreshed daily. Every business that operates in San Francisco must register, including out-of-town contractors and vendors who work in the City, so this is a broad list of **new and existing businesses**: restaurants, contractors, salons, property managers, consultants, shops and more. Each result is **one business location** with the business and DBA name, status, self-reported NAICS code, business and location start dates, city, ZIP, neighborhood and supervisor district.

This is not an official verification service. Confirm a registration with the Treasurer & Tax Collector before relying on it.

**Source:** DataSF, *Registered Business Locations - San Francisco* (`g8m3-pdis`), Office of the Treasurer & Tax Collector, PDDL v1.0 · refreshed daily. Full credit and the DataSF warranty terms are in the "Source, licence and disclaimer" section below.

### Who it's for

POS, payments, insurance, payroll and bookkeeping vendors looking for **newly registered San Francisco businesses**, commercial cleaning, signage and fit-out suppliers, food and beverage distributors who want new restaurants by neighborhood, and market researchers counting openings and closures by NAICS code or district.

**Use cases**

- A weekly feed of new San Francisco business locations, any industry, for POS, payroll or insurance outreach.
- New restaurants and bars by neighborhood (`naicsPrefixes: ["7225"]`) for food and beverage distributors.
- Electrical, plumbing and HVAC contractors working in specific neighborhoods.
- Counting openings and closures by NAICS code or supervisor district for research.

### Input examples

New restaurant and bar locations last month:

```json
{ "naicsPrefixes": ["7225", "7224"], "startedFrom": "2026-10-01", "startedTo": "2026-10-31", "maxItems": 500 }
```

Every new open business location this week, any industry, San Francisco addresses only:

```json
{ "cities": ["San Francisco"], "startedFrom": "2026-11-09", "startedTo": "2026-11-15", "maxItems": 1000 }
```

Open building-equipment contractors (electrical, plumbing, HVAC) in the Mission and South of Market:

```json
{ "naicsPrefixes": ["2382"], "neighborhoods": ["Mission", "South of Market"] }
```

Parking operators registered for parking tax:

```json
{ "onlyParkingTax": true, "sort": "name" }
```

The first example at a glance:

| Field | Example value | What it does |
|---|---|---|
| `naicsPrefixes` | `["7225", "7224"]` | Restaurants and bars |
| `startedFrom` / `startedTo` | `2026-10-01` / `2026-10-31` | Locations that started last month |
| `status` | `open` | Open locations only (default) |
| `maxItems` | `500` | Stop after 500 locations |

### Input

| Field | Type | Notes |
|---|---|---|
| `status` | `open` (default), `closed`, `all` | Open = no location or business end date and not administratively closed. |
| `naicsPrefixes` | string list | 2-6 digit NAICS prefixes, e.g. `7225` restaurants, `2382` building equipment contractors, `8121` personal care, `5311` lessors. Self-reported, not verified by the City. |
| `cities` | string list | City of the business location (case-insensitive). Empty = all, including out-of-town businesses registered to work in SF. |
| `zipCodes` | string list | 5-digit ZIPs. |
| `neighborhoods` | string list | SF analysis neighborhoods, e.g. `Mission`, `South of Market`, `Tenderloin`. |
| `supervisorDistricts` | string list | `1`-`11`. |
| `nameContains` | string | Case-insensitive substring of the business or DBA name. Only matches names that are returned. |
| `accountNumbers` | string list | Business account (certificate) numbers, e.g. `1190743`. |
| `startedFrom` / `startedTo` | YYYY-MM-DD | Inclusive location start-date range (new-business feed). |
| `onlyParkingTax` / `onlyHotelTax` | booleans | Only parking-tax or hotel (transient occupancy) tax registrants. |
| `sort` | `newest` (default), `oldest`, `name`, `accountNumber` | Date sorts skip rows without a location start date. |
| `maxItems` | integer | Default 100. Each location is one billable event. |
| `includeStreetAddress` | boolean | **Default off.** Adds the street line for business-named rows only. |
| `includeCoordinates` | boolean | **Default off.** Adds latitude/longitude for business-named rows only. |
| `requestDelayMs`, `maxRetries` | integers | Politeness delay (default 1,100 ms) and retries. |

Size on 2026-11-16 (source, before the privacy filter; changes daily): 369,658 location rows in total, of which 128,321 are open. Among rows with no end date (this count also includes administratively closed ones), 102,933 have a San Francisco address. About 1,000-1,450 new locations started per month in 2026 (Jan-Oct). 29,080 open locations have no NAICS code. Largest open NAICS codes: 531110 lessors of residential buildings 8,574, 531120 lessors of non-residential buildings 2,954, 531210 real estate agents and brokers 2,362, 722511 full-service restaurants 1,878.

### Sample output (one item per business location)

Street address and coordinates are omitted under the default privacy setting:

```json
{
  "locationId": "1437379-11-261-1190744",
  "businessAccountNumber": "1190744",
  "locationAccountId": "1437379-11-261",
  "ownershipName": "Empower Electrical Services",
  "dbaName": "Empower Electrical Services",
  "ownershipNameHidden": false,
  "status": "Open",
  "naicsCode": "238210",
  "businessStartDate": "2026-11-14",
  "businessEndDate": null,
  "locationStartDate": "2026-11-14",
  "locationEndDate": null,
  "administrativelyClosed": false,
  "licenseCode": null,
  "licenseDescription": null,
  "parkingTax": false,
  "hotelTax": false,
  "businessAddress": { "street": null, "city": "Livermore", "state": "CA", "zip": "94551" },
  "location": null,
  "neighborhood": null,
  "supervisorDistrict": null,
  "businessCorridor": null,
  "communityBenefitDistrict": null,
  "sourceDataAsOf": "2026-11-16",
  "issuingAgency": "San Francisco Office of the Treasurer & Tax Collector",
  "jurisdiction": "San Francisco, CA",
  "sourceDataset": "https://data.sf.gov/d/g8m3-pdis",
  "sourceRecordUrl": "https://data.sf.gov/resource/g8m3-pdis.json?uniqueid=1437379-11-261-1190744",
  "retrievedAt": "2026-11-16T13:00:10.026Z"
}
```

`status` is `Open`, `Closed` (location or business end date set) or `Administratively closed` (no filing or contact with the Treasurer & Tax Collector for 3 years, or closed after a notice from another City department).

**Example output as a table** (fictional rows, key columns only; street fields are null by default and not shown):

| businessAccountNumber | dbaName | naicsCode | locationStartDate | city | zip | neighborhood |
|---|---|---|---|---|---|---|
| 1300001 | Fog City Noodle Bar | 722511 | 2026-10-06 | San Francisco | 94110 | Mission |
| 1300002 | Bayside Wine Room LLC | 722410 | 2026-10-14 | San Francisco | 94107 | South of Market |
| 1300003 | Golden Gate Electric Inc | 238210 | 2026-10-21 | Daly City | 94014 | null |

### Privacy (always on)

Many San Francisco registrations are sole proprietors registered under their own name. This Actor **never outputs a person's name**:

- An owner name that looks like a person (no business word, a trust or estate, a professional title such as CPA or MD, or a "First Last LLC" style name) is hidden. If the location has a business-style DBA that does not repeat the person's name, the row is returned with `ownershipName: null` and `ownershipNameHidden: true`; otherwise the row is skipped.
- A DBA that looks like a person or a street address is returned as `null`.
- Rows with a hidden owner name never get a street address or map point, even with the opt-in switches on, because a sole proprietor's business location is often a home.
- **Mailing addresses are never requested or returned.** The source has no phone or email columns.
- A name search only matches names that are returned.

The filter is conservative, so some real businesses are skipped too. In a 1,000-row sample of recent locations (2026-11-16), 620 were returned (121 with the owner name hidden), 380 were skipped. Trade names can still contain a founder's surname (e.g. "Example Plumbing Inc"); those are business names as registered.

### Source, licence and disclaimer

Source: San Francisco Office of the Treasurer & Tax Collector, "Registered Business Locations - San Francisco", DataSF (dataset `g8m3-pdis`), made available under the **Open Data Commons Public Domain Dedication and License (PDDL) v1.0** and the DataSF Terms of Use. Attribution is not required by the PDDL; it is given here as good practice. Data modified by this tool: names filtered for privacy, mailing addresses removed, street and map point opt-in, dates reformatted.

DataSF Terms of Use (summary of the warranty clause): the City makes no representation or warranty that the information in the Data is accurate, true or correct; the information is subject to error and cannot be relied upon without verification or site inspection; the Data is provided "as is" and "as available" without warranties of any kind. NAICS codes are self-reported by the business and not verified by the City.

The Treasurer & Tax Collector is the authoritative source; data may be updated, corrected or overwritten at any time. robots.txt `Crawl-delay: 1` and `/resource/` not disallowed; the Actor waits at least 1.1 seconds between pages and identifies itself. Not affiliated with or endorsed by the City and County of San Francisco.

### Pricing

Pay per event, billed by Apify:

| Event | Price |
|---|---|
| Run start (`apify-actor-start`) | $0.005 per run |
| Each business location returned (`result`) | $0.002 per business location |

**Worked example:** one run that returns 200 business locations costs $0.005 + 200 × $0.002 = **$0.405**. A run of 1,000 business locations costs **$2.005**.

To control spend, set `maxItems` (the Actor never returns more), and set a maximum cost per run in Apify. The Actor stops cleanly when it reaches the caller's max charge, and the business locations already returned are kept.

### FAQ

**What does it cover, and what doesn't it?**

Business locations registered with the San Francisco Treasurer & Tax Collector, including out-of-town contractors and vendors registered to work in the City. It does not cover businesses elsewhere in the Bay Area that never registered in San Francisco, and NAICS codes are self-reported, not verified.

**What happens to personal names and addresses?**

The Actor never outputs a person's name. Owner names that look personal are hidden, and the row is kept only if a business-style DBA exists; otherwise it is skipped. Mailing addresses are never requested. Street address and map point are off by default and are never returned for rows with a hidden owner, even if you turn them on.

**Is this official data or a scrape?**

Official open data. The Actor reads each government portal's documented Socrata API, at a polite pace (at least 1.1 seconds between pages). It does not log in anywhere or scrape a private website.

**How do I cap the cost of a run?**

Set `maxItems`; each returned record is one billable result. The default is 100. You can also set a maximum cost per run in Apify, and the Actor stops cleanly when it reaches it.

**How fresh is the data?**

DataSF refreshes the dataset daily, and every run reads it live.

**Is Pennant affiliated with the source?**

No. Pennant is not affiliated with or endorsed by the City and County of San Francisco. The source agency is the authoritative record; confirm anything important with it.

**Where do I get help?**

Email 51wrw1aj@mail.grokbot.com. For a bad or unexpected record, include the run ID and the record's ID or licence number.

### For AI agents

- **Purpose:** list or search San Francisco registered business locations by NAICS code, status, city, ZIP, neighborhood, district, start date or name.
- **Call when:** the user wants new San Francisco businesses (a new-business feed), restaurants or contractors in a neighborhood, closures, parking or hotel tax registrants, or a lookup by business account number.
- **Minimal input:** `{}` (open locations, newest first, all industries).
- **Cost control:** one `result` event per location; set `maxItems`.

# Actor input Schema

## `status` (type: `string`):

Open = no location or business end date and not administratively closed (no filing for 3 years).

## `naicsPrefixes` (type: `array`):

2-6 digit NAICS prefixes, e.g. 7225 (restaurants), 2382 (building equipment contractors), 8121 (personal care), 5412 (accounting). Codes are self-reported by the business and not verified by the City.

## `cities` (type: `array`):

City of the business location, case-insensitive, e.g. San Francisco, Oakland. Empty = all (out-of-town businesses that registered to work in San Francisco are included).

## `zipCodes` (type: `array`):

5-digit ZIPs of the business location.

## `neighborhoods` (type: `array`):

San Francisco analysis neighborhoods, case-insensitive, e.g. Mission, South of Market, Financial District/South Beach, Tenderloin, Outer Richmond.

## `supervisorDistricts` (type: `array`):

1 to 11.

## `nameContains` (type: `string`):

Case-insensitive substring of the business (ownership) name or DBA (at least 2 characters). Only matches names that are returned.

## `accountNumbers` (type: `array`):

Treasurer & Tax Collector business account numbers (certificate numbers), e.g. 1190743.

## `startedFrom` (type: `string`):

YYYY-MM-DD, inclusive. Use with startedTo for a new-business feed.

## `startedTo` (type: `string`):

YYYY-MM-DD, inclusive.

## `onlyParkingTax` (type: `boolean`):

Only locations registered for San Francisco parking tax (parking operators).

## `onlyHotelTax` (type: `boolean`):

Only locations registered for transient occupancy (hotel) tax.

## `sort` (type: `string`):

Result order. Date sorts skip rows without a location start date.

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

Hard cap on results (each result is one billable event).

## `includeStreetAddress` (type: `boolean`):

If on, the street line of the business location is returned for business-named rows. Never returned for rows whose owner name is hidden. Mailing addresses are never returned.

## `includeCoordinates` (type: `boolean`):

If on, the source's latitude/longitude is returned for business-named rows (same rule as street).

## `requestDelayMs` (type: `integer`):

Politeness delay between API pages (robots.txt Crawl-delay: 1).

## `maxRetries` (type: `integer`):

Retries on timeouts, HTTP 408/429/5xx with exponential backoff and Retry-After.

## Actor input object example

```json
{
  "status": "open",
  "naicsPrefixes": [
    "7225"
  ],
  "onlyParkingTax": false,
  "onlyHotelTax": false,
  "sort": "newest",
  "maxItems": 100,
  "includeStreetAddress": false,
  "includeCoordinates": false,
  "requestDelayMs": 1100,
  "maxRetries": 4
}
```

# Actor output Schema

## `businesses` (type: `string`):

No description

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

No description

## `sourceNotice` (type: `string`):

No description

# 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 = {
    "naicsPrefixes": [
        "7225"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pennant/sf-registered-businesses").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 = { "naicsPrefixes": ["7225"] }

# Run the Actor and wait for it to finish
run = client.actor("pennant/sf-registered-businesses").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 '{
  "naicsPrefixes": [
    "7225"
  ]
}' |
apify call pennant/sf-registered-businesses --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pennant/sf-registered-businesses"
        }
    }
}
```

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/uKq5xwWjebNSdbb6u/builds/XxYDzc89HgJDcn8zY/openapi.json
