# Pennsylvania SDB Emails · Official DGS Roster (`corent1robert/pa-dgs-vendor-leads`) Actor

Official Pennsylvania DGS Small Diverse Business, VBE and small-business vendors with published emails and phones. One row per mailbox. Public supplier search. No login.

- **URL**: https://apify.com/corent1robert/pa-dgs-vendor-leads.md
- **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community)
- **Categories:** Lead generation, Automation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.49 / 1,000 vendor with emails

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

## Pennsylvania SDB Emails · Official DGS Roster

Export **Pennsylvania Small Diverse Business, Veteran Business Enterprise and small-business vendors** from the **official DGS supplier search**: vendor name, **published email**, **published phone**, SDB flag.

**No login. No API key. Not PALS licenses. Not PennDOT ECMS. Not a generic business registry.**

Emails and phones **only when DGS publishes them** — never invented.

\~1,700 Small Diverse Business vendors with essentially complete mailbox fill on a live sample. One billed row per unique mailbox.

### Who is this for?

| You are… | Typical goal | Suggested setup |
|----------|--------------|-----------------|
| PA procurement / bid desk | Statewide diverse-vendor list with a mailbox | Small Diverse Business · contacts on |
| Supplier-diversity / SDB outreach | MBE / WBE / LGBT / DOBE / SDVBE mailboxes | Small Diverse Business · 20 rows, then raise Max |
| Veteran-owned BD | VBE roster | Veteran Business Enterprise |
| Agency / SDR | One row per vendor in the CRM | Dataset view **Outreach CRM** |

**What you get by default:** vendor, published email, published phone, contact name, city, program flags.

### Quick start

1. Open the Actor in Apify Console.
2. Keep **Small Diverse Business** or pick VBE / small business.
3. Leave **Only rows with email or phone** on for a first CRM export.
4. Click **Start**.
5. Download JSON, CSV, Excel, or HTML — views **Overview** or **Outreach CRM**.

**Max unique vendors = 0** → no Actor-side ceiling. **Free plan: 20 / run.**

### Ready-made examples

| Example | Best for |
|---------|----------|
| Pennsylvania SDB emails | Small Diverse Business mailboxes |
| Pennsylvania VBE emails | Veteran Business Enterprise |
| Pennsylvania small-business emails | Broader SB roster |
| 20-vendor sample | Quick Try |

### What it extracts

| Category | Fields |
|----------|--------|
| Vendor | `facilityName`, `doingBusinessAs`, `licenseNumber` (SAP), `vendorNumber` |
| Contact | `contactName`, `contactTitle`, `contactEmail`, `contactPhone` |
| Location | `street`, `city`, `zip`, `vendorState` |
| Flags | `isSdb`, `costars`, `sbExpireDate`, `sdbExpireDate`, `vbeExpireDate` |
| Business | `facilityType`, `website`, `keywords` |

Empty source fields stay empty. Government `@pa.gov` mailboxes are skipped.

### How it works

1. Query the public Pennsylvania DGS supplier search (the same roster agencies use to find SB / SDB / VBE vendors).
2. Copy vendor, email, phone and certification dates **when they are printed**.
3. Keep one row per vendor mailbox.
4. Write matching rows as the Dataset fills.

