tock.com APItock.com ↗
Search Tock restaurants by city and keyword. Get cuisine, address, accolades (Michelin, James Beard), FAQs, and contact details via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/56407e7b-33ee-493f-b58a-62046858269c/search_restaurants?city=chicago&limit=5&query=italian' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for restaurants on Tock by query keyword and city. Returns restaurant listings from the city browse page with name, slug, and URL.
| Param | Type | Description |
|---|---|---|
| city | string | City slug for browsing restaurants (e.g. 'chicago', 'new-york', 'san-francisco') |
| limit | integer | Maximum number of restaurant results to return |
| query | string | Search keyword to filter restaurants (e.g. 'italian', 'sushi', 'steakhouse') |
{
"type": "object",
"fields": {
"city": "string, the city slug searched",
"query": "string, the search keyword used",
"restaurants": "array of restaurant objects with slug, name, url, and image_url",
"total_found": "integer, number of restaurants returned"
},
"sample": {
"data": {
"city": "chicago",
"query": "italian",
"restaurants": [
{
"url": "https://www.exploretock.com/oriolechicago",
"name": "Oriole",
"slug": "oriolechicago",
"image_url": ""
},
{
"url": "https://www.exploretock.com/alinea",
"name": "Alinea",
"slug": "alinea",
"image_url": ""
}
],
"total_found": 5
},
"status": "success"
}
}About the tock.com API
The Tock API provides 2 endpoints for retrieving restaurant data from exploretock.com. Use search_restaurants to find restaurants by city slug and keyword, returning names, slugs, and image URLs. Use get_restaurant_details to pull a specific restaurant's full profile — including cuisine type, structured address, contact email, website, FAQs, and accolades such as Michelin stars and James Beard awards with year and achievement details.
Searching Restaurants
The search_restaurants endpoint accepts a city slug (e.g. chicago, new-york, san-francisco), an optional query keyword (e.g. italian, sushi, steakhouse), and an optional limit. It returns a list of restaurant objects, each containing a slug, name, url, and image_url, along with a total_found count. The slug values from these results feed directly into the details endpoint.
Restaurant Detail Fields
The get_restaurant_details endpoint accepts a single required slug and returns a full restaurant profile. Contact fields include email and website. Location is structured as an address object with street, city, state, postal_code, and country. The cuisine field names the restaurant's food category. The accolades array contains objects with type, achievement, rating, year, and icon — covering recognitions like Michelin stars and James Beard awards. A faqs array exposes the question-and-answer content Tock publishes on each restaurant page.
Coverage Notes
City coverage depends on Tock's own restaurant listings, which skew toward major US metropolitan areas and select international cities. The search_restaurants endpoint browses city-level pages and does not return paginated results beyond the limit parameter — if a city has hundreds of listings, setting an appropriate limit is necessary to control response size. Accolade data is only present for restaurants that have published recognition information on Tock.
- Build a Michelin-star restaurant finder by querying accolades across multiple city slugs
- Aggregate contact emails and websites for restaurant outreach lists filtered by cuisine type
- Populate a travel app's dining section with Tock restaurant names, images, and addresses for a given city
- Track James Beard award winners by year using the accolades array from get_restaurant_details
- Cross-reference Tock FAQ content with reservation platform listings to enrich dining guides
- Generate structured location data (street, city, state, postal_code) for mapping restaurant clusters
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.