楽天市場データは、以下のデータ構成になっています。
コンテンツデータ構成は、SweetMagicコンテンツ時のインプットデータの構成です。
後半のアイテムデータの構成は、CSV出力時のインプットデータの構成になります。
楽天市場のアイテムデータ構成は、商品検索とランキング検索で構成が若干異なります。
なお、商品データの構成は、楽天APIの楽天市場系APIと同じ構成になっています。
楽天市場APIの仕様変更に伴い、楽天市場データ構成も変更される場合があります。
詳細については、楽天APIを参照してください。
(1)コンテンツデータ構成
データ構成 | データ型 | 説明 | ||||||
楽天市場データ | Object | SweetMagicオブジェクト | ||||||
count | int | 検索結果の総商品数 | ||||||
hits | int | 1回の検索でヒットする商品数 | ||||||
startPage | int | 取得開始ページ番号 | ||||||
endPage | int | 取得終了ページ番号 | ||||||
first | int | ページ内商品番号開始追番 | ||||||
last | int | ページ内商品終追番 | ||||||
carrierType | int | キャリア情報 | ||||||
pageCount | int | 総ページ数 | ||||||
items | Object[] | 商品情報の配列 商品情報の詳細は、(2)商品情報のデータフォーマットを参照 |
||||||
isError | bool | エラーが発生したか場合はTrueを、正常に終了した場合はfalseを返す | ||||||
errorInfo | Object | エラーが発生した場合にのみ、エラー情報を返す | ||||||
error | string | エラーコード | ||||||
description | string | エラーメッセージ |
(2)商品情報のデータフォーマット
データ構成 | データ型 | 説明 | 商品検索 | ランキング | ||||||
商品データ | Object | 商品情報 | ||||||||
rank | int | ランキング | - | ○ | ||||||
carrier | int | キャリア情報 | - | ○ | ||||||
itemName | string | 商品名 | ○ | ○ | ||||||
catchCopy | string | キャッチコピー | ○ | ○ | ||||||
itemCode | string | 商品コード | ○ | ○ | ||||||
itemPrice | int | 商品価格 | ○ | ○ | ||||||
itemCaption | string | 商品説明文 | ○ | ○ | ||||||
itemUrl | string | 商品URL | ○ | ○ | ||||||
affiliateUrl | string | アフィリエイトURL | ○ | ○ | ||||||
imageFlag | int | 商品画像有無フラグ(0:商品画像無し、1:商品画像有り) | ○ | ○ | ||||||
mediumImageUrls | string[] | 商品画像128x128URLのリスト | ○ | ○ | ||||||
smallImageUrls | string[] | 商品画像64x64URLのリスト | ○ | ○ | ||||||
availability | int | 販売可能フラグ(0:販売不可能、1:販売可能) | ○ | ○ | ||||||
taxFlag | int | 消費税フラグ(0:税込、1:税別) | ○ | ○ | ||||||
postageFlag | int | 送料フラグ(0:送料込、1:送料別) | ○ | ○ | ||||||
creditCardFlag | int | クレジットカード利用可能フラグ(0:カード利用不可、1:カード利用可) | ○ | ○ | ||||||
shopOfTheYearFlag | int | ショップオブザイヤーフラグ(0:ショップオブザイヤー未受賞店舗、1:ショップオブザイヤー受賞店舗) | ○ | ○ | ||||||
shipOverseasFlag | int | 海外配送フラグ(0:海外配送不可、1:海外配送可能) | ○ | ○ | ||||||
shipOverseasArea | string | 海外配送対象地域 | ○ | ○ | ||||||
asurakuFlag | int | あす楽フラグ(0:翌日配送不可、1:翌日配送可能) | ○ | ○ | ||||||
asurakuClosingTime | string | あす楽〆時間 | ○ | ○ | ||||||
asurakuArea | string | あす楽配送対象地域 | ○ | ○ | ||||||
affiliateRate | double | アフィリエイト利用利率 | ○ | ○ | ||||||
startTime | string | 販売開始時刻 | ○ | ○ | ||||||
endTime | string | 販売終了時刻 | ○ | ○ | ||||||
reviewCount | int | レビュー件数 | ○ | ○ | ||||||
reviewAverage | double | レビュー平均 | ○ | ○ | ||||||
pointRate | int | 商品別ポイント倍付け | ○ | ○ | ||||||
pointRateStartTime | string | 商品別ポイント倍付け開始日時 | ○ | ○ | ||||||
pointRateEndTime | string | 商品別ポイント倍付け終了日時 | ○ | ○ | ||||||
giftFlag | int | ギフト包装フラグ | ○ | ○ | ||||||
shopName | string | 店舗名 | ○ | ○ | ||||||
shopCode | string | 店舗コード | ○ | ○ | ||||||
shopUrl | string | 店舗URL | ○ | ○ | ||||||
shopAffiliateUrl | string | 店舗アフィリエイトURL | ○ | ○ | ||||||
genreId | string | ジャンルID | ○ | ○ | ||||||
tagIds | int[] | 複数のタグIDの配列 | ○ | ○ |