Cities Database
PSGC Cities API
Endpoints explicitly limited to cities in the Philippines with smart filtering, sorting, and downward traversal to barangays.
GET
/api/v1/cities
List cities
Params:
q, region_code, province_code, per_page.
GET
/api/v1/cities/{city}
Show a city
GET
/api/v1/cities/{city}/barangays
Barangays within a city
Developer Code Samples
List Cities
cURL
curl -s https://psgc.cloud/api/v1/cities
fetch API
fetch('https://psgc.cloud/api/v1/cities')
.then(res => res.json())
.then(console.log)
Axios
import axios from 'axios';
axios.get('https://psgc.cloud/api/v1/cities')
.then(res => console.log(res.data))
PHP (Guzzle)
<?php
$client = new \GuzzleHttp\Client(['base_uri' => 'https://psgc.cloud']);
$res = $client->get('/api/v1/cities');
$body = json_decode($res->getBody(), true);
print_r($body);
Show City
cURL
curl -s https://psgc.cloud/api/v1/cities/012801
fetch API
fetch('https://psgc.cloud/api/v1/cities/012801')
.then(res => res.json())
.then(console.log)
Axios
import axios from 'axios';
axios.get('https://psgc.cloud/api/v1/cities/012801')
.then(res => console.log(res.data))
PHP (Guzzle)
<?php
$client = new \GuzzleHttp\Client(['base_uri' => 'https://psgc.cloud']);
$res = $client->get('/api/v1/cities/012801');
$body = json_decode($res->getBody(), true);
print_r($body);