# OpenStreetMap Places Scraper: shops, restaurants, offices (`bepolabs/osm-pois`) Actor

Give a city or neighbourhood plus the points of interest (POI types) you want; get name, street address, coordinates, phone, website and opening hours. Costs 0.5 USD per 1,000 places.

- **URL**: https://apify.com/bepolabs/osm-pois.md
- **Developed by:** [BEPO Labs](https://apify.com/bepolabs) (community)
- **Categories:** Lead generation, Travel, Open source
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 94.1% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.50 / 1,000 places

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

### 📍 What is OpenStreetMap Places?

The points of interest volunteers have added to OpenStreetMap in a district or town come back as flat places: label, kind, postal location, email, latitude and longitude, the OSM link and all raw tags such as `amenity=cafe`. The data is open and may be used commercially under the ODbL; the required credit is included.

- **Lead lists**: local businesses by type and district
- **Market research**: count competitors and see where they cluster
- **Maps and apps**: seed a points-of-interest layer
- **Site selection**: check what is around a location

![OpenStreetMap Places: Shops, restaurants and offices in any city or area, with address, phone, website, opening hours and coordinates.](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/osm-pois-hero.png)

#### ✨ Why use this Actor?

- ✅ **Open data**: OpenStreetMap, no scraping of closed maps
- ✅ **Complete rows**: address, phone, website, email and opening hours where mapped
- ✅ **Licence handled**: the ODbL credit is in every row and the run summary
- ✅ **Polite**: one geocode per run, tags one after another, within Overpass and Nominatim usage policies
- ✅ **Pay for places**: failed tags are not charged

### 📦 What data can you get with OpenStreetMap Places?

| | | |
|---|---|---|
| 🏷️ Name and category | 📍 Latitude and longitude | 🏠 Street, postcode, city, country |
| 📞 Phone and email | 🌐 Website | 🕒 Opening hours |
| 🔗 OpenStreetMap id and link | ⚖️ Licence note |  |

> Contact fields are filled only where mappers entered them; the raw `tags` object holds everything else.

### 🚀 How to use OpenStreetMap Places

OpenStreetMap Places works in a few clicks, no coding needed:

1. [Create a free Apify account](https://console.apify.com/sign-up) (the free plan includes 5 USD of monthly credit).
2. Open [OpenStreetMap Places](https://apify.com/bepolabs/osm-pois) and click **Try for free**.
3. Enter an area such as `Kreuzberg, Berlin`, add place types as OpenStreetMap tags, and set the maximum number of places.
4. Click **Start** and wait for the run to finish (most runs take seconds).
5. Download your data as JSON, CSV, Excel, XML or HTML, or send it straight to Google Sheets, Make, Zapier or your AI agent.

![How OpenStreetMap Places works](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/osm-pois-workflow.png)

### ⬇️ Input

Enter an area and one or more tags; `maxResults` and `namedOnly` have defaults.

##### Area

A place name that Nominatim finds, up to about one square degree.

##### Tags

`key=value` pairs, for example `amenity=cafe`, `shop=bakery`, `office=lawyer`. Tags run one after another.

##### Named only

Skip unnamed features such as benches and parking spots.

| Field | Type | What it does | Default |
|---|---|---|---|
| **Area** (`area`) | string | A place name (city, district, town) or a bounding box south,west,north,east. | `"Kreuzberg, Berlin"` |
| **Place types (OpenStreetMap tags)** (`tags`) | array | key=value tags such as amenity=restaurant, shop=bakery, office=lawyer, or a bare key (shop) for all values. | `["amenity=cafe"]` |
| **Max places** (`maxResults`) | integer | Stop after this many places (1 to 10,000). | `1000` |
| **Only places with a name** (`namedOnly`) | boolean | Skip unnamed features (benches, unnamed parking). | `true` |

![OpenStreetMap Places input form](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/osm-pois-input.png)

#### Input example

```json
{
    "area": "Kreuzberg, Berlin",
    "tags": [
        "amenity=cafe"
    ],
    "maxResults": 50
}
```

### ⬆️ Output

Every place becomes one row with address, contact data, opening hours and coordinates.

![OpenStreetMap Places output table](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/osm-pois-output.png)

#### Output example

One row of the dataset (a café in Kreuzberg, a real local run of 2026-10-16, tags shortened):

```json
{
    "name": "Brammibal's Donuts",
    "category": "amenity=cafe",
    "lat": 52.507931,
    "lon": 13.3737316,
    "street": "Alte Potsdamer Straße 7",
    "postcode": "10785",
    "city": "Berlin",
    "country": "DE",
    "phone": "",
    "website": "https://www.brammibalsdonuts.com/",
    "email": "",
    "openingHours": "Mo-Fr 09:00-21:00; Sa 10:00-21:00; Su,PH 10:00-20:00",
    "osmId": "node/69226202",
    "osmUrl": "https://www.openstreetmap.org/node/69226202",
    "licence": "© OpenStreetMap contributors, ODbL 1.0"
}
```

View the results as a table or JSON in the Output tab and download them as JSON, CSV, Excel, XML, HTML or RSS, all fields or only those you pick.

### 💰 How much does OpenStreetMap Places cost?

OpenStreetMap Places is priced **per event**: **0.5 USD per 1,000 places** (0.0005 USD each), with no monthly rental. Failed tags are not charged.

| You get | You pay |
|---|---|
| 100 places | 0.05 USD |
| 1,000 places | 0.5 USD |
| 10,000 places | 5 USD |
| 100,000 places | 50 USD |

💡 Apify's free plan gives you 5 USD of credit every month, enough for about **10,000 places** at no cost. Set a spending limit per run and the Actor stops there.

### ⚖️ OpenStreetMap Places vs. the alternatives

| | OpenStreetMap Places | Google Maps scrapers | Manual Overpass queries |
|---|---|---|---|
| **Open data, commercial use with credit** | ✅ | ❌ closed terms | ✅ |
| **No query language needed** | ✅ | ✅ | ❌ |
| **Opening hours and contacts** | ✅ where mapped | ✅ | ✅ |
| **Export, schedule, API and MCP** | ✅ | varies | ❌ |

### 🔌 Integrations, API and MCP

#### Connect OpenStreetMap Places to your AI agent (MCP)

Give Claude, ChatGPT, Cursor or any MCP client direct access to OpenStreetMap Places through the [Apify MCP server](https://mcp.apify.com). Add this URL to its settings:

```text
https://mcp.apify.com/?actors=bepolabs/osm-pois
```

For Claude Desktop, add it under `mcpServers` in `claude_desktop_config.json`:

```json
{
    "mcpServers": {
        "osm-pois": {
            "command": "npx",
            "args": [
                "-y",
                "@apify/actors-mcp-server",
                "--actors",
                "bepolabs/osm-pois"
            ],
            "env": {
                "APIFY_TOKEN": "<your Apify API token>"
            }
        }
    }
}
```

Then just ask: *"List all bakeries in Neukölln, Berlin with their opening hours and websites."*

#### Run it from your code

Python (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("bepolabs/osm-pois").call(run_input={"area":"Kreuzberg, Berlin","tags":["amenity=cafe"],"maxResults":50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

JavaScript (`npm install apify-client`):

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('bepolabs/osm-pois').call({"area":"Kreuzberg, Berlin","tags":["amenity=cafe"],"maxResults":50});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### No-code integrations

Send results to **Google Sheets, Slack, Airtable, HubSpot, Make, Zapier, n8n** and more from the Integrations tab, start runs on a **schedule**, or trigger your own endpoint with a **webhook** when a run finishes. The [Apify API](https://docs.apify.com/api/v2) gives you full control over runs and datasets.

### ❓ FAQ

##### Why are some phones empty?

Mappers fill them in voluntarily. Coverage is strongest in cities and for shops and restaurants.

##### Must I credit OpenStreetMap?

Yes: credit `© OpenStreetMap contributors`, and share a database you build from the data under the same licence (ODbL 1.0). Every row carries the note.

##### How large can the area be?

About one square degree per run; split larger regions into districts.

##### Is it legal to use OpenStreetMap Places?

Data © OpenStreetMap contributors, available under the Open Database Licence (ODbL 1.0, openstreetmap.org/copyright). The Actor follows the Overpass and Nominatim usage policies.

##### What if something is missing or does not work?

Open an issue on the **Issues** tab; we read each one and reply. Feature requests are welcome too.

### 💬 Your feedback

Tell us what OpenStreetMap Places should add on the **Issues** tab or leave a review; your notes decide what we work on next.

### 🔗 Related Actors

| Actor | What it does |
|---|---|
| 💼 [ATS Jobs](https://apify.com/bepolabs/ats-jobs) | Every open job from company career boards on Greenhouse, Lever, Ashby, Workable, SmartRecruiters and Recruitee in one deduped feed. |
| 🌐 [Domain RDAP and DNS](https://apify.com/bepolabs/domain-rdap) | Domains to registrar, creation and expiry dates, age, status, nameservers, DNSSEC and DNS records from official RDAP, in bulk. |
| 🧩 [Tech Stack Detector](https://apify.com/bepolabs/tech-stack) | Any list of domains to the technologies behind each site: CMS, shop, framework, analytics, CDN and hosting. |
| 📇 [Website Contacts](https://apify.com/bepolabs/website-contacts) | Company websites to emails, phone numbers and social profiles, one row per site, with a status that says why nothing was found. |
| 📧 [Email Verifier](https://apify.com/bepolabs/email-dns-check) | Bulk email validation over DNS: valid, risky or invalid per address, with the reasons, a score, a typo fix, throwaway and shared-inbox flags. |
| 📢 [Google Ads Transparency Scraper](https://apify.com/bepolabs/google-ads-transparency) | Every ad a company runs on Google, by domain, advertiser ID or name, from the Ads Transparency Center. |
| 🩺 [NPI Registry Lookup](https://apify.com/bepolabs/npi-registry) | US doctors, nurses, clinics and pharmacies from the official CMS NPI Registry, by specialty, name, NPI or place. |
| 📞 [Phone Number Validator](https://apify.com/bepolabs/phone-validator) | Bulk phone number validation offline: valid or not, E.164 format, country and line type (mobile, fixed line, VoIP) for every number. |

# Changelog

This Actor's version history is a separate document: https://apify.com/bepolabs/osm-pois/changelog.md

# Actor input Schema

## `area` (type: `string`):

A place name (city, district, town) or a bounding box south,west,north,east. At most 1 square degree.

## `tags` (type: `array`):

key=value tags such as amenity=restaurant, shop=bakery, office=lawyer, or a bare key (shop) for all values. Up to 20.

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

Stop after this many places (1 to 10,000).

## `namedOnly` (type: `boolean`):

Skip unnamed features (benches, unnamed parking).

## Actor input object example

```json
{
  "area": "Kreuzberg, Berlin",
  "tags": [
    "amenity=cafe"
  ],
  "maxResults": 1000,
  "namedOnly": true
}
```

# Actor output Schema

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

Dataset items, one row per result, in the overview table view.

# 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 = {
    "area": "Kreuzberg, Berlin",
    "tags": [
        "amenity=cafe"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("bepolabs/osm-pois").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 = {
    "area": "Kreuzberg, Berlin",
    "tags": ["amenity=cafe"],
}

# Run the Actor and wait for it to finish
run = client.actor("bepolabs/osm-pois").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 '{
  "area": "Kreuzberg, Berlin",
  "tags": [
    "amenity=cafe"
  ]
}' |
apify call bepolabs/osm-pois --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bepolabs/osm-pois"
        }
    }
}
```

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/qdSe2HfwEaxlgOomK/builds/2SSOe989vmTd5YXvX/openapi.json