# REST Countries API

> REST Countries API on Apizie: 4 endpoints (By name, By code, By region, By currency) returned as clean JSON through one API key. 4 endpoints are live now. Call it over REST at https://apizie.tech/v1/places:rest-countries/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `places:rest-countries`
- Category: Places
- Status: live
- Source: https://restcountries.com
- Page: https://apizie.tech/api/places/rest-countries
- OpenAPI: https://apizie.tech/api/places/rest-countries/openapi.json

Facts about every country: names, capitals, currencies, languages, population, flags and borders.

## Endpoints

### By name
`GET https://apizie.tech/v1/places:rest-countries/by-name`

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes |  |
| fields | string | no | Comma-separated fields to return |

### By code
`GET https://apizie.tech/v1/places:rest-countries/by-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |

### By region
`GET https://apizie.tech/v1/places:rest-countries/by-region`

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | yes |  |
| fields | string | no |  |

### By currency
`GET https://apizie.tech/v1/places:rest-countries/by-currency`

| Parameter | Type | Required | Description |
|---|---|---|---|
| currency | string | yes |  |

## Example
```
curl "https://apizie.tech/v1/places:rest-countries/by-name" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the REST Countries API?
Create a free Apizie key, then send GET https://apizie.tech/v1/places:rest-countries/by-name with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the REST Countries API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the REST Countries 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 places:rest-countries.

### What is the status of the REST Countries API?
Live: works with just an Apizie key