# South Dakota Contractor License Lookup & Leads Scraper (`scrapebench/south-dakota-contractor-license-lookup`) Actor

Contractors licensed by eight South Dakota cities (Sioux Falls, Rapid City, Watertown, Brandon, Spearfish, Mobridge, Hermosa, Madison): business name, licence holder, trade, phone, street address where listed, licence number, expiry and status. Export the list or look up a firm or licence number.

- **URL**: https://apify.com/scrapebench/south-dakota-contractor-license-lookup.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.004 / license match

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

## South Dakota Contractor License Lookup & Leads Scraper

### Pain points

- South Dakota has no statewide general-contractor licence: cities license contractors, so a South Dakota contractor list has to be read city by city.
- Each city publishes its list in its own form: Sioux Falls a workbook with ten trade sheets plus separate bonded and sewer/water lists, Rapid City a PDF of every licence it has issued, Watertown, Brandon, Spearfish, Mobridge, Hermosa and Madison their own pages and files, each with different columns.
- The lists do not agree on what they print: only Watertown lists an e-mail, several print no street address, and licence numbers restart on every source and sheet or are missing altogether.

### What we solve

- Eight city registers read in full and merged into one list, about 5,100 licences, each row tagged with the city it comes from.
- Phone on nearly every row, and the street address and licence holder's name wherever the city prints them.
- Trade or licence type on every row, in the city's own words, with the expiry date where the city prints one; Rapid City rows also say whether the licence is unexpired or expired.
- Rows without a printed licence number kept apart by company and holder, so none collapse into another.
- Looks up business names or licence numbers on the current lists.

### Summary

Contractors licensed by eight South Dakota cities, about 5,100 licences in all. South Dakota has no statewide general-contractor licence; cities license contractors. In the November 2026 lists: Sioux Falls, ten trades (about 1,314 licences, street address on 100% of rows and phone on 99.9%) plus its bonded right-of-way list (about 142) and sewer and water list (about 42); Rapid City, about 3,020 licences from the city's all-contractors list (invoice, receipt, owner-builder permit and other non-contractor entries left out) (licence number, type, issue and expiry date, company, street address and phone on four rows in five), including expired licences, each marked with an expiry status; Watertown, 202 licences with name, phone, record number, type and the only e-mail in the set (201 of 202); Brandon, 177 building and 14 landscape-irrigation licences with street address and phone; Spearfish, 321 with owner, trade and phone; Mobridge, 53 with name and phone; Hermosa, 26 with name, phone and trade; Madison, 13 electricians, 5 plumbers and 1 sidewalk licence with company, licensee and phone (Madison's source files are dated 2024). The other cities list licensees in force only, so their rows come marked Active, with the expiry date where the city prints one; Rapid City's list keeps expired licences, so its rows come marked Active or Expired from the expiry date. Exports read a stored copy of the lists (its date is in the run log); lookups search the current lists. Pay only per licence returned.

### Who it's for

- Building-material suppliers and distributors selling to contractors working in South Dakota cities
- Subcontractors and staffing firms looking for contractors licensed in Sioux Falls, Rapid City, Watertown, Brandon, Spearfish and nearby
- Property managers and developers checking a contractor's city licence
- Insurers and bonding agents reaching South Dakota trades

### How to use

This actor does two jobs. Run it, then collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API).

**Get a list (export):** no names, just filters; returns the whole matching list.

```json
{
  "maxResults": 1000
}
```

**Check specific firms (lookup):** put company names or licence numbers in `mode`, `queries`; **Inputs** below says how each is matched.

```json
{
  "mode": "lookup",
  "queries": [
    "127 BUILDERS",
    "8685"
  ],
  "maxResults": 20
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `license_number` | Licence number as the city issued it (restarts on every source and sheet; blank on some lists, including Spearfish, Mobridge, Hermosa and Madison) |
| `license_type` | The trade or licence type the city lists it under (Residential Building, Plumbing, Electrical, Residential / Commercial / Both …) |
| `business_name` | Company name as listed |
| `address` | Business street address (Sioux Falls, Rapid City, Brandon, Watertown where listed; none for Spearfish, Mobridge, Hermosa) |
| `city` | City |
| `address_state` | State of the address (SD, MN, IA …); firms on lists without an address are tagged SD even if based out of state |
| `zip_code` | ZIP code, where the city prints an address |
| `phone` | Phone as listed |
| `email` | E-mail (Watertown only; no other city lists one) |
| `status` | Active for licences in force; Expired for an expired Rapid City licence (the other lists print licences in force only) |
| `expiration_date` | Licence expiry (YYYY-MM-DD) where the city prints one (not Hermosa; some Rapid City rows have none) |
| `extras.expiry_status` | Rapid City rows only: Unexpired, Expired or No expiry date, from the expiry date |
| `extras.contact_name` | The licence holder's or owner's name, where listed |
| `extras.locality` | The city register the licence comes from (Sioux Falls, Rapid City, Watertown, Brandon, Spearfish, Mobridge, Hermosa or Madison) |

Sample:

```json
{
  "license_number": "8685",
  "license_type": "Residential Building",
  "business_name": "127 BUILDERS",
  "address": "715 N SIX MILE RD",
  "city": "SIOUX FALLS",
  "address_state": "SD",
  "zip_code": "57110",
  "phone": "605-376-3982",
  "status": "Active",
  "expiration_date": "2028-03-01",
  "state": "SD",
  "extras": {
    "locality": "Sioux Falls",
    "contact_name": "BABB TORREY R"
  }
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `mode` | no | string | `"auto"` | export: no names, just filters; returns the whole matching list. lookup / verify: put company names (matched if contained in the company name) or licence numbers (exact) in 'queries'. auto picks the mode for you. |
| `query` | no | string | — | A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks. |
| `queries` | no | array | `[]` | A business name (or listing number) to look up live. Several values in one run; combined with 'query'. |
| `locality` | no | string | — | Only listings in this locality. Kept alongside 'localities' for saved tasks. |
| `localities` | no | array | `[]` | Only listings in this locality. Several values in one run; combined with 'locality'. |
| `status` | no | string | — | Only listings in this status. Kept alongside 'statuses' for saved tasks. |
| `statuses` | no | array | `[]` | Only listings in this status. Several values in one run; combined with 'status'. |
| `categories` | no | array | `[]` | Only rows from this trade (one or more). Available: APPRENTICE, BUSINESS, Both Commercial and Residential, Building, CONTRACTOR, COUNTY CONTRACTOR, COUNTY OSWTS, Class B Electrical, Commercial, Contractors, Electrical, Electricians, Fireplace, INSTALLER, JOURNEYMAN, Landscape Irrigation, MASTER, Mechanical HVAC, Plumbers, Plumbing, ROW Bonded, ROW Sewer-Water, Refrigeration, Residential, Residential Building, Residential Roofing & Repair, Sidewalk, Sign & Outdoor Advertising, UTILITIES, Unspecified. |
| `licenseTypes` | no | array | `[]` | Same filter as 'Trade', under the name every state licence actor takes; the two lists are combined. |
| `expiresAfter` | no | string | — | Only licences expiring on or after this date (YYYY-MM-DD). Licences with no published expiry are left out when set. |
| `expiresBefore` | no | string | — | Only licences expiring on or before this date (YYYY-MM-DD): renewals coming due. |
| `includeContacts` | no | boolean | `true` | Where the board publishes no phone for a business, add one (with its website and street address when found), looked up by business name. Charged as a separate 'Contact details found' event only on a row that gets a phone; a row without one costs only the row price. Turn off for the licence list alone. |
| `maxResults` | no | integer | `500` | Per query in lookup mode; per run in export mode. |
| `proxyConfiguration` | no | object | `{"useApifyProxy": false}` | Used only for live lookups; exports read the stored snapshot. |

### Pricing (Pay Per Event)

You pay per result (`dataset-item`) — **no charge for empty runs**. Example: **1000 contractor licences** at *$0.004/result* ≈ **$4.00**.

With 'Include contact details' on (the default), a business row the board lists without a phone that gets one is also charged a 'Contact details found' event ($0.002); every other row costs only the row. Notices (no match, source unavailable, stale copy) are free.

### Use cases

- Sales lists: contractors licensed in eight South Dakota cities, with phone and, for most, a street address.
- Trade lists: every licensed plumber, electrician or HVAC firm in Sioux Falls, Rapid City, Brandon or Madison with the holder's name.
- E-mail outreach: Watertown contractors, the one city whose list carries an e-mail.
- Contractor checks: confirm a firm holds a city licence, and when it expires, before work starts.
- Market sizing: count licensed contractors by city and by trade.

### Why this actor

- Eight city registers in one export, with the city on every row.
- Phone on nearly every row, and street address, holder's name and expiry wherever the city prints them.
- Rows without a printed licence number kept, not dropped.
- Pay per licence; notices are free.

### Limitations & updates

Covers eight South Dakota city registers (Sioux Falls, Rapid City, Watertown, Brandon, Spearfish, Mobridge, Hermosa, Madison; about 5,100 licences), not the rest of South Dakota. E-mail only on Watertown; Spearfish, Mobridge and Hermosa print no street address, and firms on lists without an address are tagged SD even if based out of state. Licence numbers restart on every source and sheet and some lists print none. Hermosa prints no expiry date. Madison's source files are dated 2024. Rapid City's list is its February 2025 print and includes expired licences (marked Expired) but leaves out its invoice, receipt, owner-builder and similar non-contractor entries; about one row in five has no phone. Exports come from a stored copy; lookups search the current lists. One run returns at most 100,000 rows.

### FAQ

**Where does the data come from?**

The contractor lists published by the cities of Sioux Falls, Watertown, Brandon, Spearfish, Mobridge, Hermosa and Madison, South Dakota. Exports come from a stored copy of those lists; the run log gives its date. Lookups search the current lists.

**Does it cover all of South Dakota?**

No. South Dakota has no statewide general-contractor licence: cities license contractors. This actor reads eight city registers (about 5,100 licences); other South Dakota cities are not included.

**Which cities and how many licences?**

In the November 2026 lists: Sioux Falls about 1,314 across ten trades plus about 142 bonded and 42 sewer and water licences; Rapid City about 3,020 (568 unexpired, 1,848 expired, 602 with no expiry date); Watertown 202; Brandon 177 building and 14 landscape-irrigation; Spearfish 321; Mobridge 53; Hermosa 26; Madison 13 electricians, 5 plumbers and 1 sidewalk licence. Madison's source files are dated 2024, and Rapid City's list is the city's February 2025 print, so both are older than the others.

**Are expired licences included?**

Only for Rapid City, whose list keeps every licence it has issued: its rows come marked Active or Expired from the expiry date, with an expiry_status of Unexpired, Expired or No expiry date. The other cities list current licensees, so every row is marked Active. Hermosa's list has no expiry date.

**Is there a phone, street address or email?**

Phone, nearly everywhere. Street address for Sioux Falls (100% of rows), Rapid City (98%), Brandon and Watertown where listed; Spearfish, Mobridge and Hermosa print none. E-mail only for Watertown (201 of 202 rows); the other seven lists carry none. Firms on the lists without an address are tagged SD even if based out of state.

**Are licence numbers unique?**

No. Numbers restart on every source and sheet, and Spearfish, Mobridge, Hermosa and Madison may print none, so a number can match more than one city or trade. Rows are kept apart by city, sheet, company and holder.

**How do I look up a firm or a licence number?**

Put business names or licence numbers in queries and set mode to lookup. Both match from the start of the city's own value: '127 BUILDERS' finds that firm; because numbers restart, a number can match more than one city or trade.

**How am I charged?**

One event per licence returned. Notices are free.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run South Dakota Contractor License Lookup & Leads Scraper](https://scrapebench.dev/guides/how-to-south-dakota-contractor-license-lookup/)
- **Use case:** [Rapid City SD Licensed Contractors (with expired licences)](https://scrapebench.dev/use-cases/rapid-city-sd-licensed-contractors/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/south-dakota-contractor-license-lookup/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "Find 127 Builders' contractor licence in South Dakota: licence number, holder, address, phone and expiry date."

That is a lookup for the business name 127 BUILDERS (November 2026 list: Sioux Falls licence 8685, Residential Building, expiry 2028-03-01). Keep maxResults small on a first call. Runs started this way bill exactly like any other run.

### Data & lawful use

This actor collects publicly available information that the cities of Sioux Falls, Rapid City, Watertown, Brandon, Spearfish, Mobridge, Hermosa and Madison, South Dakota publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
the cities of Sioux Falls, Rapid City, Watertown, Brandon, Spearfish, Mobridge, Hermosa and Madison, South Dakota. Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

## `mode` (type: `string`):

export: no names, just filters; returns the whole matching list. lookup / verify: put company names (matched if contained in the company name) or licence numbers (exact) in 'queries'. auto picks the mode for you.

## `query` (type: `string`):

A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks.

## `queries` (type: `array`):

A business name (or listing number) to look up live. Several values in one run; combined with 'query'.

## `locality` (type: `string`):

Only listings in this locality. Kept alongside 'localities' for saved tasks.

## `localities` (type: `array`):

Only listings in this locality. Several values in one run; combined with 'locality'.

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

Only listings in this status. Kept alongside 'statuses' for saved tasks.

## `statuses` (type: `array`):

Only listings in this status. Several values in one run; combined with 'status'.

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

Only rows from this trade (one or more). Available: APPRENTICE, BUSINESS, Both Commercial and Residential, Building, CONTRACTOR, COUNTY CONTRACTOR, COUNTY OSWTS, Class B Electrical, Commercial, Contractors, Electrical, Electricians, Fireplace, INSTALLER, JOURNEYMAN, Landscape Irrigation, MASTER, Mechanical HVAC, Plumbers, Plumbing, ROW Bonded, ROW Sewer-Water, Refrigeration, Residential, Residential Building, Residential Roofing & Repair, Sidewalk, Sign & Outdoor Advertising, UTILITIES, Unspecified.

## `licenseTypes` (type: `array`):

Same filter as 'Trade', under the name every state licence actor takes; the two lists are combined.

## `expiresAfter` (type: `string`):

Only licences expiring on or after this date (YYYY-MM-DD). Licences with no published expiry are left out when set.

## `expiresBefore` (type: `string`):

Only licences expiring on or before this date (YYYY-MM-DD): renewals coming due.

## `includeContacts` (type: `boolean`):

Where the board publishes no phone for a business, add one (with its website and street address when found), looked up by business name. Charged as a separate 'Contact details found' event only on a row that gets a phone; a row without one costs only the row price. Turn off for the licence list alone.

## `maxResults` (type: `integer`):

Per query in lookup mode; per run in export mode.

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

Used only for live lookups; exports read the stored snapshot.

## Actor input object example

```json
{
  "mode": "auto",
  "queries": [],
  "localities": [],
  "statuses": [],
  "categories": [],
  "licenseTypes": [],
  "includeContacts": true,
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per business listing; notices are free.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/south-dakota-contractor-license-lookup").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/south-dakota-contractor-license-lookup").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 '{}' |
apify call scrapebench/south-dakota-contractor-license-lookup --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapebench/south-dakota-contractor-license-lookup"
        }
    }
}
```

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/7KIBZ0RrXoy2BKiKj/builds/JtRJeuazIbJJ2psTR/openapi.json
