店舗情報取得API

店舗情報を取得することができます。

変更履歴

リクエストURL

テスト用APIを利用したい場合は、こちらから利用申請をお願いします。

リクエストパラメータ

「Web APIの使い方#GETとは」をご参照ください。

リクエストURL

パラメータ	必須	デフォルト値	値の例	説明	補足
sellerId	〇		teststore	セラーID
shopCode			shop0001	店舗コード

サンプルリクエストURL

https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/getRealStore?sellerId=teststore&shopCode=shop0001

レスポンスフィールド

要素	型	値の例	説明
/stores	Array		店舗情報の配列
/stores/sellerId	string	teststore	セラーID
/stores/shopCode	string	ABC0001	店舗コード
/stores/branchName	string	汐留支店	支店名
/stores/zipCode	string	105-7390	郵便番号
/stores/prefecture	string	東京都	都道府県
/stores/city	string	港区	市区町村
/stores/area	string	関東	地域
/stores/address1	string	東新橋1-9-1	住所1
/stores/address2	string	東京汐留ビルディング 地下1階	住所2
/stores/phoneNumber	string	03-9999-9999	電話番号
/stores/openTime	string	0930	営業開始時間
/stores/closeTime	string	2145	営業終了時間
/stores/regularHoliday	string	0:6	実店舗定期休業週
/stores/holiday	string	20200101:0505#20210101:0505	実店舗休業日
/stores/storeCode	string	shop01:shop02:shop03	ショップコード
/stores/receiptDay	integer	1	店頭受取可能日（在庫あり）
/stores/receiptHour	string	08	店頭受取可能時間（在庫あり）
/stores/receiptDayStockLittle	integer	1	店頭受取可能日（在庫わずか）
/stores/receiptHourStockLittle	string	08	店頭受取可能時間（在庫わずか）
/stores/listUses	string	0:1:2	ファイル利用用途
/stores/lat	string	35.6809953	店舗の緯度
/stores/lon	string	139.767505	店舗の経度

サンプルレスポンス

レスポンス（JSON）

{
  "stores": [
    {
      "sellerId": "teststore",
      "shopCode": "tokyo0001",
      "branchName": "新馬場駅前店",
      "zipCode": "140-0001",
      "prefecture": "東京都",
      "city": "品川区",
      "area": "関東",
      "address1": "大井9-9-56",
      "address2": "XXXビル 9F",
      "phoneNumber": "999-9999-9999  ",
      "openTime": "0800",
      "closeTime": "2000",
      "regularHoliday": "0:6",
      "holiday": "20200101:0505#20210101:0505",
      "storeCode": "shop01:shop02:shop03",
      "receiptDay": "1",
      "receiptHour": "08",
      "receiptDayStockLittle": "1",
      "receiptHourStockLittle": "08",
      "listUses": "0:1:2",
      "lat": "35.6809953",
      "lon": "139.767505"
    },
    {
      "sellerId": "teststore",
      "shopCode": "tokyo0002",
      "branchName": "汐留支店",
      "zipCode": "105-7390",
      "prefecture": "東京都",
      "city": "港区",
      "area": "関東",
      "address1": "東新橋1-9-1",
      "address2": "東京汐留ビルディング 地下1階",
      "phoneNumber": "03-9999-9999  ",
      "openTime": "0930",
      "closeTime": "2145",
      "regularHoliday": "4:5",
      "holiday": "20200101:0505#20210101:0505",
      "storeCode": "shop01:shop02:shop03",
      "receiptDay": "1",
      "receiptHour": "08",
      "receiptDayStockLittle": "1",
      "receiptHourStockLittle": "08",
      "listUses": "0:1:2",
      "lat": "35.6809953",
      "lon": "139.767505"
    }
  ]
}

エラー

Yahoo!ショッピングで提供している全てのAPIには、共通で利用するエラーコードがあります。エラーの際には、まず始めに以下をご確認ください。

• Yahoo! ショッピングAPI共通エラーコード一覧

店舗情報取得APIで固有に返すエラーは、以下のJSONレスポンスを返します。

要素	型
/type	string
/title	int
/status	string
/detail	string

サンプルエラーレスポンス

{
    "type":"about:blank",
    "title":"Bad Request",
    "detail":"Failed to read HTTP message",
    "status":400
}

ご注意

※こちらのAPIはYahoo! ID連携に対応したAPIです。
Yahoo! ID連携によるAPIアクセス方法の詳細は、以下のページをご確認ください。

• Yahoo! ID連携
• Yahoo! ID連携によるAPIアクセス実装方法

※こちらのAPIを利用する場合は、こちらからClient ID（アプリケーションID）を取得してください。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）

利用約款

このAPIに関する利用約款はこちら。