Source: [DGS Supplier Search](https://www.dgs.internet.state.pa.us/suppliersearch/). Independent tool. Not affiliated with the Commonwealth of Pennsylvania.

### Input

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `program` | string | `sdb` | `sdb`, `vbe`, `smallBusiness`, `allCertified`, or `allSuppliers`. |
| `costarsOnly` | boolean | `false` | COSTARS vendors only. |
| `city` | string | empty | Optional city text. |
| `keyword` | string | empty | Optional name, contact or keyword text. |
| `onlyWithContact` | boolean | `false` (`true` in Try) | Keep only rows with a published email or phone. |
| `maxItems` | integer | `20` | **0** = no numerical cap. **Free plan: 20 / run.** |

```json
{ "program": "sdb", "onlyWithContact": true, "maxItems": 20 }
```

```json
{ "program": "vbe", "onlyWithContact": true, "maxItems": 20 }
```

```json
{ "program": "smallBusiness", "onlyWithContact": true, "maxItems": 20 }
```

### Output example

```json
{
  "providerKey": "PADGS-ray@1alphaconsulting.com",
  "facilityName": "1 ALPHA CONSULTING LLC",
  "contactName": "Tom Holloway",
  "contactEmail": "ray@1alphaconsulting.com",
  "contactPhone": "(717) 281-1190",
  "city": "MECHANICSBURG",
  "facilityType": "Small Diverse Business · Small Business",
  "isSdb": "Yes",
  "stateCode": "PA"
}
```

### How much does it cost to scrape Pennsylvania DGS vendors?

Pay-per-event. List price includes a $0.00005 start. FREE pays the most; Gold+ less. A 20-row Try usually finishes in **under a minute**.

| Scenario | FREE | Bronze | Silver | Gold |
|----------|------|--------|--------|------|
| 20 vendors with email | ~$0.08 | ~$0.07 | ~$0.06 | ~$0.05 |
| 1,000 vendors with email | ~$4.00 | ~$3.49 | ~$2.99 | ~$2.49 |
| 50,000 vendors with email | ~$199.50 | ~$174.50 | ~$149.50 | ~$124.50 |

Free Apify plan: **20 unique vendors per run**. Paid plans follow your max charge.

### Is it legal to scrape the Pennsylvania DGS supplier search?

This Actor copies data the Commonwealth publishes in a **public** supplier directory. Names, emails and phones are personal data — your use must comply with CAN-SPAM, TCPA and any rules that apply to you. This is not legal advice. See [Apify on the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

Independent tool. Not affiliated with the Pennsylvania Department of General Services.

### Local development

```bash
cd pa-dgs-vendor-leads
npm install
cp .actor/INPUT.json storage/key_value_stores/default/INPUT.json
apify run --purge
```

Use `apify run` (not `npm start`). Root `input.json` is merged locally; CLI KV input wins on key collision. Local `storage/` is not synced to Apify Console.

`npm test` runs mapper tests (no network).

### FAQ

**Do you invent emails?** No. A mailbox appears only when DGS prints one.

**Is this PALS / professional licenses?** No. PALS is occupational licensing. This roster is DGS procurement suppliers.

**Georgia HUB / NC HUB / Illinois BEP / Maryland MBE?** Those statewide portals sit behind search + Excel + human checks. This Actor is Pennsylvania’s public DGS search, which prints emails without a login.

**Do I need an API key?** No.

### Support

Questions or custom scrapers: <corentin@outreacher.fr>.

Ready? Keep Small Diverse Business, leave contacts on, and click Start.

# Changelog

This Actor's version history is a separate document: https://apify.com/corent1robert/pa-dgs-vendor-leads/changelog.md

# Actor input Schema

## `program` (type: `string`):

Which official DGS classification to list. Try starts on Small Diverse Business.

## `costarsOnly` (type: `boolean`):

Keep vendors marked as COSTARS on the DGS search.

## `city` (type: `string`):

Keep vendors whose city contains this text (case-insensitive).

## `keyword` (type: `string`):

Keep vendors whose name, contact or keywords contain this text.

## `onlyWithContact` (type: `boolean`):

Skip vendors that do not publish a mailbox or phone.

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

Stop after this many unique vendor mailboxes. **0 = no numerical cap**.

## Actor input object example

```json
{
  "program": "sdb",
  "costarsOnly": false,
  "onlyWithContact": true,
  "maxItems": 20
}
```

# Actor output Schema

## `dataset` (type: `string`):

All exported unique DGS vendors.

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

Vendor, program and published email.

## `outreachCrm` (type: `string`):

Contact, email, phone and location.

## `runLog` (type: `string`):

Plain-text progress for this run.

# 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 = {
    "program": "sdb",
    "onlyWithContact": true,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("corent1robert/pa-dgs-vendor-leads").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 = {
    "program": "sdb",
    "onlyWithContact": True,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("corent1robert/pa-dgs-vendor-leads").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 '{
  "program": "sdb",
  "onlyWithContact": true,
  "maxItems": 20
}' |
apify call corent1robert/pa-dgs-vendor-leads --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,corent1robert/pa-dgs-vendor-leads"
        }
    }
}
```

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/bOVaOTapgjEFUN5E7/builds/847zYDOqmvMRot4jf/openapi.json