# Postfinder Places API

**Canonical:** https://apis.io/apis/postfinder-io/postfinder-io-places-api/  
**Provider:** Postfinder — https://apis.io/providers/postfinder-io/  
**Base URL:** https://api.postfinder.io  
**Documentation:** https://postfinder.io/api/

Postfinder Places API is one of 5 APIs that [Postfinder](https://apis.io/providers/postfinder-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Places. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The directory as the site's pages have it: countries, regions, suburbs and places.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/countries` | Every country the directory covers |
| GET | `/v1/countries/{country}` | One country and its regions |
| GET | `/v1/countries/{country}/regions/{region}` | One region and its suburbs |
| GET | `/v1/countries/{country}/categories/{category}` | One kind of place across a country |
| GET | `/v1/localities/{country}/{region}/{locality}` | One suburb: every place in it |
| GET | `/v1/places` | Places in a suburb, filtered |
| GET | `/v1/places/{publicID}` | One place in full |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/openapi/postfinder-io-places-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-places-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-nearby-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-search-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-countries-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-category-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-postcodes-response-schema.json

## Other Postfinder APIs (4)

- [Postfinder Nearby API](https://apis.io/apis/postfinder-io/postfinder-io-nearby-api/)
- [Postfinder Postcodes API](https://apis.io/apis/postfinder-io/postfinder-io-postcodes-api/)
- [Postfinder Reference API](https://apis.io/apis/postfinder-io/postfinder-io-reference-api/)
- [Postfinder Search API](https://apis.io/apis/postfinder-io/postfinder-io-search-api/)

## Tags

Places

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/postfinder-io/postfinder-io-places-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/postfinder-io/.