v2.1.0 Released

Philippine Standard Geographic Code

Lightweight, structured, and extremely fast access to regions, provinces, cities, municipalities, and barangays. Built for developers—no sign-up or authorization required.

Docs v1 Docs v2 MCP Docs Quick Sample

Premium API Features

Everything you need to build fast, geographic-aware applications in the Philippines.

Simple REST

Uniform, highly predictable endpoints for each geographic level with ancestry validation.

Fast JSON & Caching

Lean payloads, structured fields, and aggressive caching to deliver millisecond response times.

Zero Auth

Open and public reference data—start consuming immediately in local, staging, or production environments.

Quick Start

Fetch a list of regions in seconds, then traverse down to provinces, cities, municipalities, and barangays.

Usage Samples

# curl
curl -s https://psgc.cloud/api/regions | jq '.[0:3]'

# fetch (JavaScript)
const res = await fetch('https://psgc.cloud/api/regions');
const regions = await res.json();
console.log(regions[0]);

Frequently Asked Questions

Get answers to the most common questions about the PSGC Cloud platform.

Is the data official?

The data structure directly mirrors the official Philippine Standard Geographic Code (PSGC), but this service is community-provided. Always verify critical geographic boundaries independently.

How often is the API updated?

Updates occur continuously as new official releases of the PSGC database are published by the PSA (Philippine Statistics Authority).

Can I perform high-volume bulk downloads?

Yes, but please cache the results locally in your applications to reduce server load and optimize speed for your users.

Do you offer a GraphQL endpoint?

Not currently. We focus on lightweight REST endpoints to keep payloads lean, cacheable, and incredibly simple to consume.

Is there an API rate limit?

Light, intelligent rate limiting is applied to protect our infrastructure from abusive traffic. Under normal production or development usage, you will rarely experience throttling.

Start Building

Jump into our interactive documentation and start integration today with our simple geographic datasets.

Explore v1 Docs Explore v2 Docs Explore MCP Docs

Support PSGC Cloud

PSGC Cloud is maintained by John Joshua A. Lipio and shared publicly for free. If you find this resource helpful, please consider supporting hosting and maintenance costs.

Donate via QR

Fast & Easy

Scan the code with your preferred banking, payment, or e-wallet application.

Affiliate Support

No Extra Cost

Disclosure: As an affiliate partner, we may earn commissions or referral credits from qualifying purchases using the links above. We deeply appreciate your support.