---
type: "firecrawl-provider"
description: "Overture Maps Foundation places: 60M+ points of interest worldwide (businesses, landmarks, public facilities) around a point (up to 2 km) or inside a box (up to 100 km on a side), filtered by category, name, confidence and open status, plus lookup by GERS id. Every record carries its contributing sources and their open licenses (CDLA-Permissive-2.0, Apache-2.0, CC0)."
use_when: "Overture Maps Foundation places: 60M+ points of interest worldwide (businesses, landmarks, public facilities) around a point (up to 2 km) or inside a box (up to 100 km on a side), filtered by category, name, confidence and open status, plus lookup by GERS id. Every record carries its contributing sources and their open licenses (CDLA-Permissive-2.0, Apache-2.0, CC0)."
categories: "Places"
capabilities: 3
credits_per_call: 5
---
# Overture Maps places on Firecrawl Alexandria

Overture Maps Foundation places: 60M+ points of interest worldwide (businesses, landmarks, public facilities) around a point (up to 2 km) or inside a box (up to 100 km on a side), filtered by category, name, confidence and open status, plus lookup by GERS id. Every record carries its contributing sources and their open licenses (CDLA-Permissive-2.0, Apache-2.0, CC0).

- Categories: Places
- Category index: [Places category](https://alexandria.firecrawl.dev/agents/categories/places)
- Provider key: `overturemaps-org`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/overturemaps-org)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/overturemaps-org/openapi.json)

## Capabilities

