About this API
Retty is a Japanese restaurant review site. This API reads its restaurant listings and returns a record for each restaurant: name, area and cuisine, budget, opening status, the restaurant's own message, a diner's comment and link.
A category input, such as lunch or dinner, narrows a run to one kind of visit.
Typical uses
- Build a list of restaurants in one area and cuisine.
- Compare budgets across restaurants.
- Read what diners say about a restaurant.
What you get
| Field | Type | Sample value |
|---|---|---|
title |
string | 欧風カレー ボンディ 神保町本店 |
category |
string | 神保町 カレー |
budget_price |
integer | 2000 |
business_status |
string | OPEN |
report_comment |
string | 日曜日の13時過ぎに到着、 90分くらい並んで食べました。 ビーフカレー、 めちゃくちゃ美味しかった |
url |
string | retty.me/area/PRE13/ARE11/SUB1104/1000000… |
All 14 fields
Key fields
titlecategorybudget_pricebusiness_statusreport_commenturl
Technical fields
altbudgets_priceinformationrestaurant_voicerestaurant_idcategory_pathofficial_site_labelrestaurant_name
Every field with its type, and the schemas, are in contract.json.
Sample records
2 saved records. This is a saved sample, not a live run.
title |
category |
budget_price |
business_status |
report_comment |
url |
|---|---|---|---|---|---|
| 欧風カレー ボンディ 神保町本店 | 神保町 カレー | 2000 | OPEN | 日曜日の13時過ぎに到着、 90分くらい並んで食べました。 ビーフカレー、 めちゃくちゃ美味しかった | retty.me/area/PRE13/ARE11/SUB1104/1000000… |
| カリーライス専門店エチオピア 本店 | 御茶ノ水 カレー | 1000 | OPEN | ビーフカレー辛口、ラッシーをいただきました。 インド系の店員さんが、案内してくれます。 カウンター、テーブルは相席あり。 2人以上は、2階に案内されます。 前… | retty.me/area/PRE13/ARE11/SUB1103/1000000… |
Scroll sideways to see more columns.
Inputs
-
categorytextOptional. Free text: any category the site serves, written with letters, digits and hyphens, up to 32 characters. A name the site does not serve is refused with input_value_unverified. Leave it out for the default listing.
enrich_records is on by default and adds the fields that only appear on each record's detail page. Send false to read list fields only. See Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_53764a60abd3eaf1eda3b8a4/endpoints/generated_53764a60abd3eaf1eda3b8a4_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_53764a60abd3eaf1eda3b8a4/endpoints/generated_53764a60abd3eaf1eda3b8a4_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"category": "PUR1"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Retty Restaurants API.
The agent calls get_api with generated_53764a60abd3eaf1eda3b8a4, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- Businesses & places
- Countries
- Japan
- Languages
- Japanese
Limitations
- Text is in Japanese, as the site writes it.
- Budget is a number in Japanese yen, such as 2000.
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Retty.