プラットフォームの稼働状況
- 24時間の稼働状況
- 99%
過去30日間
利用可能な機能
JD.comの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | 検索語でJD.comの商品を検索し、最大5件の結果を取得します。各結果には、表示どおりの価格・販売数・レビュー数、高評価率、ショップ、プロモーションタグが含まれます。返されたitem_idは、詳細、レビュー、価格の各アクションに渡せます。並び順と対象範囲はその1回のレスポンス内のものであり、カタログ全体を示すものではありません。 | 1,000リクエストあたり$2.47 | 正常 |
商品詳細product_detail | 1つのitem_idに対応するJD.comの商品レコード全体を取得します。ブランド、型番、価格と元の価格、在庫状況、バリエーション、バーコード、保証、JD Logisticsの対応状況が含まれます。price_maskedがtrueの場合、表示価格は正確ではありません。在庫がnullの場合は、ゼロではなく非表示であることを意味します。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | JD.comの商品の購入者レビューを最大10件取得します。評価、追加レビュー、購入したバリエーション、「参考になった」の投票数、写真、レビュアーのPLUS会員ステータスと購入回数を取得できます。ニックネームはJDでの表示どおりで、一部が伏せられている場合があります。取得したレビューは完全な履歴ではなく、再公開の許可も得ていません。 | 1,000リクエストあたり$1.39 | 正常 |
ショップshop | JD.comの1店舗から最大24件の商品を閲覧します。各商品には商品ID、タイトル、価格、通貨、在庫状況が含まれます。ショップの数値のshop_idまたはmall.jd.comのリンクを渡してください。結果はその店舗の全在庫を示すものではありません。 | 1,000リクエストあたり$28.81 | 良好・稼働状況100% |
商品価格product_price | item_idを指定して、JD.comの商品1件の現在の表示価格と在庫状況を確認します。購入できない商品の場合は、表示されている理由が返ります。これはある時点での値であり、購入者ごとの決済価格、会員割引、確定金額ではありません。 | 1,000リクエストあたり$1.39 | 正常 |
全SKUと価格skus | item_idにいずれか1つのSKUを指定すると、JD.com商品のすべてのSKUを一覧にします。色、サイズ、容量ごとに1件で、価格、在庫状況、購入制限数が含まれます。先頭の1件は指定したSKUです。priceはログインしていない購入者に表示される、チェックアウト時のクーポン適用前の価格です。 | 1,000リクエストあたり$1.391件につき1回の呼び出しとして計上 | 良好・稼働状況100% |
説明画像description_images | JD.comの商品の説明セクションにあるすべての画像を、上から順に取得します。フルサイズの各リンクにはpositionで番号が付き、image_countに合計数が入ります。item_idには、その商品の任意のSKUまたは商品リンクを渡してください。ギャラリー画像はproduct_detailに含まれます。説明画像がない商品では空の結果が返り、課金されません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
JD.comの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 検索語でJD.comの商品を検索し、最大5件の結果を取得します。各結果には、表示どおりの価格・販売数・レビュー数、高評価率、ショップ、プロモーションタグが含まれます。返された | keyword | — | Sync配信 | カタログ値：defaultLimit=5、maxLimit=5。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$2.47 | item_id · url · title · short_title · price · currency · sold_count · review_count · good_rate · shop_id · shop_name · shop_url · is_jd_self · promotion · sell_point · category_ids · image_url · platform |
product_detail商品詳細 1つの | item_id | — | Sync配信 | — | 1,000リクエストあたり$1.39 | item_id · url · title · price · price_display · price_masked · currency · available · unavailable_reason · shop_id · shop_name · shop_url · category_id · category · stock · stock_state · color · size · weight · image_url · image_urls · is_jd_self · brand · model · original_price · upc · warranty · product_area · is_jd_express · variant_count · variants · platform |
reviewsレビュー JD.comの商品の購入者レビューを最大10件取得します。評価、追加レビュー、購入したバリエーション、「参考になった」の投票数、写真、レビュアーのPLUS会員ステータスと購入回数を取得できます。ニックネームはJDでの表示どおりで、一部が伏せられている場合があります。取得したレビューは完全な履歴ではなく、再公開の許可も得ていません。 | item_id | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=10。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · item_id · text · review_append · rating · rating_scale · posted_at · color · size · useful_count · images · author_name · author_avatar_url · author_is_plus · buy_count · platform |
shopショップ JD.comの1店舗から最大24件の商品を閲覧します。各商品には商品ID、タイトル、価格、通貨、在庫状況が含まれます。ショップの数値の | shop_id | — | Sync配信 | カタログ値：defaultLimit=24、maxLimit=24。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$28.81 | item_id · url · title · price · currency · shop_id · shop_name · shop_url · image_url · available · platform |
product_price商品価格
| item_id | — | Sync配信 | — | 1,000リクエストあたり$1.39 | item_id · url · price · currency · available · unavailable_reason · platform |
skus全SKUと価格
| item_id | — | Sync配信 | カタログ値：defaultLimit=100、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.391件につき1回の呼び出しとして計上 | item_id · url · product_id · is_requested · title · properties · color · size · price · currency · on_sale · in_stock · stock_state · stock · purchase_limit · delivery_promise · is_presale · is_government_subsidy · is_billion_subsidy · is_flash_sale · promo_tags · upc · brand · image_url · shop_id · shop_name · is_jd_self · variant_count · platform |
description_images説明画像 JD.comの商品の説明セクションにあるすべての画像を、上から順に取得します。フルサイズの各リンクには | item_id | — | Sync配信 | — | 1,000リクエストあたり$1.39 | item_id · position · image_url · image_count · platform |
JD.comのsearchのパラメータはそれぞれどういう意味ですか？
検索語でJD.comの商品を検索し、最大5件の結果を取得します。各結果には、表示どおりの価格・販売数・レビュー数、高評価率、ショップ、プロモーションタグが含まれます。返されたitem_idは、詳細、レビュー、価格の各アクションに渡せます。並び順と対象範囲はその1回のレスポンス内のものであり、カタログ全体を示すものではありません。
keyword必須- JD.comの
searchで使用する検索クエリを指定します。商品IDやショップの指定ではなく、検索フレーズを渡す必要があります。また、一致した結果がカタログ全体を網羅しているわけではありません。JD.com JOSおよびJD Union：商品とSKUのオブジェクト — JD.comの認可済みオープンプラットフォームおよびアフィリエイトの資料では、名称、メイン画像、カテゴリ、表示価格、物流、JD.com直販かどうか、注文量の指標といった商品およびSKUのオブジェクトについて説明しています。これらの用語は、すべてのウェブページやフィールドが利用可能であること、呼び出し元にアクセス権があること、EveryInfraが公式インターフェースを実装していることを証明するものではありません。 · 確認日
JD.comのproduct_detailのパラメータはそれぞれどういう意味ですか？
1つのitem_idに対応するJD.comの商品レコード全体を取得します。ブランド、型番、価格と元の価格、在庫状況、バリエーション、バーコード、保証、JD Logisticsの対応状況が含まれます。price_maskedがtrueの場合、表示価格は正確ではありません。在庫がnullの場合は、ゼロではなく非表示であることを意味します。
item_id必須product_detail、reviews、product_priceで対象とするJD.comの商品を1件指定します。searchが返す数字の文字列、またはクエリやフラグメントを含まない正規の旧形式URLhttps://item.jd.com/<digits>.htmlを渡してください。任意のURL、不透明なURL、別ホストのURLは、同等の商品識別子としては受け付けません。JD.com：表示価格ラベルと条件付きの購入価格 — JD.comでは、リアルタイムに表示されるラベルと、最終的な商品価格や会員・新規ユーザー・地域・対象者限定の特典を区別しており、比較情報の一部は遅延したり不完全だったりする場合があるとしています。返された価格はリクエスト時点で表示されていたスナップショットとして扱い、個人の取引価格、決済金額、または絶対的な正確性の保証とはみなさないでください。 · 確認日
JD.comのreviewsのパラメータはそれぞれどういう意味ですか？
JD.comの商品の購入者レビューを最大10件取得します。評価、追加レビュー、購入したバリエーション、「参考になった」の投票数、写真、レビュアーのPLUS会員ステータスと購入回数を取得できます。ニックネームはJDでの表示どおりで、一部が伏せられている場合があります。取得したレビューは完全な履歴ではなく、再公開の許可も得ていません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況item_id必須product_detail、reviews、product_priceで対象とするJD.comの商品を1件指定します。searchが返す数字の文字列、またはクエリやフラグメントを含まない正規の旧形式URLhttps://item.jd.com/<digits>.htmlを渡してください。任意のURL、不透明なURL、別ホストのURLは、同等の商品識別子としては受け付けません。JD.com：レビューと写真投稿のルール — JD.comでは、レビュー、追加レビュー、画像、返信、審査、折りたたまれたコンテンツ、マスクされたニックネームを区別しています。公開されるかどうかはレビューやプライバシーのルールに左右されるため、返されたデータを完全なレビュー履歴として、あるいはレビュー投稿者のコンテンツを再配布する許可として説明しないでください。 · 確認日JD.comユーザーサービス規約（2026年1月20日発効）：公開レビューとアクセスの範囲 — JD.comユーザーサービス規約では、レビュー情報は公開されるものであり、JD.comが規約に基づいて利用できると定めています。また、個人情報は原則として許可なく第三者に開示されないとし、個人情報の窃取や正当な権利の侵害を禁止しています。これはアクセスと許可の範囲を裏付けるものにすぎず、EveryInfraや呼び出し元に対し、テキスト、画像、ユーザー情報を再配布、学習に利用、または商用で再利用する権利を付与するものではありません。 · 確認日
JD.comのshopのパラメータはそれぞれどういう意味ですか？
JD.comの1店舗から最大24件の商品を閲覧します。各商品には商品ID、タイトル、価格、通貨、在庫状況が含まれます。ショップの数値のshop_idまたはmall.jd.comのリンクを渡してください。結果はその店舗の全在庫を示すものではありません。
shop_id必須shopアクションで使用するショップを指定します。数字の文字列、またはクエリやフラグメントを含まない正規の旧形式URLhttps://mall.jd.com/index-<digits>.htmlを渡してください。別ホストのURLは拒否されます。また、このパラメータには商品のitem_idは指定できません。JD.com JSSDK：SKUとショップのターゲットを区別 — JD.comのリダイレクトに関するドキュメントでは、商品詳細のターゲットに`skuId`、ショップ詳細のターゲットに`shopId`を使用しています。これは商品とショップの識別子を区別して扱う根拠にはなりますが、ウェブページの収集権限、URL解析への対応、ショップの全商品カタログ、EveryInfraのリクエスト動作を裏付けるものではありません。 · 確認日
JD.comのproduct_priceのパラメータはそれぞれどういう意味ですか？
item_idを指定して、JD.comの商品1件の現在の表示価格と在庫状況を確認します。購入できない商品の場合は、表示されている理由が返ります。これはある時点での値であり、購入者ごとの決済価格、会員割引、確定金額ではありません。
item_id必須product_detail、reviews、product_priceで対象とするJD.comの商品を1件指定します。searchが返す数字の文字列、またはクエリやフラグメントを含まない正規の旧形式URLhttps://item.jd.com/<digits>.htmlを渡してください。任意のURL、不透明なURL、別ホストのURLは、同等の商品識別子としては受け付けません。JD.com：表示価格ラベルと条件付きの購入価格 — JD.comでは、リアルタイムに表示されるラベルと、最終的な商品価格や会員・新規ユーザー・地域・対象者限定の特典を区別しており、比較情報の一部は遅延したり不完全だったりする場合があるとしています。返された価格はリクエスト時点で表示されていたスナップショットとして扱い、個人の取引価格、決済金額、または絶対的な正確性の保証とはみなさないでください。 · 確認日
JD.comのskusのパラメータはそれぞれどういう意味ですか？
item_idにいずれか1つのSKUを指定すると、JD.com商品のすべてのSKUを一覧にします。色、サイズ、容量ごとに1件で、価格、在庫状況、購入制限数が含まれます。先頭の1件は指定したSKUです。priceはログインしていない購入者に表示される、チェックアウト時のクーポン適用前の価格です。
item_id必須skusで取得するJD.comの商品1件を、いずれか1つのSKUで指定します。数字の文字列、JDの商品リンク（https://item.jd.com/<digits>.html、https://item.m.jd.com/product/<digits>.html、またはWeChat内で開いたwqitem.jd.comのページ）、またはそのようなリンクをちょうど1つ含む共有テキストを渡してください。リンク内のトラッキングパラメータは影響しません。3.cnやu.jd.comなどの短縮リンクは受け付けられません。先にブラウザで開き、商品ページのリンクをコピーしてください。JD.com：表示価格ラベルと条件付きの購入価格 — JD.comでは、リアルタイムに表示されるラベルと、最終的な商品価格や会員・新規ユーザー・地域・対象者限定の特典を区別しており、比較情報の一部は遅延したり不完全だったりする場合があるとしています。返された価格はリクエスト時点で表示されていたスナップショットとして扱い、個人の取引価格、決済金額、または絶対的な正確性の保証とはみなさないでください。 · 確認日
JD.comのdescription_imagesのパラメータはそれぞれどういう意味ですか？
JD.comの商品の説明セクションにあるすべての画像を、上から順に取得します。フルサイズの各リンクにはpositionで番号が付き、image_countに合計数が入ります。item_idには、その商品の任意のSKUまたは商品リンクを渡してください。ギャラリー画像はproduct_detailに含まれます。説明画像がない商品では空の結果が返り、課金されません。
item_id必須- 説明画像を取得したいJD.comの商品を、いずれか1つのSKUで指定します。数字の文字列、JDの商品リンク（
https://item.jd.com/<digits>.html、https://item.m.jd.com/product/<digits>.html、またはWeChat内で開いたwqitem.jd.comのページ）、またはそのようなリンクをちょうど1つ含む共有テキストを渡してください。リンク内のトラッキングパラメータは影響しません。3.cnやu.jd.comなどの短縮リンクは受け付けられません。先にブラウザで開き、商品ページのリンクをコピーしてください。
JD.com APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"jd","action":"search","params":{"keyword":"<keyword>"}}'
JD.comのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読む価格スクレイピングの事業化：販売事業者が契約を更新する価格監視プロダクトの作り方
販売事業者が価格モニタリングにお金を払う理由と、サブスクリプションを解約する理由。商品マッチング、例外リスト、価格改定の承認ワークフローを通じて、価格データの提供方法、課金単位、パイロットの受け入れ基準を検討します。
記事を読むAPIの失敗、クレジットの返還、照合：リクエストの正味課金額を監査する方法
タスク、呼び出し試行、配信状態、ウォレットイベントを分けて扱い、課金前の拒否、空の結果、クレジットの部分返金を二重計上せずに処理する方法を、整数を用いたオフライン例で解説します。
記事を読むJD.com APIに関する質問
JD.com APIでは何を取得できますか？
platformをjdに設定します。現在のカタログには検索、商品詳細、レビュー、ショップ、商品価格、moreが掲載されています。これらのアクション名はそれぞれ異なるJD.comのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
JD.comに公式APIはありますか？
JDのオープンプラットフォーム（JOS）は、登録済みの開発者とパートナーに、開発者センターで作成・公開したアプリを通じて、物流、マーケティング、クラウド、ログイン連携の機能を提供します。アフィリエイト向けの商品プロモーションは、別プログラムのJD Unionで行います。
公式情報源： JD Open Platform（JOS）開発者センター · JD Union · 確認日
JD.comの開発者アカウントやAPIキーは必要ですか？
いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。JD.comの開発者アプリの登録、JD.com APIへのアクセス申請、JD.comアカウントでのログインは必要ありません。また、アクションが返すのはJD.comの公開データのみです。
JD.com APIの料金は1,000リクエストあたりいくらですか？
アクションに応じて1,000リクエストあたり$1.39から、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。
JD.comのsearchリクエストを開始するには、どの入力を使用しますか？
JD.comのsearchで使用する検索クエリを指定します。商品IDやショップの指定ではなく、検索フレーズを渡す必要があります。また、一致した結果がカタログ全体を網羅しているわけではありません。params内のkeywordとして送信してください。
JD.comのsearchはどのフィールドを返しますか？
宣言されたスキーマにはitem_id、title、short_title、priceが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
JD.comのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。skusrunsは同期でのみ動作します。1回の呼び出し内で返すすべてのデータ（バッチのすべての対象、または商品のすべてのSKU）を読み取るため、"mode": "async"を指定したリクエストには課金前に422が返されます。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。