Skip to main content

Cambodia Data Bridge API

A public, read-only API over the official 2025 Cambodian administrative registry: 16,478 entities from province down to village. No account, no API key, no cost.

Before you start

  • Codes are strings. Official codes have meaningful leading zeros. Parse them as text. A province code is 2 digits, a district 4, a commune 6 and a village 8.
  • A code can be ambiguous. The 2025source publishes some codes for more than one place, so /entities returns an array and /resolve can answer "ambiguous".
  • Read the provenance block. Every response names the dataset, administrative version and the time GlobeScraper last retrieved it.
  • Derived values are marked. A match produced by normalisation, a recorded variant or spelling similarity is flagged as derived, with its method and confidence.
  • Attribution travels with the data. Every response carries a provenance block naming the dataset, its publisher, the portal, and the licence or terms the data is used under, with a link. Reusing a value from this API means inheriting that attribution condition.
  • Two different permissions apply. The six Cambodian government datasets are used under the Data EF Terms of Use, which permit commercial and non-commercial use with attribution to the data source. The commune boundary dataset is published by UN OCHA under CC BY 3.0 IGO, which additionally requires a link to the licence and an indication of changes made.
  • Changes are declared. Where a response depends on removing the leading KH prefix from OCHA PCODEs, the provenance block sets derived: true and explains the modification. That is a GlobeScraper transformation, not an OCHA product.
  • For the complete underlying dataset, use the original publisher source. This API answers lookups against a validated snapshot; it is not a redistribution channel, so there is no bulk export and lists stay paginated.
  • Rate limit. 60 requests per minute per IP address. Over the limit returns HTTP 429 with a Retry-After header.
  • Results are bounded. Lists page with limit and cursor, up to 200 per request. There is no endpoint that returns every village at once.
  • Versioning. Response fields will be added, not removed or renamed. When a new official administrative version is published, the administrativeVersion field changes and the change is recorded in the project changelog.

Endpoints

GET/api/projects/data-bridge/resolve

Resolve a place name, Khmer name or official code to one official entity, or report that it is ambiguous or unresolved.

Parameters for /api/projects/data-bridge/resolve
ParameterRequiredDescription
qyesThe value to resolve.
levelnoprovince, district, commune or village.
parent_codenoOfficial code that constrains candidates.
parentnoFree-text parent context, for example a province name.

GET/api/projects/data-bridge/search

Ranked suggestions for a partial query. Use this for a search box, and resolve for a decision.

Parameters for /api/projects/data-bridge/search
ParameterRequiredDescription
qyesPartial search text.
levelnoRestrict to one administrative level.
parent_codenoRestrict to one parent.
limitnoUp to 25. Default 12.

GET/api/projects/data-bridge/provinces

List the capital and provinces.

Parameters for /api/projects/data-bridge/provinces
ParameterRequiredDescription
qnoFilter by name or code prefix.
limitnoDefault 50, maximum 200.
cursornoThe last code from the previous page.

GET/api/projects/data-bridge/districts

List municipalities, districts and khans.

Parameters for /api/projects/data-bridge/districts
ParameterRequiredDescription
province_codenoRestrict to one province.
parent_codenoAlias for province_code.
qnoFilter by name or code prefix.
limitnoDefault 50, maximum 200.
cursornoThe last code from the previous page.

GET/api/projects/data-bridge/communes

List communes and sangkats.

Parameters for /api/projects/data-bridge/communes
ParameterRequiredDescription
district_codenoRestrict to one district.
province_codenoRestrict to one province.
qnoFilter by name or code prefix.
limitnoDefault 50, maximum 200.
cursornoThe last code from the previous page.

GET/api/projects/data-bridge/villages

List villages.

Parameters for /api/projects/data-bridge/villages
ParameterRequiredDescription
commune_codenoRestrict to one commune.
district_codenoRestrict to one district.
qnoFilter by name or code prefix.
limitnoDefault 50, maximum 200.
cursornoThe last code from the previous page.

GET/api/projects/data-bridge/entities/{code}

Look up by official code, with the parent chain and direct children. Returns an array, because some codes are published for more than one place.

Parameters for /api/projects/data-bridge/entities/{code}
ParameterRequiredDescription
childrennoSet to false to omit the children array.
limitnoMaximum children returned. Default 50.

GET/api/projects/data-bridge/datasets

The dataset catalogue: publisher chain, coverage, record counts, hashes and sync state.

GET/api/projects/data-bridge/compatibility

Run one of the curated dataset comparisons. Omit pair to list the available comparisons.

Parameters for /api/projects/data-bridge/compatibility
ParameterRequiredDescription
pairnoComparison key.

Example

A live response from this deployment, generated when this page was built.

GET https://globescraper.com/api/projects/data-bridge/resolve?q=Tonle%20Basak

{
  "query": "Tonle Basak",
  "status": "matched",
  "result": {
    "code": "120101",
    "level": "commune",
    "nameEn": "Tonle Basak",
    "nameKh": "ទន្លេបាសាក់",
    "adminType": null,
    "parentCode": "1201",
    "hierarchy": {
      "province": {
        "code": "12",
        "nameEn": "Phnom Penh",
        "nameKh": "រាជធានីភ្នំពេញ"
      },
      "district": {
        "code": "1201",
        "nameEn": "Chamkar Mon",
        "nameKh": "ចំការមន"
      },
      "commune": null
    }
  },
  "match": {
    "method": "exact_english",
    "confidence": 1,
    "confidencePercent": 100,
    "confidenceBand": "high",
    "derived": false
  },
  "candidates": [
    {
      "code": "120101",
      "level": "commune",
      "nameEn": "Tonle Basak",
      "nameKh": "ទន្លេបាសាក់",
      "adminType": null,
      "parentCode": "1201",
      "hierarchy": {
        "province": {
          "code": "12",
          "nameEn": "Phnom Penh",
          "nameKh": "រាជធានីភ្នំពេញ"
        },
        "district": {
          "code": "1201",
          "nameEn": "Chamkar Mon",
          "nameKh": "ចំការមន"
        },
        "commune": null
      },
      "match": {
        "method": "exact_english",
        "confidence": 1,
        "confidencePercent": 100
      }
    }
  ],
  "reason": "Exact match on the official romanised name.",
  "provenance": {
    "datasetId": "pd_68e370856a965e00074a5e7b",
    "datasetName": "Cambodia Geographical List 2025",
    "publisher": "Ministry of Land Management, Urban Planning and Construction",
    "publisherAbbreviation": "MLMUPC",
    "originalProvider": null,
    "portal": "Data EF",
    "portalOperator": "General Directorate of Digital Economy, Ministry of Economy and Finance",
    "sourceUrl": "https://data.mef.gov.kh/datasets/pd_68e370856a965e00074a5e7b",
    "administrativeVersion": "2025",
    "lastRetrievedAt": "2026-08-07T22:11:45.711Z",
    "reuse": {
      "basis": "terms",
      "name": "Data EF Terms of Use",
      "url": "https://data.mef.gov.kh/terms-of-use",
      "summary": "Commercial and non-commercial use is expressly permitted, with attribution to the data source required. Bulk redistribution is not expressly addressed, so Data Bridge does not offer one.",
      "attributionNote": "Attribution names the data owner, the Ministry of Land Management, Urban Planning and Construction, rather than the portal alone."
    },
    "derived": false,
    "attribution": "Cambodia Geographical List 2025, published by Ministry of Land Management, Urban Planning and Construction, accessed via Data EF. Used under Data EF Terms of Use.",
    "disclaimer": "Cambodia Data Bridge is an independent GlobeScraper project. It is not affiliated with, endorsed by or connected to the Royal Government of Cambodia, the Ministry of Economy and Finance or its Data EF portal, the United Nations Office for the Coordination of Humanitarian Affairs, or Cisco. Official source values are identified separately from GlobeScraper-derived matches, scores and interpretations."
  }
}

Matching caveats

A status of matched with method fuzzy_english means a spelling was close enough to accept, not that the identity was verified. Treat those as probable and check the source where certainty matters. A status of ambiguous means the registry genuinely holds more than one candidate; add parent context rather than taking the first candidate.

Read the full methodology

Cambodia Data Bridge is an independent GlobeScraper project. It is not affiliated with, endorsed by or connected to the Royal Government of Cambodia, the Ministry of Economy and Finance or its Data EF portal, the United Nations Office for the Coordination of Humanitarian Affairs, or Cisco. Official source values are identified separately from GlobeScraper-derived matches, scores and interpretations.

Official values come from the Cambodia Geographical List 2025, published by the Ministry of Land Management, Urban Planning and Construction through Data EF, the open data portal operated by the General Directorate of Digital Economy, Ministry of Economy and Finance.