# Locations API

> Locations API on Apizie: 5 endpoints (Retrieves a list of addresses when supplied with a house number or name and a postcode. It is generally used…, Retrieves a list of countries and its currencies., Retrieves the specified country and its currency., Retreives the list of currencies., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/entertainment:whapi-locations/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `entertainment:whapi-locations`
- Category: Entertainment
- Status: byok
- Source: https://whapi.com
- Page: https://apizie.tech/api/entertainment/whapi-locations
- OpenAPI: https://apizie.tech/api/entertainment/whapi-locations/openapi.json

The Locations API is a collection of methods that support geographical information. The first method is an address lookup service for UK addresses. This service can be used to provide a new customer with a list of…

## Endpoints

### Retrieves a list of addresses when supplied with a house number or name and a postcode. It is generally used…
`GET https://apizie.tech/v1/entertainment:whapi-locations/address-lookup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| houseNum | string | yes | House number or name of the address. |
| postCode | string | yes | Postcode of the address, no spaces required. |

### Retrieves a list of countries and its currencies.
`GET https://apizie.tech/v1/entertainment:whapi-locations/get-countries` (byok)

### Retrieves the specified country and its currency.
`GET https://apizie.tech/v1/entertainment:whapi-locations/get-country` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| countryCode | string | yes | Code of the country |

### Retreives the list of currencies.
`GET https://apizie.tech/v1/entertainment:whapi-locations/get-currencies` (byok)

### Retreives the specified currency.
`GET https://apizie.tech/v1/entertainment:whapi-locations/get-currency` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| currencyCode | string | yes | Code of the currency |

## Example
```
curl "https://apizie.tech/v1/entertainment:whapi-locations/address-lookup" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Locations API?
Create a free Apizie key, then send GET https://apizie.tech/v1/entertainment:whapi-locations/address-lookup with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Locations API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Locations itself also needs your own key from whapi.com.

### Can AI agents use the Locations API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key entertainment:whapi-locations.

### What is the status of the Locations API?
Needs your own provider key (bring your own key)