Name: SkyCraft – Find Restaurants by Location | Free · $7/mo | API.market
Brand: skycraft
SKU: api-skycraft-search-restaurants
Availability: InStock
Author: API Market

Pulkit

# Search Restaurants API 🍽️

### Overview

Search through thousands of restaurants (in North America) by location, cuisine, budget, and more. This API allows you to tailor results based on distance, rating, and whether a restaurant is currently open.


💼 **Provider**: API League 

---

## Features
✅ **Location-Based:** 
Input `latitude` and `longitude` to target nearby locations. 
✅ **Flexible Filters:** 
 Narrow results by applying filters such as distance, rating, budget, cuisine, and open status. 
✅ **Result Sorting:** 
 Organize results by relevance, distance, rating, cost, or delivery speed. 
✅ **Pagination:** 
Utilize the `page` parameter to navigate through result sets.


---

## Use Cases
🔹**Food Delivery & Pickup Apps** 
Integrate to provide location-based dining options. 
🔹**Travel & Tourism Services** 
Help travelers discover local dining spots that fit their budget. 
🔹**Review & Directory Platforms** 
Offer dynamic search results with rating-based sorting. 


---

## API Reference

#### 1.Search restaurants

🔹**Query Parameters**:
| Parameter | Type | Example | Description |
|------------------|------------------|---------------|-----------------------------------------------------------------------------------------------|
| **query** | string | burger | The search query. |
| **lat** | number($double) | 32.715736 | The latitude to search around. (required) |
| **lon** | number($double) | -117.161087 | The longitude to search around. (required) |
| **distance** | integer($int32) | 5 | The maximum distance of the restaurant in miles around the given location. |
| **budget** | number($double) | 25 | The budget in USD for the meal. |
| **min-rating** | number($double) | 4.4 | The minimum rating of the restaurants in range [0,5]. |
| **cuisine** | string | Mexican | The cuisine that the restaurants should support. |
| **is-open** | boolean | true | Whether the restaurants have to be open now. |
| **page** | integer($int32) | 0 | The page of the results. |
| **sort** | string | rating | The sort parameter, one of: cheapest, fastest, rating, distance, or relevance. |
| **x-magicapi-key**| string | rxycugcuv12345| API.market API Key. |


🔹**Example Request**:

 ```
curl -X 'GET' \
 'https://prod.api.market/api/v1/apileague/search-restaurants/search-restaurants?query=burger&lat=32.715736&lon=-117.161087&distance=5&budget=25&min-rating=4.4&cuisine=Mexican&is-open=true&page=0&sort=rating' \
 -H 'accept: application/json' \
 -H 'x-magicapi-key: <your_api_key>'
```

🔹**Response**:
 ```
{
 "restaurants": [
 {
 "offers_third_party_delivery": true,
 "address": {
 "zipcode": "93257",
 "country": "US",
 "city": "San Diego",
 "latitude": 32.715829,
 "lon": -117.160935,
 "street_addr_2": "",
 "state": "CA",
 "street_addr": "1023 4th AvE.",
 "lat": 32.71587,
 "longitude": -117.161098
 },
 "supports_upc_codes": false,
 "is_open": false,
 "description": "",
 "weighted_rating_value": 5,
 "type": "restaurant",
 "offers_first_party_delivery": false,
 "aggregated_rating_count": 16,
 "pickup_enabled": false,
 "cuisines": [
 "Convenience",
 "Everyday Essentials",
 "Pharmacy",
 "Snacks"
 ],
 "miles": 0.006436,
 "dollar_signs": 1,
 "delivery_enabled": true,
 "name": "Cvs",
 "phone_number": 12345600000,
 "_id": "0bc7ce37-257a-441f-b748-56fb236da5db",
 "local_hours": {
 "operational": {
 "sunday": "07:00AM - 11:00PM",
 "saturday": "07:00AM - 11:00PM",
 "tuesday": "07:00AM - 11:00PM",
 "thursday": "07:00AM - 11:00PM",
 "friday": "07:00AM - 11:00PM",
 "wednesday": "07:00AM - 11:00PM",
 "monday": "07:00AM - 11:00PM"
 },
 "delivery": {
 "sunday": "07:00AM - 11:00PM",
 "saturday": "07:00AM - 11:00PM",
 "tuesday": "07:00AM - 11:00PM",
 "thursday": "07:00AM - 11:00PM",
 "friday": "07:00AM - 11:00PM",
 "wednesday": "07:00AM - 11:00PM",
 "monday": "07:00AM - 11:00PM"
 },
 "pickup": {
 "sunday": "Closed",
 "saturday": "Closed",
 "tuesday": "Closed",
 "thursday": "Closed",
 "friday": "Closed",
 "wednesday": "Closed",
 "monday": "Closed"
 },
 "dine_in": {
 "sunday": "07:00AM - 11:00PM",
 "saturday": "07:00AM - 11:00PM",
 "tuesday": "07:00AM - 11:00PM",
 "thursday": "07:00AM - 11:00PM",
 "friday": "07:00AM - 11:00PM",
 "wednesday": "07:00AM - 11:00PM",
 "monday": "07:00AM - 11:00PM"
 }
 }
 }
 ]
}


```
---

## Best Practices 
✅ **Accurate Coordinates:** Ensure precise `lat` and `lon` values for optimal search results. 
✅ **Combine Filters:** Apply filters like `distance`, `min-rating`, and `cuisine` to refine your search. 
✅ **Sort Wisely:** Use the `sort` parameter (e.g., distance, relevance, rating) to match user preferences. 
✅ **Caching & Paging:** Improve performance by caching popular queries and managing large result sets with `page`. 
✅ **Error Handling:** Implement robust handling for `4xx` or `5xx` status codes, such as invalid parameters or rate-limiting.


---

## SEO Keywords

🔹 
`Search restaurants`, `dining nearby`, `cuisine filter`, `budget meals`, `location-based food`

🚀 Get Started Today! 

📩 Support Contact: [support@api.market](mailto\:support@api.market)

Search restaurants near any location or address. Returns name, cuisine, hours, and ratings. Free 1500 calls/mo, from $7/mo. Start free on API.market.

SkyCraft – Find Restaurants by Location | Free · $7/mo | API.market

FREE