API Reference

Indonesia POI (Overture Maps Places)

Location category: 1,376,228 places (POI) in Indonesia from the Overture Maps Foundation Places theme, release 2026-10-21.0, from restaurants, mosques, schools, government offices and hotels to shops, across 1,250 categories. Search by name prefix, category or city (locality), find the POI nearest to a coordinate, and fetch one POI in detail. Only places with an Overture confidence score of at least 0.5 are included, and every POI carries its score (0 to 1). Only the Places theme is used (CDLA Permissive 2.0 and Apache 2.0), with no OpenStreetMap data.

Data as of · Source: Overture Maps Places (CDLA-P-2.0 / Apache-2.0)

Main endpoint
GET https://use.apiindonesia.id/api/v1/poi
Endpoints
4
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Data source
Data source: Overture Maps Foundation, Places theme (overturemaps.org), release 2026-10-21.0, public GeoParquet files at s3://overturemaps-us-west-2/release/2026-10-21.0/theme=places/type=place/. The Places theme is released under CDLA Permissive 2.0 (https://cdla.dev/permissive-2-0/) and Apache 2.0 (https://www.apache.org/licenses/LICENSE-2.0) for the Foursquare records; AllThePlaces records are CC0 1.0. Foursquare attribution: "Data from Foursquare. Copyright 2024 Foursquare Labs, Inc. All rights reserved. Available under Apache 2.0. Foursquare data was transformed to the Overture schema. Changed: 2026-03-18." together with the full content of the Foursquare NOTICE.txt (https://opensource.foursquare.com/places-notice-txt/), which is also included verbatim in meta.attribution.third_party_notices on every response. What API Indonesia changed: only records whose address has country=ID are kept, columns are trimmed to the served ones, control characters are removed from text, and the data is normalised to JSON. No Kemendagri region code is added, because that mapping would need boundary data from a differently licensed source.
Product Brief

What this API gives you

Location category: 1,376,228 places (POI) in Indonesia from the Overture Maps Foundation Places theme, release 2026-10-21.0, from restaurants, mosques, schools, government offices and hotels to shops, across 1,250 categories. Search by name prefix, category or city (locality), find the POI nearest to a coordinate, and fetch one POI in detail. Only places with an Overture confidence score of at least 0.5 are included, and every POI carries its score (0 to 1). Only the Places theme is used (CDLA Permissive 2.0 and Apache 2.0), with no OpenStreetMap data.

Data source: Overture Maps Foundation, Places theme (overturemaps.org), release 2026-10-21.0, public GeoParquet files at s3://overturemaps-us-west-2/release/2026-10-21.0/theme=places/type=place/. The Places theme is released under CDLA Permissive 2.0 (https://cdla.dev/permissive-2-0/) and Apache 2.0 (https://www.apache.org/licenses/LICENSE-2.0) for the Foursquare records; AllThePlaces records are CC0 1.0. Foursquare attribution: "Data from Foursquare. Copyright 2024 Foursquare Labs, Inc. All rights reserved. Available under Apache 2.0. Foursquare data was transformed to the Overture schema. Changed: 2026-03-18." together with the full content of the Foursquare NOTICE.txt (https://opensource.foursquare.com/places-notice-txt/), which is also included verbatim in meta.attribution.third_party_notices on every response. What API Indonesia changed: only records whose address has country=ID are kept, columns are trimmed to the served ones, control characters are removed from text, and the data is normalised to JSON. No Kemendagri region code is added, because that mapping would need boundary data from a differently licensed source.

Coverage
4

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/poi

POI list ordered by name. The q filter matches the START of the name, case-insensitively (q=masjid matches "Masjid Istiqlal", q=istiqlal does not). category takes a key from /api/v1/poi/categories, and locality (alias kota) matches the city/regency exactly as written in the Overture address, e.g. "Jakarta Selatan" or "Surabaya". Filters can be combined. per_page is capped at 100 and the offset at 5,000.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Map & location apps: show places around a user (cafes, mosques, ATMs, schools) without building your own POI database.
  • Market research & site selection: count business categories in a city before opening a branch.
  • Logistics & field apps: match a customer point with the nearest named place as an address landmark.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/poi?q=monumen%20nasional&locality=Jakarta%20Pusat&per_page=1" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "success": true,
  "data": [
    {
      "id": "58fef60b-6916-4905-a28b-9dec369147f1",
      "name": "Monumen Nasional",
      "category": "monument",
      "basic_category": "monument",
      "category_hierarchy": ["cultural_and_historic", "memorial_site", "monument"],
      "alternate_categories": [],
      "confidence": 0.9699,
      "lat": -6.1753244,
      "lon": 106.8271812,
      "address": { "freeform": "Jalan Medan Merdeka", "locality": "Jakarta Pusat", "region": null, "postcode": "10310", "country": "ID" },
      "websites": ["http://en.wikipedia.org/wiki/National_Monument_(Indonesia)"],
      "phones": ["+62213823041"],
      "brand": null,
      "operating_status": null,
      "sources": [{ "dataset": "meta", "license": "CDLA-Permissive-2.0" }]
    }
  ],
  "meta": {
    "total": 1, "page": 1, "per_page": 1, "total_pages": 1,
    "attribution": {
      "source": "Overture Maps Foundation, Places theme (overturemaps.org)",
      "license": "CDLA-Permissive-2.0 dan Apache-2.0 (rekaman Foursquare); CC0-1.0 (rekaman AllThePlaces)",
      "license_url": "https://cdla.dev/permissive-2-0/",
      "source_url": "https://docs.overturemaps.org/guides/places/",
      "attribution_page": "https://docs.overturemaps.org/attribution/",
      "notice": "Data diubah oleh API Indonesia: ...",
      "release": "2026-10-21.0",
      "licenses": [ { "name": "CDLA-Permissive-2.0", "url": "https://cdla.dev/permissive-2-0/", "applies_to": "..." }, { "name": "Apache-2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0", "applies_to": "rekaman bersumber Foursquare" }, { "name": "CC0-1.0", "url": "https://creativecommons.org/publicdomain/zero/1.0/", "applies_to": "rekaman bersumber AllThePlaces" } ],
      "third_party_notices": [ "Data from Foursquare. Copyright 2024 Foursquare Labs, Inc. ...", "© 2026 Foursquare Labs, Inc. All rights reserved. ...", "Data from AllThePlaces (https://alltheplaces.xyz/). Available under CC0 1.0." ]
    }
  }
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Just need the file? The same data is also sold as a one-time file, no API key and no per-request credits.

See all datasets and their licences

Indonesia POI (Overture Maps Places) API questions

Where does the POI data come from?

From the Overture Maps Foundation Places theme, release 2026-10-21.0, filtered to records with an Indonesian address (country=ID) with confidence of at least 0.5: 1,376,228 POI. It contains no OpenStreetMap data.

Can I use it in a commercial app?

Yes. The Places theme is licensed CDLA Permissive 2.0 and Apache 2.0 (Foursquare records). Pass on meta.attribution, which carries both licence links and the Foursquare NOTICE, when you redistribute the data.

What does confidence mean?

Overture's 0 to 1 score for how likely the place really exists. About 65% of Indonesian POI have a confidence of 0.5 or more; filter to suit your use case.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization