# Local Business Leads with Emails from OpenStreetMap (`turboextract/osm-local-business-leads`) Actor

Get local business leads for any city: dentists, plumbers, restaurants, lawyers and 30 more categories. Each row has phone, website, address, opening hours and emails found on the business website. A cheaper Google Maps scraper alternative for agencies and B2B sales.

- **URL**: https://apify.com/turboextract/osm-local-business-leads.md
- **Developed by:** [Moses Ndambuki](https://apify.com/turboextract) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 business lead delivereds

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

## Local Business Leads with Emails from OpenStreetMap

**Build a local business lead list for any city in minutes: name, phone, website, address, opening hours, social profiles and emails found on each business website.** Pick from 33 categories (dentists, plumbers, restaurants, lawyers, gyms, salons and more) or use any OpenStreetMap tag.

A cheaper Google Maps scraper alternative for agencies, local SEO consultants and B2B sales teams. The data comes from OpenStreetMap, the open map built by millions of contributors, and every business website is checked for contact emails.

***

### Who this is for

- **Marketing, web design and SEO agencies** prospecting local businesses
- **B2B sales teams** selling POS, booking, payments or software to SMBs
- **Local service marketplaces** seeding supply in a new city
- **Franchise and retail analysts** mapping competitors and catchment areas
- **Researchers** who need business locations with coordinates

***

### What you get per business

```json
{
  "name": "Kunik Orthodontics",
  "category": "dentist",
  "phone": "+1-512-327-7575",
  "website": "https://www.kunikorthodontics.com/",
  "email": "contact@drkunik.com",
  "emailSource": "website",
  "allEmails": ["contact@drkunik.com"],
  "address": { "street": "830 West 3rd Street", "city": "Austin", "postcode": "78703", "state": "TX", "full": "830 West 3rd Street, Austin, 78703" },
  "latitude": 30.2684867,
  "longitude": -97.7534402,
  "openingHours": null,
  "socials": {
    "facebook": "https://www.facebook.com/RandyKunikDDS",
    "instagram": "https://www.instagram.com/kunikorthodontics/"
  },
  "osmUrl": "https://www.openstreetmap.org/node/3857696615",
  "searchedLocation": "Austin, Travis County, Texas, United States"
}
```

`emailSource` tells you whether the email was listed on OpenStreetMap or found on the business website.

***

### How it works

```mermaid
flowchart LR
    A[City + categories] --> B[Geocode city boundary]
    B --> C[OpenStreetMap Overpass query]
    C --> D[Businesses with name, phone, website, address]
    D --> E[Visit website: home, then contact page]
    E --> F[Emails + Facebook, Instagram, LinkedIn, X]
    F --> G[One lead per business]
```

The actor finds the exact city or region boundary, pulls every matching business from OpenStreetMap, puts businesses with contact details first, then visits each website to find emails and social profiles.

***

### Quick start

1. Click **Try for free**.
2. Enter a **Location** such as `Austin, Texas`, `Camden, London` or `Lyon, France`.
3. Pick **Business categories**, for example Dentists and Physiotherapists.
4. Click **Start** and export to CSV, Excel or your CRM.

#### API

```bash
curl -X POST "https://api.apify.com/v2/acts/Turboextract~osm-local-business-leads/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "location": "Manchester, UK",
    "categories": ["plumber", "electrician", "hvac"],
    "extractEmails": true,
    "requireContact": true,
    "maxResults": 300
  }'
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("Turboextract/osm-local-business-leads").call(run_input={
    "location": "Berlin, Germany",
    "categories": ["restaurant", "cafe"],
})
for b in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(b["name"], b["phone"], b["email"], b["website"])
```

***

### Input

| Field | Default | What it does |
|---|---|---|
| `location` | – | City, district, county or region |
| `categories` | dentist | One or more of 33 business types |
| `customTags` | – | Any OpenStreetMap tag, e.g. `craft=photographer` |
| `radiusKm` | 5 | Search radius when the location is a point |
| `extractEmails` | true | Visit websites for emails and social profiles |
| `requireContact` | false | Skip businesses with no phone, website or email |
| `maxResults` | 100 | Cap per run |

***

### Pricing

**$0.003 per business delivered, website email lookup included.** 1,000 leads cost $3.

| Option | 1,000 local business leads |
|---|---|
| **Local Business Leads (this actor)** | **$3**, emails and socials included |
| OpenStreetMap POI extractors on Apify | From $0.80, no website emails |
| Local lead databases | Monthly subscriptions |
| Copying from maps by hand | Days |

***

### Use cases

- **Agency prospecting**: every dentist in a city with a website and email
- **Field sales routes**: auto repair shops with coordinates for route planning
- **Marketplace launch**: plumbers, electricians and roofers in a new metro
- **Competitor maps**: gyms and coworking spaces in a catchment area

***

### Pairs well with

- [B2B Lead Enrichment Pipeline](https://apify.com/Turboextract/b2b-lead-enrichment-pipeline): deeper company data for every website
- [Brand Availability Check](https://apify.com/Turboextract/brand-availability-check): check business names across domains and trademarks
- [Hacker News Hiring Leads](https://apify.com/Turboextract/hn-hiring-leads): tech companies hiring right now

***

### FAQ

**How complete is the data compared with Google Maps?** OpenStreetMap coverage depends on the area. It is very strong in most of Europe and many large cities, and thinner in some US suburbs and rural areas. Run a small test for your city first.

**How many businesses have emails?** It depends on the category. Businesses with their own website often list an email on the home or contact page. Chains and social-only businesses often do not.

**Can I use any business type?** Yes. Add any OpenStreetMap tag in `customTags`, for example `shop=bicycle` or `office=architect`.

**Is this legal to use?** OpenStreetMap data is open under the ODbL license (credit: © OpenStreetMap contributors). Website emails are read from public pages. Follow your local email marketing rules (CAN-SPAM, GDPR) when you contact businesses.

***

### Support

- Docs and examples: https://github.com/andersonjames38phd-cpu/osm-local-business-leads
- Community Discord: https://discord.gg/8SrXSCpvgj

Built and maintained by [Turboextract](https://apify.com/Turboextract) on the Apify platform. Map data © OpenStreetMap contributors.

# Actor input Schema

## `location` (type: `string`):

City, district, county or region, e.g. "Austin, Texas", "Camden, London" or "Bavaria, Germany".

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

Pick one or more business types.

## `customTags` (type: `array`):

Optional extra tags as key=value, e.g. craft=photographer or shop=bicycle. See wiki.openstreetmap.org/wiki/Map_features.

## `radiusKm` (type: `integer`):

Used only when the location is a point such as an address or landmark rather than a city boundary.

## `extractEmails` (type: `boolean`):

Visit each business website (home page, then the contact page) to find email addresses and social profiles.

## `requireContact` (type: `boolean`):

Skip businesses that have no phone, website or email.

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

Maximum businesses delivered (and charged) per run. Businesses with contact details come first.

## Actor input object example

```json
{
  "location": "Austin, Texas",
  "categories": [
    "dentist"
  ],
  "radiusKm": 5,
  "extractEmails": true,
  "requireContact": false,
  "maxResults": 100
}
```

# Actor output Schema

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

One row per local business with phone, website, email, address and social profiles.

# 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 = {
    "location": "Austin, Texas"
};

// Run the Actor and wait for it to finish
const run = await client.actor("turboextract/osm-local-business-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 = { "location": "Austin, Texas" }

# Run the Actor and wait for it to finish
run = client.actor("turboextract/osm-local-business-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 '{
  "location": "Austin, Texas"
}' |
apify call turboextract/osm-local-business-leads --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,turboextract/osm-local-business-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/zajdCtpqWZ3mm0mNy/builds/bZSf62cQiYpQJmaVL/openapi.json
