青果物卸売市場調査(都市別)データ取得API:Get/{MarketSurveyId}
- 更新日 2024-10-21
概要
API名称
説明
農林水産省が提供する、全国の主要都市における青果物(野菜・果実)の産地別卸売数量と価格などの日別データです。2019年1月以降のデータが取得できます。 ※青果物卸売市場調査の概要(農水省Webサイト)https://www.maff.go.jp/j/tokei/kouhyou/seika_orosi/gaiyou/index.html
本APIの利用にあたっては利用規約への同意の上、別途利用申請が必要ですので、ご利用の際は
「農業データ連携基盤(WAGRI)利⽤・変更申請ページ」
https://wagri-subscription.db.naro.go.jp/ords/r/prd/subscription/pre-registration
からご申請をお願い申し上げます。
■API利用マニュアル・利用規約等の詳細:添付ファイル「農林水産省オープンデータAPIの利用マニュアル、利用規約」
■本APIの活用事例(セラク様):添付ファイル「本APIの活用事例(セラク様)」
データの更新頻度
カテゴリー
添付ファイル
■農林水産省オープンデータAPIの利用マニュアル、利用規約
説明
利用承諾後、APIの利用者権限を付与し、申請いただいたご担当者様のメールアドレス宛にご連絡します。
- 畜産クラウド_牛飼養頭数・施設数等API利用マニュアル
- 農作物名(GL3)・粗飼料名ガイドラインAPI利用マニュアル
- 農作業名ガイドライン(GL1)API利用マニュアル
- 食肉卸売市場・と畜場統計調査API利用マニュアル
- 登録肥料API利用マニュアル
- 青果物卸売市場調査API利用マニュアル
- 青果物市況情報API利用マニュアル
- WAGRIにおける農林水産省オープンデータAPI利用規約
- 食肉卸売市場調査API(豚・牛)_コード一覧
- 青果物卸売市場調査API_コード一覧
- 青果物市況情報API_コード一覧
■本APIの活用事例(セラク様)
リクエスト
URL
https://api.wagri.net/API/MaffOpenData/Private/FreshWholesaleMarketSurveyByCity/Get/{MarketSurveyId}
説明
登録されている市場調査データのうち、各都市単位のデータを1件指定して取得できます。 JSON 形式のレスポンス情報に含まれており、特定の 1 件を指定して取得する際に利用します。
HTTPメソッド
パラメータ
URLデータ定義
青果物卸売市場調査(都市別)(PK)
名称 | 値 | 型 | 値の説明 |
---|---|---|---|
MarketSurveyId | 青果物卸売市場調査ID | string | Required |
URL説明
JSON型式のレスポンスに含まれており、データ1件を特定するための一意のキーとなります。
呼出例
ー
レスポンス
レイアウト
レスポンスデータ定義
青果物卸売市場調査(都市別)
名称 | 値 | 型 | 値の説明 |
---|---|---|---|
MarketSurveyId | 青果物卸売市場調査ID | string | Required |
TargetDate | 年月日 | string | Required Format: date-time |
Year | 年 | integer | Required Maximum: 9999 |
Month | 月 | integer | Required Minimum: 1 Maximum: 12 |
Date | 日 | integer | Required Minimum: 1 Maximum: 31 |
WeekDay | 曜日 | string | Required Max Length: 1 |
CityCode | 都市コード | string | Required Max Length: 4 |
CityName | 都市名 | string | Required Max Length: 25 |
ItemCode | 品目コード | string | Required Max Length: 5 |
ItemName | 品目名 | string | Required Max Length: 100 |
ProductionAreaCode | 産地コード | string, null | Max Length: 5 |
ProductionAreaName | 産地名 | string, null | Max Length: 100 |
TradingVolume | 数量(Kg) | integer, null | Maximum: 999999999 |
AveragePrice | 価格(円) | integer, null | Maximum: 999999999 |
VolumeVersusPreviousDay | 対前日比数量(%) | number, null | Format: Number(10,1) |
PriceVersusPreviousDay | 対前日比価格(%) | number, null | Format: Number(10,1) |
TradingVolumeNonNumeric | 数量(非数値) | string, null | Max Length: 10 |
AveragePriceNonNumeric | 価格(非数値) | string, null | Max Length: 10 |
VolumeVersusPreviousDayNonNumeric | 対前日比数量(非数値) | string, null | Max Length: 10 |
PriceVersusPreviousDayNonNumeric | 対前日比価格(非数値) | string, null | Max Length: 10 |
レスポンス説明
青果物卸売市場調査(都市別)
レスポンス例
ー
ステータスコード
コード | 名称 | 値の説明 |
---|---|---|
400 | Bad Request | リクエストが不正です。 |
403 | Forbidden | リソースのアクセスが禁止されています。 |
500 | Internal Server Error | サーバー内部でエラーが発生しました。 |
401 | Unauthorized | 認証情報が不正です。 |
サンプルソースコード
ソースコード
ー