# San Francisco Registered Businesses Scraper (`scrapers_lat/sf-business-registrations-scraper`) Actor
Scrape registered business locations in San Francisco. Extract business name, owner, full address, neighborhood, supervisor district, business activity, registration dates and coordinates. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/sf-business-registrations-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (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 $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.
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
## San Francisco Registered Businesses Scraper
> Extract registered business locations across San Francisco, with business name, owner, full street address, neighborhood, supervisor district, business activity and registration dates, from the city's live directory of registered businesses.
360k+ records registered locations
36 neighborhoods citywide coverage
JSON / CSV / Excel output formats
Updated daily
### What you get
Each record is one registered business location in San Francisco: the business, its owner, where it operates and when it registered.
- **dbaName**: the business name (doing-business-as name)
- **ownershipName**: the legal owner or entity behind the business
- **businessType**: the registered business activity, for example Restaurant, Caterer, Massage Establishment, Tattoo and Piercing
- **businessTypeList**: full list of registered activities when a business has more than one
- **naicsCode**: North American Industry Classification System code, when present on the record
- **naicsDescription**: industry description for the NAICS code, when present
- **fullBusinessAddress**: street address of the business location
- **city**: city of the business location
- **state**: state of the business location
- **zip**: business ZIP code
- **neighborhood**: San Francisco neighborhood, for example Mission, Financial District/South Beach, Sunset/Parkside
- **businessCorridor**: named commercial corridor when the address sits on one, for example Ocean Ave
- **supervisorDistrict**: Board of Supervisors district (1 to 11)
- **communityBenefitDistrict**: community benefit district when the business sits inside one
- **mailingAddress**: owner mailing address line
- **mailCity**: owner mailing city
- **mailState**: owner mailing state
- **mailZip**: owner mailing ZIP
- **dbaStartDate**: date the business registered under this name
- **dbaEndDate**: date the registration ended, when closed
- **locationStartDate**: date the business started at this location
- **locationEndDate**: date the business left this location, when closed
- **isActive**: true when the business is still registered at the address
- **administrativelyClosed**: true when the record was administratively closed
- **parkingTax**: whether the business is flagged for parking tax
- **transientOccupancyTax**: whether the business is flagged for transient occupancy (hotel) tax
- **businessAccountNumber**: the city business account number
- **certificateNumber**: the registration certificate number
- **ttxid**: unique account-ownership-location identifier
- **uniqueId**: unique record identifier
- **latitude**: latitude of the business location
- **longitude**: longitude of the business location
- **dataAsOf**: date the source snapshot was current as of
- **observedAt**: when this record was collected by the scraper
### Who is it for
| Use case | Who benefits |
|---|---|
| Build local B2B lead lists of businesses by neighborhood and activity | Sales teams, agencies, service providers |
| Map competitors and market saturation across San Francisco | Founders, franchise and retail site planners |
| Reach newly registered businesses in their first months | Insurance, banking, payroll and SaaS vendors |
| Study small-business formation and closure by district | Analysts, economic development, journalists |
| Enrich a CRM with owner, address and coordinates | Growth and RevOps teams |
### Frequently Asked Questions
**What data does the San Francisco registered businesses scraper cover?**
It covers registered business locations across all of San Francisco: the business name and owner, full street address, neighborhood, supervisor district, registered business activity, registration dates and map coordinates. The directory holds over 360,000 location records.
**Is the data current?**
Yes. The directory is refreshed daily and this scraper reads the live snapshot. Results are sorted newest registered first, so a run surfaces the businesses that registered most recently rather than a stale archive.
**How many businesses can I scrape in one run?**
There is no fixed cap beyond the Max Items value you set. The scraper pages through the directory in batches, so a small run gives you the latest registrations and a large run can pull hundreds of thousands of records.
**Can I filter by neighborhood, activity or date?**
Yes. You can filter by neighborhood, supervisor district, ZIP code, business activity (for example Restaurant or Massage), active-only status and a registration date range, and you can search by business name or owner. Filters combine, so you can narrow to, for example, active restaurants registered in the Mission this year.
**Does it include the business owner and address?**
Yes. Each record includes the business name, the owner or entity name, the full business street address, the owner mailing address, the neighborhood, coordinates and registration dates. This is what makes the data useful for local lead generation and market mapping.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [Colorado Business Entity Scraper](https://apify.com/scrapers_lat/colorado-business-entities-scraper): Scrape Colorado Secretary of State business entities with registered agent and address details.
- [New York DOS Business Scraper](https://apify.com/scrapers_lat/ny-dos-business-scraper): Extract New York State registered business entities with filing and address data.
- [NYC DOB Building Permits Scraper](https://apify.com/scrapers_lat/nyc-dob-permits-scraper): Pull NYC building permits with contractor, owner and address details.
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with the City and County of San Francisco or its open data program. It only accesses data that is publicly available. Use it in accordance with the source's terms of service.
# Actor input Schema
## `query` (type: `string`):
Match on the business name (DBA) or the owner name, for example COFFEE, UBER or a person's name. Leave empty to browse all registered businesses.
## `maxItems` (type: `integer`):
Maximum number of business records to collect. Optional. Results are returned newest registered first.
## `neighborhood` (type: `string`):
Restrict to one San Francisco neighborhood. Leave as Any to include the whole city.
## `businessType` (type: `string`):
Match the registered business activity or line of business, for example RESTAURANT, MASSAGE, TATTOO, CATERER or BAR. Text match, case-insensitive.
## `supervisorDistrict` (type: `string`):
Restrict to one Board of Supervisors district (1 to 11).
## `activeOnly` (type: `boolean`):
When on, only businesses with no location end date (still registered at the address) are returned. When off, closed and past registrations are included too.
## `zip` (type: `string`):
Match businesses by 5-digit ZIP code, for example 94103.
## `startFrom` (type: `string`):
Only businesses whose registration (DBA start) date is on or after this date. Format YYYY-MM-DD, for example 2024-01-01.
## `startTo` (type: `string`):
Only businesses whose registration (DBA start) date is on or before this date. Format YYYY-MM-DD, for example 2026-06-30.
## `naicsCode` (type: `string`):
Optional. Filter by North American Industry Classification System code prefix, for example 722 for food service. Note this field is only present on a subset of records.
## `appToken` (type: `string`):
Optional. The San Francisco Open Data source is keyless, but a free app token raises the rate limit for very large pulls. Leave empty unless you have one.
## Actor input object example
```json
{
"maxItems": 50,
"neighborhood": "",
"supervisorDistrict": "",
"activeOnly": false
}
````
# Actor output Schema
## `results` (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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"query": "",
"maxItems": 50
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/sf-business-registrations-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"query": "",
"maxItems": 50,
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/sf-business-registrations-scraper").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 '{
"query": "",
"maxItems": 50
}' |
apify call scrapers_lat/sf-business-registrations-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/sf-business-registrations-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "San Francisco Registered Businesses Scraper",
"description": "Scrape registered business locations in San Francisco. Extract business name, owner, full address, neighborhood, supervisor district, business activity, registration dates and coordinates. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "e5VlIMDDKbvmGyfsC"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~sf-business-registrations-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-sf-business-registrations-scraper",
"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/scrapers_lat~sf-business-registrations-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-sf-business-registrations-scraper",
"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/scrapers_lat~sf-business-registrations-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-sf-business-registrations-scraper",
"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": {
"query": {
"title": "Business Name or Keyword",
"type": "string",
"description": "Match on the business name (DBA) or the owner name, for example COFFEE, UBER or a person's name. Leave empty to browse all registered businesses."
},
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of business records to collect. Optional. Results are returned newest registered first."
},
"neighborhood": {
"title": "Neighborhood",
"enum": [
"",
"Financial District/South Beach",
"Mission",
"South of Market",
"Sunset/Parkside",
"Bayview Hunters Point",
"Marina",
"Outer Richmond",
"Chinatown",
"Castro/Upper Market",
"Tenderloin",
"Nob Hill",
"West of Twin Peaks",
"Pacific Heights",
"Hayes Valley",
"Mission Bay",
"Potrero Hill",
"Inner Sunset",
"Inner Richmond",
"North Beach",
"Noe Valley",
"Bernal Heights",
"Russian Hill",
"Haight Ashbury",
"Excelsior",
"Western Addition",
"Presidio Heights",
"Outer Mission",
"Oceanview/Merced/Ingleside",
"Lone Mountain/USF",
"Portola",
"Lakeshore",
"Glen Park",
"Visitacion Valley",
"Japantown",
"Twin Peaks",
"Treasure Island",
"Seacliff"
],
"type": "string",
"description": "Restrict to one San Francisco neighborhood. Leave as Any to include the whole city.",
"default": ""
},
"businessType": {
"title": "Business Activity",
"type": "string",
"description": "Match the registered business activity or line of business, for example RESTAURANT, MASSAGE, TATTOO, CATERER or BAR. Text match, case-insensitive."
},
"supervisorDistrict": {
"title": "Supervisor District",
"enum": [
"",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11"
],
"type": "string",
"description": "Restrict to one Board of Supervisors district (1 to 11).",
"default": ""
},
"activeOnly": {
"title": "Active Businesses Only",
"type": "boolean",
"description": "When on, only businesses with no location end date (still registered at the address) are returned. When off, closed and past registrations are included too.",
"default": false
},
"zip": {
"title": "Business ZIP Code",
"type": "string",
"description": "Match businesses by 5-digit ZIP code, for example 94103."
},
"startFrom": {
"title": "Registered From",
"type": "string",
"description": "Only businesses whose registration (DBA start) date is on or after this date. Format YYYY-MM-DD, for example 2024-01-01."
},
"startTo": {
"title": "Registered To",
"type": "string",
"description": "Only businesses whose registration (DBA start) date is on or before this date. Format YYYY-MM-DD, for example 2026-06-30."
},
"naicsCode": {
"title": "NAICS Code",
"type": "string",
"description": "Optional. Filter by North American Industry Classification System code prefix, for example 722 for food service. Note this field is only present on a subset of records."
},
"appToken": {
"title": "Socrata App Token",
"type": "string",
"description": "Optional. The San Francisco Open Data source is keyless, but a free app token raises the rate limit for very large pulls. Leave empty unless you have one."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```