{"name":"Retty Restaurants API","description":"Restaurants on Retty, the Japanese restaurant review site, with name, area and cuisine, budget, opening status, a diner's comment and link.","api_id":"generated_53764a60abd3eaf1eda3b8a4","slug":"retty-restaurants-api","source":{"name":"Retty","domain":"retty.me","url":"https://retty.me/"},"category":"businesses_places","countries":["JP"],"languages":["ja"],"record_types":[],"tags":[],"limitations":["Text is in Japanese, as the site writes it.","Budget is a number in Japanese yen, such as 2000."],"updated":"2026-11-13","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-12T19:37:11.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_53764a60abd3eaf1eda3b8a4_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"4814ef50239e5effac5adfd80ffab64d940386b311cd5836618c01b2e074fa28","method":"POST","path":"/v1/catalog/public/apis/generated_53764a60abd3eaf1eda3b8a4/endpoints/generated_53764a60abd3eaf1eda3b8a4_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_53764a60abd3eaf1eda3b8a4/endpoints/generated_53764a60abd3eaf1eda3b8a4_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"enrich_records":{"type":"boolean","default":true,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."},"category":{"x-enum-labels":["ランチ","デート","食べ放題","女子会","合コン","誕生日","禁煙","喫煙可","肉","美味しい店・安い店","ご飯","ディナー","飲み放題","記念日","個室","結婚記念日","接待・会食","宴会・飲み会","クラフトビールが飲める","結婚式 二次会","大人の隠れ家","夜景のきれいなレストラン","クリスマスディナー","クーポンあり","忘年会","日本酒が飲める","ワインが飲める","焼酎が飲める","子連れOK","ブランチ","朝食・モーニング","おひとりさまOK","送別会","歓迎会","せんべろ","PayPayポイントがもらえる","PayPay決済可","夜カフェ","個室ランチ","個室デート","ランチデート","ランチ女子会","食べ放題飲み放題","おしゃれなランチ","おしゃれな個室","合コン個室","個室接待","無料wifi","電源カフェ","食べ歩き","昼飲み","深夜営業","激辛","ネット予約可","ハッピーアワー","PayPayポイント4倍","予約人気店","カジュアル","おしゃれ","大人デート","オトナの新年会","サクッと新年会","オトナの忘年会","サクッと忘年会","おしゃれにメリクリ","贅沢なクリスマス"],"x-value-status":["verified","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","verified","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","verified","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed","observed"],"x-source-key":"category","type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9\\-]{0,31}$","minLength":1,"maxLength":32,"examples":["PUR1","PUR3","PUR2","PUR4","PUR6","PUR50","PUR49","PUR48","PUR47","PUR46","PUR45","PUR44","PUR5","PUR66","PUR9","PUR7","PUR14","PUR8","PUR74","PUR15","PUR16","PUR17","PUR25","PUR28","PUR26","PUR29","PUR30","PUR88","PUR34","PUR35","PUR42","PUR12","PUR18","PUR19","PUR75","PUR93","PUR90","PUR76","PUR52","PUR53","PUR54","PUR55","PUR56","PUR57","PUR58","PUR59","PUR60","PUR62","PUR63","PUR67","PUR68","PUR69","PUR70","PUR94","PUR95","PUR10005","PUR10004","PUR10003","PUR10001","PUR10002","PUR27001","PUR27002","PUR26001","PUR26002","PUR25001","PUR25002"],"x-open-values":true,"description":"Optional. The name of a page of the same kind as the pages the pasted one links (any name that fits the pattern; the examples are the names it links). The site decides: a name it does not serve is refused as input_value_unverified. Omit for the pasted page (its own name asks for it too).","not":{"type":"string","pattern":"\\n"},"x-source-route":"path_segment"}},"required":[],"additionalProperties":false},"output_schema":{"type":"object","additionalProperties":true,"required":["title","url"],"properties":{"alt":{"type":["string"]},"budget_price":{"type":"integer","x-lower-bound":true,"description":"A value the source shows with a trailing '+' (such as '1M+') is a lower bound."},"budgets_price":{"type":"integer","x-lower-bound":true,"description":"A value the source shows with a trailing '+' (such as '1M+') is a lower bound."},"information":{"type":"array","items":{"type":"string"}},"report_comment":{"type":"string"},"restaurant_voice":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"restaurant_id":{"type":"string"},"business_status":{"type":"string"},"category":{"type":"string"},"category_path":{"type":"array","items":{"type":"string"}},"official_site_label":{"type":"string"},"restaurant_name":{"type":"string"}}},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-12T19:37:11.472Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"title":"欧風カレー ボンディ 神保町本店","category":"神保町 カレー","budget_price":2000,"business_status":"OPEN","report_comment":"日曜日の13時過ぎに到着、 90分くらい並んで食べました。 ビーフカレー、 めちゃくちゃ美味しかった","url":"https://retty.me/area/PRE13/ARE11/SUB1104/100000003716/"},{"title":"カリーライス専門店エチオピア 本店","category":"御茶ノ水 カレー","budget_price":1000,"business_status":"OPEN","report_comment":"ビーフカレー辛口、ラッシーをいただきました。 インド系の店員さんが、案内してくれます。 カウンター、テーブルは相席あり。 2人以上は、2階に案内されます。 前菜で茹でたポテトをいただきました。 何回でもおかわり自由ですが、1個ずつです。 ビーフカレーは、スパイシーでとても美味しいです。 野菜でピーマンが入っていてそれもアクセントになります。 福神漬けをたっぷりとのせて美味しく完食できました。 ラッシーは、濃厚で期待通りでした。 早くも2回目は、夕食に利用されていただきました。 今回は、ビーフ3辛でルーとライスを大盛り、でいただきました。玉ねぎのアチャールをつけました。辛口でしたが、カレーのよい箸休めになり、カレーを一層引き立ててくれました。大盛りは、かなりボリュームがありました。","url":"https://retty.me/area/PRE13/ARE11/SUB1103/100000003717/"}]}],"request_example":{"body":{"input":{"category":"PUR1"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_53764a60abd3eaf1eda3b8a4/endpoints/generated_53764a60abd3eaf1eda3b8a4_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"category\": \"PUR1\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_53764a60abd3eaf1eda3b8a4/endpoints/generated_53764a60abd3eaf1eda3b8a4_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/retty-restaurants-api/","markdown":"https://cleanedweb.com/catalog/retty-restaurants-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_53764a60abd3eaf1eda3b8a4/endpoints/generated_53764a60abd3eaf1eda3b8a4_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/retty-restaurants-api/","markdown":"https://cleanedweb.com/catalog/retty-restaurants-api/index.md","contract":"https://cleanedweb.com/catalog/retty-restaurants-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
