# World Places & Business Search

> Find restaurants, shops, hospitals, banks and any place worldwide by location, city or brand

- Vendor: `worldplaces` · version 1.0 · category Maps · tags places, poi, restaurants, business data, maps, openstreetmap, geo search, store locator, local search, location
- Datasource: aggregator routes
- Marketplace page: https://apiclay.com/api/worldplaces
- This document: https://apiclay.com/docs/worldplaces.md
- OpenAPI 3.1: https://apiclay.com/api/worldplaces/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `worldplaces`
- Updated: 2026-11-12

## About

## World Places &amp; Business Search

Search restaurants, shops, hospitals, banks, ATMs, petrol pumps, EV chargers, hotels, schools, stations and every other mapped place in the world. Find places near a point, inside a city or a map rectangle, by name or by brand, count them for market sizing, or list businesses with a phone, website or email.

### Quick start

Every endpoint is a POST. Send your ApiClay token in the `token` header and the inputs as a JSON body; every input is required.

```bash
curl -X POST 'https://api.apiclay.com/v1/api/worldplaces/places/nearby' \
  -H 'token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"type": "restaurant", "lat": 28.6315, "lon": 77.2167, "radius": 1000, "limit": 20}'
```

### Response

JSON with `elements`, one per place: `type` (node, way or relation), `id`, `lat`/`lon` (for buildings and areas, `center.lat`/`center.lon`) and `tags`. Tags always include the place's own type (e.g. `amenity: restaurant`) and usually `name`; where mapped they also carry `addr:*` (address), `phone`, `website`, `email`, `opening_hours`, `cuisine`, `brand`, `operator`, `wheelchair` and, for hotels, `stars` and `rooms`. `/places/count` returns one element whose `tags.total` is the count.

Coverage depends on the local mapping community: names and locations are good almost everywhere, phone numbers, opening hours and websites are patchy in some regions. No match returns an empty `elements` list.

### Tips

- `type`, `shop` and `cuisine` use OpenStreetMap's own values (lower case, underscores), e.g. `fast_food`, `mobile_phone`, `south_indian`.
- `city` must match the area's name in OpenStreetMap (e.g. `Bengaluru`, not `Bangalore`). Big areas take longer: a whole state can time out, a city is fine.
- Keep `radius` at 5000 metres or less and `limit` at 500 or less; each search stops after 25 seconds.

### Endpoints

**Places of one type near a point** - `/places/nearby`

- Places of one type around a point, e.g. restaurants within 1 km.
- Inputs: `type`, `lat`, `lon`, `radius`, `limit`
- Example body: `{"type": "restaurant", "lat": 28.6315, "lon": 77.2167, "radius": 1500, "limit": 20}`

**Places of one type in a city** - `/places/in-city`

- Every place of one type inside a named city or district.
- Inputs: `type`, `city`, `limit`
- Example body: `{"type": "hospital", "city": "Pune", "limit": 20}`

**Places of one type in a map rectangle** - `/places/in-box`

- Places inside the visible area of a map.
- Inputs: `type`, `south`, `west`, `north`, `east`, `limit`
- Example body: `{"type": "cafe", "south": 18.5, "west": 73.82, "north": 18.54, "east": 73.87, "limit": 20}`

**Places by name in a city** - `/places/by-name`

- Restaurants, shops, banks, hospitals and other amenities whose name contains a word.
- Inputs: `name`, `city`, `limit`
- Example body: `{"name": "Haldiram", "city": "Delhi", "limit": 20}`

**Count places of one type in a city** - `/places/count`

- How many places of one type a city has (market sizing).
- Inputs: `type`, `city`
- Example body: `{"type": "cafe", "city": "Bengaluru"}`

**Outlets of a brand in a city** - `/brands/outlets`

- Every mapped outlet of a chain (store locators, competitor maps).
- Inputs: `brand`, `city`
- Example body: `{"brand": "Domino", "city": "Mumbai"}`

**Businesses with phone, website or email** - `/businesses/contacts`

- Only businesses that have a phone, website or email mapped.
- Inputs: `type`, `city`, `limit`
- Example body: `{"type": "restaurant", "city": "Pune", "limit": 20}`

**Restaurants by cuisine near a point** - `/restaurants/by-cuisine`

