# Geokeo

Geokeo provides geocoding services, converting addresses to coordinates and vice versa, with a free tier offering 2,500 daily API requests.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 2
- **Triggers:** 0
- **Slug:** `GEOKEO`
- **Version:** 20260211_00

## Tools

### Forward Geocoding

**Slug:** `GEOKEO_FORWARD_GEOCODING`

Convert an address or place name into geographic coordinates (latitude/longitude). Use this tool when you need to: - Find coordinates for a landmark (e.g., "Eiffel Tower", "Empire State Building") - Geocode a street address (e.g., "1600 Pennsylvania Avenue NW Washington DC") - Get location data for a city or region - Look up structured address information for a place Returns multiple results ranked by relevance, with coordinates, addresses, and OpenStreetMap links.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Address or place name to geocode. Can be a landmark, street address, city, or any location query. Maximum 50 characters. |
| `country` | string | No | Two-letter ISO 3166-1 alpha-2 country code to restrict search results to a specific country. For example: 'us' for United States, 'fr' for France. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reverse Geocoding Lookup

**Slug:** `GEOKEO_REVERSE_GEOCODING`

Convert geographic coordinates (latitude/longitude) to a human-readable address. Use this tool when you have GPS coordinates and need to find the corresponding street address, city, country, or nearby points of interest. Returns multiple results sorted by distance from the input coordinates, including structured address components and OpenStreetMap links. Note: Returns status='ZERO_RESULTS' for coordinates in oceans or remote areas without mapped addresses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api` | string | No | API key for authentication; uses metadata if not provided |
| `lat` | number | Yes | Latitude to reverse geocode, must be between -90 and 90 |
| `lng` | number | Yes | Longitude to reverse geocode, must be between -180 and 180 |
| `format` | string ("json" | "xml") | No | Response format, either 'json' or 'xml' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |