Complete geographic hierarchy
Navigate regions through barangays with parent and child relationships.
Philippine location infrastructure
Complete Philippine Address Data in One API
Retrieve regions, provinces, cities, municipalities, and barangays with PSGC code lookup, hierarchy navigation, and fuzzy name search.
const response = await fetch(
"/api/psgc/regions?limit=100",
);
const result = await response.json();
{
"code": "1300000000",
"name": "National Capital Region",
"level": "region"
}✓ Region-to-barangay hierarchy✓ PSGC lookup✓ Exact & fuzzy search✓ NCR support✓ Versioned datasets✓ REST API
Live API explorer
Try the Philippine Address Demo
Select a region, province, city or municipality, and barangay using live API data.
SELECTED ADDRESS
Your selected address will appear here.
{
"regionCode": null,
"provinceCode": null,
"localityCode": null,
"barangayCode": null
}Fuzzy discovery
Search Any Philippine Location
Built for real address logic
Geography without fragile spreadsheets
Search by name
Find exact, partial, and fuzzy matches across every geographic level.
PSGC code lookup
Resolve string codes while preserving every leading zero.
Duplicate-name handling
Keep same-name locations separate with their full hierarchy.
NCR and direct-region support
Model localities that do not belong to a province correctly.
Versioned datasets
Activate geographic releases only after validation.
REST API
Predictable endpoints, practical responses
Use parent-aware collections, ancestor lookups, and search without shipping a geographic dataset in your app.
GET /v1/regions
GET /v1/regions/{code}/localities
GET /v1/provinces/{code}/localities
GET /v1/cities/{code}/barangays
GET /v1/municipalities/{code}/barangays
GET /v1/locations/{code}/ancestors
GET /v1/search?q=San%20Isidro
TypeScript
Integrate with native fetch
Examples are available for JavaScript, TypeScript, Node.js, cURL, and PowerShell. Keep credentials in your server environment.
const response = await fetch(
"https://philippines-api.p.rapidapi.com/v1/search?q=San%20Isidro",
{ headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "philippines-api.p.rapidapi.com"
}}
);Where it fits
From checkout to public services
E-commerce checkout
Logistics and delivery
CRM systems
Booking platforms
Government systems
Real-estate platforms
HR onboarding
Location validation
Pricing preview
Start free, scale when ready
BASIC
Free
1,000 requests / month
For testing and prototypes
Choose on RapidAPIPRO
$9 / month
25,000 requests / month
For small production applications
Choose on RapidAPIULTRA
$29 / month
150,000 requests / month
For growing production systems
Choose on RapidAPIMEGA
$79 / month
500,000 requests / month
For high-volume integrations
Choose on RapidAPIPlans, quotas, billing, and API keys are managed securely through RapidAPI. Confirm current pricing on the listing.
Dataset transparency
Clear data contracts
Dataset version
Dataset version temporarily unavailable
API versionv1
- ✓ PSGC codes are strings
- ✓ Leading zeroes are preserved
- ✓ Geographic names are not unique
- ✓ Versions are validated before activation
FAQ
Common questions
What is PSGC?
The Philippine Standard Geographic Code is a structured classification of the country’s geographic areas.
Are location names unique?
No. Results preserve distinct locations and include hierarchy and codes for disambiguation.
How are NCR addresses handled?
Direct-region cities and municipalities work without requiring a province.
Can I search using misspelled names?
The search endpoint supports fuzzy matching when available.
Are PSGC codes returned as numbers or strings?
Strings, so leading zeroes are always preserved.
How often is the dataset updated?
Versioned datasets can be updated after validation; consult the listing for the active release.
Can I use this for address dropdowns?
Yes. The hierarchy endpoints are designed for cascading address forms.
How do I get an API key?
Subscribe to a plan on RapidAPI and use the key issued in your RapidAPI dashboard.
Is there a free plan?
The Basic preview includes 1,000 requests per month; confirm current terms on RapidAPI.
Does this API include latitude and longitude?
The current version focuses on PSGC geographic hierarchy and does not provide geocoding coordinates unless that feature is added later.
Build Philippine Address Features Faster
Start with the free plan and integrate complete Philippine geographic data into your application.