✈️

restaurants

Restaurant listing with cuisine type, location, contact information, rating, price range, opening hours, delivery availability, and images. Used for restaurant discovery platforms, food delivery apps, and dining guides.

🎯 Request Builder

https://api.mockly.codes/restaurants?page=1&limit=10&count=10
📡

Configure your request and click Send Request to see the response here.

Endpoints

GET/restaurants

Get a collection of restaurants

Alternative: /travel/restaurants
GET/restaurants/:id

Get a single restaurant by ID

Alternative: /travel/restaurants/:id
GET/restaurants/meta

Get resource metadata and schema

Alternative: /travel/restaurants/meta
🔍

How to Use Search

The search feature allows you to filter results by searching for text across all or specific fields. Choose between ?q= or ?search= parameter names.

1. Basic Search

Search across all text fields:

Basic Search
GET https://api.mockly.codes/restaurants?q=laptop

2. Search Specific Fields

Field-Specific Search
GET https://api.mockly.codes/restaurants?q=laptop&search_fields=name,description

💡 Pro Tips

  • •Search is case-insensitive and performs partial matching
  • •Without search_fields, all text fields are searched
  • •Combine with pagination to handle large result sets efficiently

Code Examples

JavaScript

Fetch Collection
// Get 10 restaurants
fetch('https://api.mockly.codes/restaurants?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests
import requests

response = requests.get(
    'https://api.mockly.codes/restaurants?count=10'
)
data = response.json()

cURL

Command Line
curl "https://api.mockly.codes/restaurants?count=10"

Bypass Cache

Get Fresh Data
fetch('https://api.mockly.codes/restaurants?nocache=true')

Schema Properties

idinteger

Unique identifier for the restaurant

Gen:random_int
namestring

Restaurant name

Gen:restaurant_name
descriptionstring

Description of the restaurant, cuisine, and dining experience

Gen:paragraph
cuisinestring

Cuisine type (e.g., Italian, Japanese, Mexican, Indian, Fusion)

Gen:cuisine
addressstring

Street address of the restaurant

Gen:address
citystring

City where the restaurant is located

Gen:city
countrystring

Country where the restaurant is located

Gen:country
latitudenumber

Geographic latitude coordinate of the restaurant

Gen:latitude
longitudenumber

Geographic longitude coordinate of the restaurant

Gen:longitude
phonestring

Restaurant contact phone number

Gen:phone
emailstring

Restaurant email address

Gen:emailemail
websitestring

Restaurant website URL

Gen:urluri
ratingnumber

Average customer rating, typically on a scale of 1-5

Gen:rating
price_rangestring

Price range indicator (e.g., $, $$, $$$, $$$$)

Gen:price_range
opening_hoursstring

Opening hours or operating schedule

Gen:opening_hours
deliveryboolean

Whether the restaurant offers delivery service

Gen:boolean
imagestring

URL to the restaurant's main image

Gen:image_urluri

Query Parameters

countinteger

Number of items to return (default: 10, max: 100)

seedinteger

Seed for reproducible data generation

nocacheboolean

Bypass cache and generate fresh data on every request