API
食品検索・栄養成分・料理の推定カロリーを、JSONで取得できます。登録もキーも不要です。
利用条件
- 無償で利用できます。アカウント登録もAPIキーも必要ありません。
- AI解析系のエンドポイントは、1つのIPにつき1時間あたり12回までです。それ以外の読み取りに制限はありません。
- 数値を再掲する場合は、出典として文部科学省『日本食品標準成分表』と本サイトを明記してください。
- AI解析の結果は推定値です。公的な栄養表示や医療目的には使用できません。
GET
/api/search
食品名・料理名で全文検索します。
| パラメータ | 説明 |
|---|---|
q |
検索語(日本語可) |
lang |
ja(現在は日本語のみ) |
limit |
件数(既定20) |
curl 'https://calories.jp/api/search?q=さば&lang=ja&limit=5'
GET
/api/foods/{id}/nutrition
1つの食品の成分値を返します。実測値・推計値・Trの区別も含みます。
| パラメータ | 説明 |
|---|---|
id |
食品ID |
curl 'https://calories.jp/api/foods/1/nutrition'
idは/api/searchの結果に含まれます。
GET
/api/cooking-yield
調理による重量変化率を、食品名で検索します。
| パラメータ | 説明 |
|---|---|
q |
検索語(日本語可) |
lang |
ja(現在は日本語のみ) |
limit |
件数(既定20) |
curl 'https://calories.jp/api/cooking-yield?q=もも 皮つき&lang=ja'
100%を超えるものは水を吸う食品です。ゆでたスパゲッティは220%。
GET
/api/foods/{id}/cooking-yield
1つの食品について公表されている重量変化率を返します。
| パラメータ | 説明 |
|---|---|
id |
食品ID |
curl 'https://calories.jp/api/foods/1/cooking-yield'
POST
/api/analyze-dish
料理名から具材を分解し、成分表に基づいて栄養価を推定します。
| パラメータ | 説明 |
|---|---|
dish |
料理名(必須) |
shop |
店舗・チェーン名(任意) |
lang |
ja(現在は日本語のみ) |
curl -X POST 'https://calories.jp/api/analyze-dish?dish=親子丼&lang=ja'
返される数値は推定値です。実際のレシピ・分量は反映していません。
POST
/api/meal-analyzer
食事の写真から料理と具材を推定します。画像はjpeg/png/webpのみ。
| パラメータ | 説明 |
|---|---|
image |
画像ファイル(multipart/form-data) |
lang |
ja(現在は日本語のみ) |
curl -X POST 'https://calories.jp/api/meal-analyzer?lang=ja' -F '[email protected]'
返される数値は推定値です。実際のレシピ・分量は反映していません。
データの出典
成分値は文部科学省『日本食品標準成分表2023年版(八訂)』ほか公的データに基づきます。ライセンスの都合により、一部の外部データベースは配信対象に含まれません。