restaurants

travel

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