Taobao商品詳細API

Q: 複数のバリエーションがある商品の価格はどう読めばよいですか？

skusにはすべてのバリエーションが含まれ、それぞれが独自の価格、元の価格、クーポン適用価格、在庫を持つ場合があります。一方、priceは商品単位の値です。価格を比較・監視する場合は、バリエーションごとに記録してください。spec_valuesには、販売されていない組み合わせも含めて、すべてのバリエーションの値が入ります。

Q: 価格は人民元ですか？米ドルの金額はありますか？

price、original_price、coupon_priceは通貨記号のない数値です。通貨は推測せず、currencyで確認してください。price_usdは返却データ内で換算された米ドル建ての参考価格です。大まかな比較に使い、実際の支払額としては扱わないでください。商品詳細の人民元価格は多くの場合米ドルから換算されているため、Taobaoのページ上の価格より約1〜4%高くなったり低くなったりすることがあります。正しいのはページ上の価格です。

POST

APIの稼働状況

24時間の稼働状況: 100%
24時間の平均応答時間: 14.04 s

良好／正常
利用可能
制限あり
ほぼ停止

良好

過去24時間

過去30日間

TaobaoまたはTmallの商品1件の詳細情報をすべて取得します。ブランド、価格、在庫、全SKU、属性、画像、送料、ショップ評価が含まれます。数値の商品ID、商品リンク、または商品リンクを1つだけ含む共有テキストを指定してください。共有コードのみの入力や期限切れのリンクは受け付けません。

Taobao商品詳細は、TaobaoまたはTmallの商品1件について公開情報をすべて取得します。取得できるのは、タイトル、ブランド、価格と元の価格、クーポン適用価格、在庫数と販売数、それぞれ独自の価格と在庫を持つ全SKU、商品属性、メイン画像と商品説明の画像、さらにショップ情報と送料です。競合の商品ページの詳細な分析、価格やプロモーションの追跡、商品の比較、商品カタログの拡充に使えます。

urlには、数値の商品ID、商品リンク、または商品リンクを1つだけ含む共有テキストを指定します。Taobaoの共有コード単体や期限切れのリンクは受け付けません。価格を読む際は、coupon_priceはクーポンが適用される場合にのみ含まれること、またskusの各要素がそれぞれ独自の価格を持つ場合があることに注意してください。is_tmallでTmallストアと通常のTaobaoショップを区別できます。両者は出店要件や保証内容が異なります。

料金は1,000リクエストあたり$4.5（1回あたり$0.0045）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのTaobao 商品詳細エンドポイント（taobao/product_detail）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにtaobao、actionにproduct_detailを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - url: product_detail、reviews、questionsでは、数値の商品ID、Taobao/Tmallの商品URL、または商品URLを1つだけ含む共有メッセージを指定します。e.tb.cnおよびm.tb.cnのリンクは、商品ページへ安全に解決できる場合にのみ使用できます。TaoPasswordのみのトークン、期限切れのリンク、商品ページ以外のページは拒否されます。
- 1つのオブジェクトを返します。主なフィールド: id、url、title、brand（ブランドです）、price（通貨記号を含まない数値で表した価格です）、original_price（元の価格（取り消し線付きの価格）です）、currency、stock（在庫数です）、sold_count（販売数です）、category_id（カテゴリIDです）、location、is_tmall（ストアが通常のTaobaoショップではなくTmallストアかどうかを示します）。フィールドは全部で77個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=taobaoを参照してください。.
- リクエストボディの例：
{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}
- 料金：1,000リクエストあたり$4.5。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`taobao`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`product_detail`	機能の識別子です。値は固定です。
`url`	body.params	`string`	はい	-	product_detail、reviews、questionsでは、数値の商品ID、Taobao/Tmallの商品URL、または商品URLを1つだけ含む共有メッセージを指定します。e.tb.cnおよびm.tb.cnのリンクは、商品ページへ安全に解決できる場合にのみ使用できます。TaoPasswordのみのトークン、期限切れのリンク、商品ページ以外のページは拒否されます。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