- Restaurants, cafes and fast food of one cuisine around a point.
- Inputs: `cuisine`, `lat`, `lon`, `radius`
- Example body: `{"cuisine": "indian", "lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Shops of one type near a point** - `/shops/nearby`

- Retail search around a point.
- Inputs: `shop`, `lat`, `lon`, `radius`
- Example body: `{"shop": "supermarket", "lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Hospitals near a point** - `/health/hospitals`

- Health: hospitals around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Clinics near a point** - `/health/clinics`

- Health: clinics around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Pharmacies near a point** - `/health/pharmacies`

- Health: pharmacies around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Doctors near a point** - `/health/doctors`

- Health: doctors around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Dentists near a point** - `/health/dentists`

- Health: dentists around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Banks near a point** - `/money/banks`

- Money: banks around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**ATMs near a point** - `/money/atms`

- Money: atms around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Petrol pumps near a point** - `/fuel/petrol-pumps`

- Fuel and EV: petrol pumps around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**EV charging stations near a point** - `/fuel/ev-charging`

- Fuel and EV: ev charging stations around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

**Hotels near a point** - `/travel/hotels`

- Stay and travel: hotels around a point (up to 200).
- Inputs: `lat`, `lon`, `radius`
- Example body: `{"lat": 28.6315, "lon": 77.2167, "radius": 1500}`

_(README truncated; the full text is at https://apiclay.com/api/worldplaces)_

## Pricing

- Pay as you go: 0.001 credits/request
- Trial: 10 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## Aggregator routes

Each route fans out to the vendor's upstream sources (not listed) and returns one merged response.

### POST /places/nearby — Places of one type near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/places/nearby`
- Public body fields: `type` (string, required), `lat` (number, required), `lon` (number, required), `radius` (number, required), `limit` (number, required)
- Body sample (JSON):

```json
{
  "type": "<type>",
  "lat": 0,
  "lon": 0,
  "radius": 0,
  "limit": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /places/in-city — Places of one type in a city (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/places/in-city`
- Public body fields: `type` (string, required), `city` (string, required), `limit` (number, required)
- Body sample (JSON):

```json
{
  "type": "<type>",
  "city": "<city>",
  "limit": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /places/in-box — Places of one type in a map rectangle (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/places/in-box`
- Public body fields: `type` (string, required), `south` (number, required), `west` (number, required), `north` (number, required), `east` (number, required), `limit` (number, required)
- Body sample (JSON):

```json
{
  "type": "<type>",
  "south": 0,
  "west": 0,
  "north": 0,
  "east": 0,
  "limit": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /places/by-name — Places by name in a city (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/places/by-name`
- Public body fields: `name` (string, required), `city` (string, required), `limit` (number, required)
- Body sample (JSON):

```json
{
  "name": "<name>",
  "city": "<city>",
  "limit": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /places/count — Count places of one type in a city (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/places/count`
- Public body fields: `type` (string, required), `city` (string, required)
- Body sample (JSON):

```json
{
  "type": "<type>",
  "city": "<city>"
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /brands/outlets — Outlets of a brand in a city (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/brands/outlets`
- Public body fields: `brand` (string, required), `city` (string, required)
- Body sample (JSON):

```json
{
  "brand": "<brand>",
  "city": "<city>"
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /businesses/contacts — Businesses with phone, website or email (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/businesses/contacts`
- Public body fields: `type` (string, required), `city` (string, required), `limit` (number, required)
- Body sample (JSON):

```json
{
  "type": "<type>",
  "city": "<city>",
  "limit": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /restaurants/by-cuisine — Restaurants by cuisine near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/restaurants/by-cuisine`
- Public body fields: `cuisine` (string, required), `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "cuisine": "<cuisine>",
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /shops/nearby — Shops of one type near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/shops/nearby`
- Public body fields: `shop` (string, required), `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "shop": "<shop>",
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /health/hospitals — Hospitals near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/health/hospitals`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /health/clinics — Clinics near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/health/clinics`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /health/pharmacies — Pharmacies near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/health/pharmacies`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /health/doctors — Doctors near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/health/doctors`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /health/dentists — Dentists near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/health/dentists`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /money/banks — Banks near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/money/banks`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /money/atms — ATMs near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/money/atms`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /fuel/petrol-pumps — Petrol pumps near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/fuel/petrol-pumps`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /fuel/ev-charging — EV charging stations near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/fuel/ev-charging`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /travel/hotels — Hotels near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/travel/hotels`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /travel/attractions — Tourist attractions near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/travel/attractions`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /travel/museums — Museums near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/travel/museums`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /travel/viewpoints — Viewpoints near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/travel/viewpoints`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /transport/railway-stations — Railway stations near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/transport/railway-stations`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /transport/metro-stations — Metro stations near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/transport/metro-stations`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /transport/bus-stops — Bus stops near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/transport/bus-stops`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /transport/parking — Parking near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/transport/parking`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /education/schools — Schools near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/education/schools`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /education/colleges — Colleges near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/education/colleges`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /education/universities — Universities near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/education/universities`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /public/police — Police stations near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/public/police`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /public/fire-stations — Fire stations near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/public/fire-stations`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /public/post-offices — Post offices near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/public/post-offices`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /public/toilets — Public toilets near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/public/toilets`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /public/places-of-worship — Places of worship near a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/public/places-of-worship`
- Public body fields: `lat` (number, required), `lon` (number, required), `radius` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0,
  "radius": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /location/areas — Country, state, district and city of a point (failover across the vendor's sources)
- Gateway: `POST https://api.apiclay.com/v1/api/worldplaces/location/areas`
- Public body fields: `lat` (number, required), `lon` (number, required)
- Body sample (JSON):

```json
{
  "lat": 0,
  "lon": 0
}
```

- Upstream proxy: some sources use an ApiClay proxy paid by the vendor. Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/worldplaces/places/nearby" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "type": "<type>", "lat": 0, "lon": 0, "radius": 0, "limit": 0 }'
```

Index of every published API: https://apiclay.com/llms.txt
