# Input Parameters

A general Placekey API request body is a JSON object with the following possible parameters:

| Field                               | Description                                                                                                                                   | Type   | Example                                           |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------- |
| query.latitude                      | The latitude of the place in WGS-84 coordinates                                                                                               | double | 37.7371                                           |
| query.longitude                     | The longitude of the place in WGS-84 coordinates                                                                                              | double | -122.44283                                        |
| query.location\_name                | The name of the place                                                                                                                         | string | "Twin Peaks Petroleum"                            |
| query.street\_address               | The street address of the place                                                                                                               | string | "1543 Mission Street"                             |
| query.city                          | The city where the place is located                                                                                                           | string | "San Francisco"                                   |
| query.region                        | The second-level administrative region below nation for the place. In the US, this is the state.                                              | string | "California" or "CA"                              |
| query.postal\_code                  | The postal code for the place                                                                                                                 | string | "94105"                                           |
| query.iso\_country\_code            | The ISO 2-letter Country Code for the place                                                                                                   | string | "US"                                              |
| query.place\_metadata.phone\_number | The phone number of the POI                                                                                                                   | string | "+14151234567"                                    |
| query.place\_metadata.naics\_code   | 4-digit or 6-digit NAICS code describing the business                                                                                         | string | "441110"                                          |
| query.place\_metadata.website       | The web URL for the POI's publicly available website                                                                                          | string | "<https://www.walmart.com/store/3114-saugus-ma/>" |
| query.place\_metadata.mcc\_code     | The merchant category code. A four-digit number used by credit card companies to classify businesses.                                         | string | "9399"                                            |
| query.place\_metadata.store\_id     | The unique ID associated with the store as provided and maintained by the store/brand itself                                                  | string | "36558"                                           |
| query\_id                           | A custom identifier for this query. Echoed back in the response. Auto-assigned if not provided.                                               | string | "my-query-1"                                      |
| options.fields                      | A list of additional fields to include in the response. See [Optional Responses](/documentation/placekey-api/response/optional-responses.md). | array  | \["address\_placekey", "confidence\_score"]       |

> 📘 In order to return a Placekey some parameters are required. See [Minimum Inputs](/documentation/placekey-api/input-parameters/minimum-inputs.md) for details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.placekey.io/documentation/placekey-api/input-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.