October 24, 2026 at 18:28（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "taobao",
  "action": "product_detail",
  "results": {
    "id": "•••",
    "url": "https://item.taobao.com/item.htm?id=744983869996",
    "title": "绿联转换插头英标韩国马来西亚澳洲新加坡新西兰Switch转换器充电",
    "price": 29.97,
    "currency": "CNY",
    "stock": 1397,
    "category_id": "50003472",
    "location": "廣東東莞",
    "is_tmall": true,
    "shop_name": "绿联数码旗舰店",
    "shop_id": "67095450",
    "skus": [
      {
        "id": "•••",
        "name": "[for Outings] English to Chinese Converter|Matte Black⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",
        "price": 30.17,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i3/713464357/O1CN01QOFAISCEu2L1chua_!!713464357.jpg"
      },
      {
        "id": "•••",
        "name": "[for Outings] English to Chinese Converter|Lightweight White⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",
        "price": 29.97,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01P9gIa5t80pC1chua_!!713464357.jpg"
      },
      {
        "id": "•••",
        "name": "[for Mainland China] Chinese to English Converter|Matte Black⭐Applicable to Hong Kong Version of Ps5/Switch2/Electrical Appliances in Hong Kong and Macau, China",
        "price": 30.17,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01WLbh5e1i3YjKWsf7g_!!713464357.jpg"
      }
    ],
    "sku_count": 8,
    "main_image_url": "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",
    "description_images": [
      "https://img.alicdn.com/imgextra/i1/713464357/O1CN01tRpmSz1MdQI1WPZ8_!!713464357.jpg",
      "https://img.alicdn.com/imgextra/i1/713464357/O1CN019muBmB1i3YpL3L8sM_!!713464357.jpg",
      "https://img.alicdn.com/imgextra/i3/713464357/O1CN011J4LMz1i3Ynq3SQ1z_!!713464357.jpg"
    ],
    "price_usd": 5.27,
    "root_category_id": "50020579",
    "category_path": "首页 > 电子/电工 > 接线板/插头 > 转换插头",
    "min_order_quantity": 1,
    "images": [
      "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",
      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01f4WmsN1i3YoKlcotr_!!713464357.jpg",
      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01KQ3NjW1i3YljOLkIv_!!713464357.jpg"
    ],
    "category_name": "转换插头",
    "description": "港版Switch转换插头 - 英标转中转换器，适用马来西亚插头与多国转换插头，具备65W快充功能。适合港版Switch 1与2使用，提供全球适用的转换解决方案。\n\n多国适用与高效快充功能 - 绿联多国转换插头支援英标、美标、德标与澳标等多种插头类型，适用全球多数国家与地区。内建65W快充技术，确保高功率需求的装置如Switch主机与笔电能快速充电，同时具备安全保护机制，避免过载与短路。\n\n多样款式与便利设计选择 - 转换插头提供多种款式选择，包含单独英转中、中转英与多合一组合。特别针对港版Switch 2使用者设计，提供适用进口电器的转换方案。轻巧便携设…",
    "keywords": [
      "港版Switch转换插头",
      "英标转中转换器",
      "适用马来西亚插头"
    ],
    "shop_score_description": 4.8,
    "shop_score_service": 4.8,
    "shop_score_delivery": 4.9,
    "free_shipping": false,
    "has_price_range": true,
    "payment_methods": [
      "蚂蚁花呗",
      "信用卡支付",
      "集分宝"
    ],
    "seller_id": "•••",
    "seller_credit_level": 20,
    "seller_type": "B",
    "seller_type_label": "Business seller",
    "selling_points": [
      "港版Switch2转换插头:专为港版Switch2设计转换插头，兼容多国电压，出国携带无烦恼。",
      "绿联品牌认证转换器:知名电子品牌绿联出品，通过多国安全认证，使用更安心。",
      "多国插头规格适用:适用马来西亚、新加坡、英国等多国插座标准，国际旅行首选。"
    ],
    "shop_logo_url": "https://img.alicdn.com/imgextra//d2/82/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg",
    "shop_url": "https://shop.m.taobao.com/shop/shop_index.htm?user_id=713464357",
    "shop_item_count": 1330,
    "shop_new_item_count": 28,
    "shop_opened_at": "2011-05-30 14:37:22",
    "seven_day_return": false,
    "reviews": [
      {
        "text": "还不错，通电了装换头会有提示灯 没送收纳袋。 体积挺小巧的。 手感挺细腻的。",
        "rating": 5,
        "posted_at": "2026.10.17 18:07",
        "sku": "颜色:【内地用】中转英转换器|轻骑白⭐港版PS5/Switch2/中国香港澳门地区电器适用",
        "author_avatar_url": "https://gw.alicdn.com/•••"
      }
    ],
    "platform": "taobao"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`id`	プラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。
`url`	プラットフォーム上のレコードへのリンクです。
`title`	タイトルです。プラットフォームにタイトルがない場合（テキストのみの投稿など）はnullになります。
`brand`	ブランドです。
`price`	通貨記号を含まない数値で表した価格です。通貨はcurrencyを参照してください。product_detailでは、価格（各skus行のpriceを含む）は主に米ドルから換算されており、Taobaoのページ上の価格より約1～4%高い、または低い場合があります。正となるのはページ上の価格です。
`original_price`	元の価格（取り消し線付きの価格）です。shopではこれが唯一の価格で、出品に表示される取り消し線付きの金額です。販売価格ではなく、販売価格を大きく上回る場合があります。販売価格はproduct_detailで取得してください。
`currency`	価格の通貨コードです（例：CNY、USD）。priceフィールドが存在してもcurrencyがnullの場合は、通貨を推測しないでください。
`stock`	在庫数です。
`sold_count`	販売数です。
`category_id`	カテゴリIDです。
`location`	位置情報の説明で、そのまま渡されます。形式はプラットフォームによって異なります。
`is_tmall`	ストアが通常のTaobaoショップではなくTmallストアかどうかを示します。両者では出店要件と購入者保証が異なります。
`shop_name`	ショップ名です。
`shop_id`	ショップIDです。
`shipping_fee`	送料です。
`ems_fee`	EMSの送料です。
`express_fee`	宅配便の送料です。
`skus`	出品中のすべてのバリエーション（SKU）です。各エントリにはid、name、price、original_price、coupon_price、stock、props_ids、image_urlが含まれる場合があります。priceは主に米ドルから換算された値です（priceを参照）。
`sku_count`	SKUの数です。
`spec_values`	販売されていない組み合わせも含む、バリエーション値の完全な一覧です。idは値の識別子、textはそのラベルです。
`props_images`	バリエーション値の画像です。idはspec_valuesおよびprops_idsと対応し、image_urlはそのバリエーションの表示画像です。
`attributes`	ブランド、型番、原産地などの商品属性を{name, value}形式の行で示します。
`main_image_url`	メイン画像（1枚目）です。
`description_images`	商品説明エリアの縦長画像です。ページ上の順序で並んでいます。
`description_html`	商品説明エリアの生のHTMLです。主に画像タグで構成されています。
`video_url`	メイン画像の動画への直接リンクです。動画を取得できることはまれなため、このフィールドは通常空です。値が空でも、商品に動画がないとは限りません。
`coupon_price`	クーポン適用後の価格です。クーポンが適用される場合はpriceより低くなり、適用されない場合は含まれません。
`price_usd`	返却データ内で米ドルに換算された参考価格です。
`total_price`	返却された合計価格です。含まれないことがよくあります。
`suggestive_price`	希望小売価格です。含まれないことがよくあります。
`has_discount`	割引が適用されるかどうかを示します。
`is_promotion`	商品がプロモーション中かどうかを示します。
`promo_type`	プロモーションの種類です。
`is_virtual`	商品がバーチャル商品（物理的な商品ではないもの）かどうかを示します。
`brand_id`	ブランドIDです。
`root_category_id`	ルートカテゴリIDです。
`category_path`	カテゴリパス（パンくずリスト）です。
`weight`	返却された商品重量です。0であるか、フィールド自体が含まれないことがよくあります。
`size`	商品の寸法です。含まれないことがよくあります。
`favorite_count`	商品がお気に入りに追加された回数です。
`fans_count`	返却されたフォロワー数です。含まれないことがよくあります。
`min_order_quantity`	最小注文数量です。
`shipping_to`	配送エリアに関する注記です。含まれないことがよくあります。
`listed_at`	出品日時（ISO 8601）です。データにない場合、このフィールドは含まれません。
`modified_at`	最終更新日時（ISO 8601）です。データにない場合、このフィールドは含まれません。
`delist_at`	出品停止日時（ISO 8601）です。データにない場合、このフィールドは含まれません。
`images`	画像リンクです。product_detailでは商品写真、reviewsでは購入者が投稿した写真です（レビューに写真がない場合は含まれません）。
`category_name`	最下層カテゴリの名前です（product_detail）。
`description`	概要または説明文で、通常はtextより短くなります。
`keywords`	商品ページのキーワードです（product_detail）。
`titleOriginal`	プラットフォーム上の意味のまま
`has_cn_title`	プラットフォーム上の意味のまま
`shop_score_description`	ショップの「商品説明との一致」評価です（5点満点）。
`shop_score_service`	ショップのサービス評価です（5点満点）。
`shop_score_delivery`	ショップの配送評価です（5点満点）。
`free_shipping`	送料無料かどうかを示します。
`promotion_price`	プロモーション価格です（product_detail。含まれないことが多い）。
`discount_price`	割引価格です（product_detail。含まれないことが多い）。
`discount_type`	表記どおりの割引またはキャンペーンの種類です（例：タイムセール）。
`price_note`	表記どおりの価格に関する注記です（product_detail）。
`has_price_range`	バリエーションごとに価格が異なるため、価格が範囲表示になっているかどうかを示します（product_detail）。
`payment_methods`	利用可能な支払い方法です（product_detail）。
`seller_id`	販売者IDです（shopでは含まれない場合があります）。
`seller_credit_level`	販売者の信用レベルです（数値。高いほど良い）。
`seller_type`	販売者タイプのコードです（product_detail）。
`seller_type_label`	販売者タイプの名前です（product_detail）。例：Tmall、企業ショップ。
`selling_points`	セールスポイントのタグです。
`shop_logo_url`	ショップロゴのリンクです（product_detail、shop。shopでは含まれない場合があります）。
`shop_url`	ショップのリンクです（product_detail、shop）。
`shop_item_count`	ショップで販売中の商品数です（product_detail、search、shop）。
`shop_new_item_count`	ショップの新着商品数です（product_detail）。
`shop_opened_at`	ショップの開店時期を、表記どおりに示します（product_detail）。
`review_tags`	レビュータグです。各タグにはtag（ラベル）とcount（言及された回数。含まれない場合があります）があります。
`review_count`	レビュー数です（商品・ビジネス系の機能で使用）。nullは非公開を示し、0ではありません。
`positive_rate`	商品の高評価率をパーセントで示します（product_detail）。含まれないことが多いです。
`seven_day_return`	7日間理由を問わない返品に対応しているかどうかを示します（product_detail）。
`reviews`	プラットフォーム上の意味のまま
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。

FAQ

`url`には何を指定できますか？

数値の商品ID、TaobaoまたはTmallの商品リンク、または商品リンクを1つだけ含む共有テキストを指定できます。e.tb.cnやm.tb.cnの短縮リンクは、安全に商品ページへリダイレクトされる場合にのみ受け付けます。共有コード単体、期限切れのリンク、ショップページや検索ページは受け付けません。

複数のバリエーションがある商品の価格はどう読めばよいですか？

skusにはすべてのバリエーションが含まれ、それぞれが独自の価格、元の価格、クーポン適用価格、在庫を持つ場合があります。一方、priceは商品単位の値です。価格を比較・監視する場合は、バリエーションごとに記録してください。spec_valuesには、販売されていない組み合わせも含めて、すべてのバリエーションの値が入ります。

価格は人民元ですか？米ドルの金額はありますか？

price、original_price、coupon_priceは通貨記号のない数値です。通貨は推測せず、currencyで確認してください。price_usdは返却データ内で換算された米ドル建ての参考価格です。大まかな比較に使い、実際の支払額としては扱わないでください。商品詳細の人民元価格は多くの場合米ドルから換算されているため、Taobaoのページ上の価格より約1〜4%高くなったり低くなったりすることがあります。正しいのはページ上の価格です。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

Taobao：商品IDとSKUの用語 ↗
Taobaoでは、商品IDを商品リンク内のid=に続く数字と定義しており、SKUは色やサイズなど特定の属性の組み合わせを表します。商品IDとSKUを相互に置き換えて使わないでください。
確認日：2026-09-04