Open Data

Overview

Cambodia Postal Code Directory provides free access to our complete postal code database. Download the data for your apps, websites, or AI systems.

Data Downloads

1. Full Data (JSON)

Returns the complete postal code database as a JSON array. Best for caching locally or bulk operations.

GET https://cambo-postal.com/data.json

Response format:

{
  "data": [
    {
      "code": "010101",
      "name_en": "Banteay Neang",
      "name_km": "បន្ទាយនាង",
      "type": "commune",
      "parent": "Mongkol Borei, Banteay Meanchey"
    },
    ...
  ],
  "aliases": {
    "bkk1": "120308",
    "russian market": "120309",
    ...
  }
}

2. Search

Search postal codes by name in English or Khmer. Returns HTML partial results.

GET https://cambo-postal.com/search?q={query}

Parameters:

• q - Search query (location name, postal code, or landmark)

Example:

GET https://cambo-postal.com/search?q=phnom+penh

3. LLM-Friendly Formats

Plain text formats optimized for AI/LLM consumption:

GET https://cambo-postal.com/llms.txt
GET https://cambo-postal.com/llms-full.txt

Fair Use

To ensure service availability, please follow these guidelines:

• Search: 60 requests per minute per IP
• Data Downloads: 10 requests per hour per IP (download once and cache locally)

For best results, download the full dataset once and store it locally.

AI/LLM Usage Tips

For AI assistants and language models:

• Use /llms.txt for quick reference and overview
• Use https://cambo-postal.com/data.json to download the full dataset for comprehensive queries
• The data includes both English and Khmer names for all locations

Data Format

Each postal code record in the 'data' array includes:

• code - Postal code (6-digit, PPDDCC format)
• name_en - Location name in English
• name_km - Location name in Khmer
• type - Location type (province, district, or commune)
• parent - Parent location (district and province names)

The 'aliases' object maps popular landmark names (e.g., 'bkk1', 'russian market') to their corresponding postal codes for easy lookup.

License & Attribution

This data is provided free for public use. Data is sourced from the official Cambodian government Prakas. Please cite 'Cambodia Postal Code Directory (cambo-postal.com)' when using this data.