# OpenCage Geocoder API

> OpenCage Geocoder API on Apizie: 1 endpoint (geocode a query) returned as clean JSON through one API key. 1 endpoint is live now. Call it over REST at https://zieapi.vercel.app/v1/places:opencagedata/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `places:opencagedata`
- Category: Places
- Status: live
- Source: https://opencagedata.com/contact
- Page: https://zieapi.vercel.app/api/places/opencagedata
- OpenAPI: https://zieapi.vercel.app/api/places/opencagedata/openapi.json

Worldwide forward and reverse geocoding

## Endpoints

### geocode a query
`GET https://zieapi.vercel.app/v1/places:opencagedata/get-v-version-format`

| Parameter | Type | Required | Description |
|---|---|---|---|
| version | integer | yes | API version. |
| format | string | yes | format of the response. One of 'json', 'xml' or 'map'. |
| q | string | yes | string or lat,lng to be geocoded. |
| key | string | yes | an application key. |
| abbrv | boolean | no | when true we attempt to abbreviate the formatted field of results. |
| address_only | boolean | no | when true we include only address details in the formatted field of results. |
| add_request | boolean | no | if true the request is included in the response. |
| bounds | string | no | four coordinate points forming the south-west and north-east corners of a bounding box (min long, min lat, max long, max lat). |
| countrycode | string | no | two letter code ISO 3166-1 Alpha 2 code to limit results to that country. |
| jsonp | string | no | wraps the returned JSON with a function name. |
| language | string | no | an IETF format language code (ex: 'es' or 'pt-BR'). |
| limit | integer | no | maximum number of results to return. Default is 10. Maximum is 100. |
| min_confidence | integer | no | integer from 1-10. Only results with at least this confidence are returned. |
| no_annotations | boolean | no | when true annotations are not added to results. |
| no_dedupe | boolean | no | when true results are not deduplicated. |
| no_record | boolean | no | when true query content is not logged. |
| pretty | boolean | no | when true results are pretty printed. Useful for debugging. |
| proximity | string | no | lat,lng to bias results. |
| roadinfo | boolean | no | match nearest road, include roadinfo annotation |

## Example
```
curl "https://zieapi.vercel.app/v1/places:opencagedata/get-v-version-format" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the OpenCage Geocoder API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/places:opencagedata/get-v-version-format with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the OpenCage Geocoder 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 OpenCage Geocoder API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key places:opencagedata.

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