- [Place](https://alexandria.firecrawl.dev/agents/providers/overturemaps-org/places/place): One Overture Maps place by its GERS id: name, categories, address, phones, websites, emails, socials, brand, operating status, confidence, exact coordinates and sources with licenses, from the latest release. Ids come from places_nearby, places_in_bbox or any Overture dataset.
- [Places in bbox](https://alexandria.firecrawl.dev/agents/providers/overturemaps-org/places/places_in_bbox): Points of interest inside a box given by min/max latitude and longitude from Overture Maps, optionally filtered by category, name, confidence and open status, returned page by page. The box can be up to 100 km on a side; a dense city box takes several pages, so pass next_cursor back until it is null. Same place record as places_nearby. Split a box that crosses the antimeridian (180 degrees longitude) in two.
- [Places nearby](https://alexandria.firecrawl.dev/agents/providers/overturemaps-org/places/places_nearby): Points of interest (businesses, landmarks, public facilities) around a point from Overture Maps, nearest first, optionally filtered by category, name, confidence and open status. Pass latitude and longitude; radius_m defaults to 500 m (up to 2 km). Each place has its GERS id, name, categories, address, phones, websites, emails, socials, brand, operating status, confidence, coordinates, distance and its sources with their licenses. Worldwide.

## 1. Choose this provider when

Overture Maps Foundation places: 60M+ points of interest worldwide (businesses, landmarks, public facilities) around a point (up to 2 km) or inside a box (up to 100 km on a side), filtered by category, name, confidence and open status, plus lookup by GERS id. Every record carries its contributing sources and their open licenses (CDLA-Permissive-2.0, Apache-2.0, CC0).

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "overturemaps-org",
  "capability": "places/place",
  "options": {
    "id": "0a86da02-322e-432b-9e6a-9943a21eccff"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `id` (string, required): GERS id (UUID), such as 0a86da02-322e-432b-9e6a-9943a21eccff. Example: `<id>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "overturemaps-org",
    capability: "places/place",
    options: {
      id: "0a86da02-322e-432b-9e6a-9943a21eccff",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "overturemaps-org",
  "capability": "places/place",
  "options": {
    "id": "0a86da02-322e-432b-9e6a-9943a21eccff"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "overturemaps-org",
    "capability": "places/place",
    "options": {
      "id": "0a86da02-322e-432b-9e6a-9943a21eccff"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'overturemaps-org/places/place' \
  --options '{"id":"0a86da02-322e-432b-9e6a-9943a21eccff"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "overturemaps-org",
  "capability": "places/place",
  "options": {
    "id": "0a86da02-322e-432b-9e6a-9943a21eccff"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "overturemaps-org",
  "capability": "places/place",
  "options": {
    "id": "0a86da02-322e-432b-9e6a-9943a21eccff"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "attribution": "© OpenStreetMap contributors, © Overture Maps Foundation. Places data is CDLA-Permissive-2.0, Foursquare-sourced records Apache-2.0; each record lists its sources and their licenses.",
  "observed_at_ms": 1795284820000,
  "place": {
    "addresses": [
      {
        "country": "US",
        "freeform": "State Hwy. 17",
        "locality": "Marfa",
        "postcode": "79843",
        "region": "US-TX"
      }
    ],
    "basic_category": "airport",
    "brand": null,
    "category": "airport",
    "category_hierarchy": [
      "travel_and_transportation",
      "air_transport_facility_or_service",
      "airport"
    ],
    "confidence": 0.77,
    "emails": [],
    "id": "0a86da02-322e-432b-9e6a-9943a21eccff",
    "latitude": 30.316608,
    "longitude": -104.021371,
    "name": "Marfa Municipal Airport (MRF)",
    "operating_status": null,
    "phones": [
      "+14327293102"
    ],
    "socials": [],
    "sources": [
      {
        "dataset": "Foursquare",
        "license": "Apache-2.0",
        "property": null,
        "record_id": "4b81995ef964a520c5b130e3",
        "update_time": "2026-01-11T00:00:00.000"
      },
      {
        "dataset": "Overture",
        "license": "CDLA-Permissive-2.0",
        "property": "/properties/confidence",
        "record_id": null,
        "update_time": "2026-11-11T15:48:27Z"
      }
    ],
    "version": 7,
    "websites": [
      "http://www.flygliders.com"
    ]
  },
  "release": "2026-11-18.0"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Place

- Capability: `places/place`
- Description: One Overture Maps place by its GERS id: name, categories, address, phones, websites, emails, socials, brand, operating status, confidence, exact coordinates and sources with licenses, from the latest release. Ids come from places_nearby, places_in_bbox or any Overture dataset.
- Instructions: Refresh or resolve a known Overture place id; check whether a place still exists in the latest release.
- Cost: 5 credits per call
- Capability file: [Place](https://alexandria.firecrawl.dev/agents/providers/overturemaps-org/places/place)

Accepted options:
- `id` (string, required): GERS id (UUID), such as 0a86da02-322e-432b-9e6a-9943a21eccff. Example: `<id>`

Response schema example:
```json
{
  "attribution": "© OpenStreetMap contributors, © Overture Maps Foundation. Places data is CDLA-Permissive-2.0, Foursquare-sourced records Apache-2.0; each record lists its sources and their licenses.",
  "observed_at_ms": 1795284820000,
  "place": {
    "addresses": [
      {
        "country": "US",
        "freeform": "State Hwy. 17",
        "locality": "Marfa",
        "postcode": "79843",
        "region": "US-TX"
      }
    ],
    "basic_category": "airport",
    "brand": null,
    "category": "airport",
    "category_hierarchy": [
      "travel_and_transportation",
      "air_transport_facility_or_service",
      "airport"
    ],
    "confidence": 0.77,
    "emails": [],
    "id": "0a86da02-322e-432b-9e6a-9943a21eccff",
    "latitude": 30.316608,
    "longitude": -104.021371,
    "name": "Marfa Municipal Airport (MRF)",
    "operating_status": null,
    "phones": [
      "+14327293102"
    ],
    "socials": [],
    "sources": [
      {
        "dataset": "Foursquare",
        "license": "Apache-2.0",
        "property": null,
        "record_id": "4b81995ef964a520c5b130e3",
        "update_time": "2026-01-11T00:00:00.000"
      },
      {
        "dataset": "Overture",
        "license": "CDLA-Permissive-2.0",
        "property": "/properties/confidence",
        "record_id": null,
        "update_time": "2026-11-11T15:48:27Z"
      }
    ],
    "version": 7,
    "websites": [
      "http://www.flygliders.com"
    ]
  },
  "release": "2026-11-18.0"
}
```

### Places in bbox

- Capability: `places/places_in_bbox`
- Description: Points of interest inside a box given by min/max latitude and longitude from Overture Maps, optionally filtered by category, name, confidence and open status, returned page by page. The box can be up to 100 km on a side; a dense city box takes several pages, so pass next_cursor back until it is null. Same place record as places_nearby. Split a box that crosses the antimeridian (180 degrees longitude) in two.
- Instructions: Enumerate POIs in an area: every restaurant in a neighbourhood, all gas stations in a town, business listings across a county page by page.
- Cost: 5 credits per call
- Capability file: [Places in bbox](https://alexandria.firecrawl.dev/agents/providers/overturemaps-org/places/places_in_bbox)

Accepted options:
- `category` (string): Overture category code, matched against the basic category, the primary category, every level of its hierarchy and alternates (coffee_shop, restaurant, airport, hospital, food_and_drink). Spaces and hyphens count as underscores; case-insensitive. Example: `<category>`
- `cursor` (string): next_cursor from the previous page (opaque). Pass the same box and filters as the first page. Example: `<cursor>`
- `limit` (number): Maximum places per page. Default 100. Example: `10`
- `max_latitude` (number, required): North edge. Example: `10`
- `max_longitude` (number, required): East edge. Example: `10`
- `min_confidence` (number): Drop places whose confidence is below this (0 to 1). 0.7 keeps mostly verified places. Example: `1`
- `min_latitude` (number, required): South edge. Example: `10`
- `min_longitude` (number, required): West edge. Example: `10`
- `name` (string): Case-insensitive substring of the place name or brand name. Example: `<name>`
- `open_only` (boolean): Drop places marked permanently or temporarily closed. Default false. Example: `false`

Response schema example:
```json
{
  "attribution": "© OpenStreetMap contributors, © Overture Maps Foundation. Places data is CDLA-Permissive-2.0, Foursquare-sourced records Apache-2.0; each record lists its sources and their licenses.",
  "bbox": [
    -104.03,
    30.3,
    -104.01,
    30.32
  ],
  "count": 1,
  "next_cursor": null,
  "observed_at_ms": 1795284820000,
  "places": [
    {
      "addresses": [
        {
          "country": "US",
          "freeform": "State Hwy. 17",
          "locality": "Marfa",
          "postcode": "79843",
          "region": "US-TX"
        }
      ],
      "basic_category": "airport",
      "brand": null,
      "category": "airport",
      "category_hierarchy": [
        "travel_and_transportation",
        "air_transport_facility_or_service",
        "airport"
      ],
      "confidence": 0.77,
      "emails": [],
      "id": "0a86da02-322e-432b-9e6a-9943a21eccff",
      "latitude": 30.316608,
      "longitude": -104.021371,
      "name": "Marfa Municipal Airport (MRF)",
      "operating_status": null,
      "phones": [
        "+14327293102"
      ],
      "socials": [],
      "sources": [
        {
          "dataset": "Foursquare",
          "license": "Apache-2.0",
          "property": null,
          "record_id": "4b81995ef964a520c5b130e3",
          "update_time": "2026-01-11T00:00:00.000"
        },
        {
          "dataset": "Overture",
          "license": "CDLA-Permissive-2.0",
          "property": "/properties/confidence",
          "record_id": null,
          "update_time": "2026-11-11T15:48:27Z"
        }
      ],
      "version": 7,
      "websites": [
        "http://www.flygliders.com"
      ]
    }
  ],
  "release": "2026-11-18.0"
}
```

### Places nearby

- Capability: `places/places_nearby`
- Description: Points of interest (businesses, landmarks, public facilities) around a point from Overture Maps, nearest first, optionally filtered by category, name, confidence and open status. Pass latitude and longitude; radius_m defaults to 500 m (up to 2 km). Each place has its GERS id, name, categories, address, phones, websites, emails, socials, brand, operating status, confidence, coordinates, distance and its sources with their licenses. Worldwide.
- Instructions: Find businesses or POIs near a coordinate (coffee shops near a hotel, hospitals near an address, everything on a block). Geocode an address first if you only have text.
- Cost: 5 credits per call
- Capability file: [Places nearby](https://alexandria.firecrawl.dev/agents/providers/overturemaps-org/places/places_nearby)

Accepted options:
- `category` (string): Overture category code, matched against the basic category, the primary category, every level of its hierarchy and alternates (coffee_shop, restaurant, airport, hospital, food_and_drink). Spaces and hyphens count as underscores; case-insensitive. Example: `<category>`
- `latitude` (number, required): Center latitude (WGS84). Example: `10`
- `limit` (number): Maximum places returned, nearest first. Default 25. Example: `10`
- `longitude` (number, required): Center longitude (WGS84). Example: `10`
- `min_confidence` (number): Drop places whose confidence is below this (0 to 1). 0.7 keeps mostly verified places. Example: `1`
- `name` (string): Case-insensitive substring of the place name or brand name. Example: `<name>`
- `open_only` (boolean): Drop places marked permanently or temporarily closed. Default false. Example: `false`
- `radius_m` (number): Search radius in meters, 1 to 2000. Default 500. Example: `10`

Response schema example:
```json
{
  "attribution": "© OpenStreetMap contributors, © Overture Maps Foundation. Places data is CDLA-Permissive-2.0, Foursquare-sourced records Apache-2.0; each record lists its sources and their licenses.",
  "center": {
    "latitude": 30.3166,
    "longitude": -104.0214
  },
  "count": 1,
  "observed_at_ms": 1795284820000,
  "places": [
    {
      "addresses": [
        {
          "country": "US",
          "freeform": "State Hwy. 17",
          "locality": "Marfa",
          "postcode": "79843",
          "region": "US-TX"
        }
      ],
      "basic_category": "airport",
      "brand": null,
      "category": "airport",
      "category_hierarchy": [
        "travel_and_transportation",
        "air_transport_facility_or_service",
        "airport"
      ],
      "confidence": 0.77,
      "distance_m": 2.9,
      "emails": [],
      "id": "0a86da02-322e-432b-9e6a-9943a21eccff",
      "latitude": 30.316608,
      "longitude": -104.021371,
      "name": "Marfa Municipal Airport (MRF)",
      "operating_status": null,
      "phones": [
        "+14327293102"
      ],
      "socials": [],
      "sources": [
        {
          "dataset": "Foursquare",
          "license": "Apache-2.0",
          "property": null,
          "record_id": "4b81995ef964a520c5b130e3",
          "update_time": "2026-01-11T00:00:00.000"
        },
        {
          "dataset": "Overture",
          "license": "CDLA-Permissive-2.0",
          "property": "/properties/confidence",
          "record_id": null,
          "update_time": "2026-11-11T15:48:27Z"
        }
      ],
      "version": 7,
      "websites": [
        "http://www.flygliders.com"
      ]
    }
  ],
  "radius_m": 300,
  "release": "2026-11-18.0",
  "total_matches": 1
}
```
