# Placekey

Placekey standardizes location data by assigning unique IDs to physical addresses, simplifying address matching and enabling data sharing across platforms

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `PLACEKEY`
- **Version:** 20260223_00

## Tools

### Get Geocode From Address

**Slug:** `PLACEKEY_GET_GEOCODE_FROM_ADDRESS`

This tool retrieves geocode information (latitude and longitude) for a given address using the Placekey API. It accepts address components (street_address, city, region, postal_code, iso_country_code) and returns geocode data including the unique Placekey identifier and location details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | Yes | City name |
| `region` | string | Yes | State/region code |
| `postal_code` | string | Yes | Postal/ZIP code |
| `street_address` | string | Yes | Street address of the location |
| `iso_country_code` | string | Yes | Two-letter country code |

#### 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 |

### Get Placekey

**Slug:** `PLACEKEY_GET_PLACEKEY`

Tool to get a Placekey for a single location using address, coordinates, or POI details. Use when you need to obtain a unique identifier for a physical place with support for address fields, coordinates, location name, and optional metadata for enhanced matching.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | The city where the place is located |
| `region` | string | No | The second-level administrative region (e.g., state in US) |
| `options` | object | No | Options to customize the response and matching behavior |
| `latitude` | number | No | The latitude of the place in WGS-84 coordinates |
| `query_id` | string | No | Custom identifier for this query. Will be echoed back in the response. |
| `longitude` | number | No | The longitude of the place in WGS-84 coordinates |
| `postal_code` | string | No | The postal code for the place |
| `location_name` | string | No | The name of the place or business (POI name) for better matching |
| `place_metadata` | object | No | Additional metadata about the place to improve matching accuracy |
| `street_address` | string | No | The street address of the place |
| `iso_country_code` | string | No | The ISO 2-letter country code (e.g., US, CA, GB) |

#### 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 |

### Get placekey from address

**Slug:** `PLACEKEY_GET_PLACEKEY_FROM_ADDRESS`

Convert a physical address into a unique Placekey identifier. The Placekey is a universal standard identifier for any physical place that helps in location matching, enrichment, and deduplication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | Yes | The city name |
| `region` | string | Yes | The state/region code (e.g., 'CA' for California) |
| `postal_code` | string | Yes | The postal/ZIP code |
| `location_name` | string | No | Name of the location/business if available |
| `street_address` | string | Yes | The street address of the location |
| `iso_country_code` | string | Yes | The two-letter ISO country code (e.g., 'US' for United States) |

#### 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 |

### Get Placekeys Bulk

**Slug:** `PLACEKEY_GET_PLACEKEYS_BULK`

Get Placekeys for multiple locations in bulk (up to 100 queries per request). All queries must have the same iso_country_code. Supports address, coordinates, and POI queries with optional query_id for tracking. Returns an array of Placekey results for each query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `options` | object | No | Options to customize the Placekey response |
| `queries` | array | Yes | Array of location queries. Maximum 100 queries per request. All queries must have the same iso_country_code. |

#### 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 |