This API provides fast and reliable **nearby places search**, **local business discovery**, and **points of interest (POI) lookup** for any location worldwide using open geospatial data.

Getting Started

To begin using this API, follow these steps and make your first API call: **Subscribe to a plan:** Visit our Pricing page and subscribe to one of the available plans. If you are just starting, you can subscribe to the free BASIC plan of the API (hard-limited and no credit card required). **Make your first API call:** Visit the RapidAPI Playground — the Nearby Places endpoint should be selected and displayed on the main panel view. Since default query parameter values are provided, simply click the blue **“Test endpoint”** button to make your first API call. The JSON response will be displayed on the right panel. **Documentation and Resources:** Refer to the detailed endpoint descriptions, input parameters, and response examples provided in the Endpoints tab. Code snippets are available for popular programming languages including JavaScript, Python, Java, Shell, and more to help you quickly integrate the API. You should be good to go now!

Authentication

To authenticate with the API, send the **X-RapidAPI-Host** header along with the **X-RapidAPI-Key** header set to your RapidAPI App API Key (as shown in the endpoint Code Snippets).

Input Parameters

The following query parameters are supported by the API: **location** (required) Location name, address, city, or landmark to search nearby places from. Example: `New York Times Square` **type** (optional) Type of place to search for (OpenStreetMap amenity tag). Default: `restaurant` Example values: `restaurant`, `cafe`, `hospital`, `hotel`, `pharmacy`, `bank`, `school`, `atm`, `parking`, `fuel`, `supermarket`, `mosque`, `police`, `library`, `gym` **radius** (optional) Search radius in meters. Range: `100 – 10000` Default: `2000`

Response Structure

Here’s an example of a successful response: ``` { "success": true, "search": { "location": "Times Square, Manhattan, New York, USA", "latitude": "40.7580", "longitude": "-73.9855", "radius_meters": 2000, "place_type": "restaurant" }, "total_results": 2, "places": [ { "name": "Joe's Pizza", "type": "restaurant", "latitude": 40.7589, "longitude": -73.9841, "address": "Broadway", "phone": "+1 212-555-1234", "website": "https://joespizza.com" }, { "name": "Hard Rock Cafe", "type": "restaurant", "latitude": 40.7573, "longitude": -73.9865, "address": "7th Avenue", "phone": "", "website": "" } ] } ``` Please note that some errors might be returned by the RapidAPI gateway and will have a different structure. Please refer to the Error Handling / Error Response Structure section for more details. In addition, RapidAPI gateway adds several headers to each response. For more information, please refer to [https://docs.rapidapi.com/docs/response-headers](https://docs.rapidapi.com/docs/response-headers).

Endpoints

For detailed endpoint parameters, response fields, and live testing, please refer to the **Endpoints** section of this API.

Rate Limiting

Each subscription plan defines the maximum number of requests permitted per month, along with a rate limit expressed in RPS (Requests Per Second). All free plans (such as BASIC) are limited to **1000 requests per hour**, as required by RapidAPI.

Rate Limits Headers

All API responses include the following rate limit headers: **x-ratelimit-requests-limit:** Total number of requests allowed by your subscription. **x-ratelimit-requests-remaining:** Remaining requests before reaching the quota limit. **x-ratelimit-requests-reset:** Time in seconds until the quota resets.

Handling Limits

When rate limits are exceeded, the API will return a **429 Too Many Requests** error. ``` { "message": "Too many requests" } ``` Wait until the limit resets or upgrade your subscription plan for higher limits.

Code Examples

Code examples for JavaScript, Python, Java, Shell, and other popular programming languages are available in the **Endpoints** tab under **Code Snippets**.

Common HTTP Status Codes

**400 Bad Request:** Missing or invalid parameters **403 Forbidden:** Invalid API key or no active subscription **404 Not Found:** Invalid endpoint **429 Too Many Requests:** Rate limit exceeded **5XX Server Error:** Temporary server-side issue

Support

If you encounter any issues or need clarification, please contact us with the error code, message, and request context, and we will assist you promptly.

Contact Us

For custom plans, enterprise usage, or high-volume requests: **Email:** [alreadycoded@gmail.com](mailto:alreadycoded@gmail.com) **Website:** [https://www.alreadycoded.com](https://www.alreadycoded.com)