プラットフォームの稼働状況
- 24時間の稼働状況
- 100%
過去30日間
利用可能な機能
Taobaoの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードでTaobaoとTmallの出品を検索します。価格と発送元に加え、取得できる場合は販売数、評価、ショップ、クーポンや割引の情報を取得できます。最も安定しているのは通常のキーワード検索で、pageによるページ送り（1ページ20件）にも対応していますが、ほとんどの行で販売数とショップ名が欠けています。価格帯の指定、popular、price_desc、tmall_onlyはページ送りに対応しておらず、後の3つは1リクエストあたり10件までに制限されます。在庫、真贋、配送は確認されません。 | 1,000リクエストあたり$13.5 | 良好・稼働状況97% |
商品詳細product_detail | TaobaoまたはTmallの商品1件の詳細情報をすべて取得します。ブランド、価格、在庫、全SKU、属性、画像、送料、ショップ評価が含まれます。数値の商品ID、商品リンク、または商品リンクを1つだけ含む共有テキストを指定してください。共有コードのみの入力や期限切れのリンクは受け付けません。 | 1,000リクエストあたり$4.5 | 良好・稼働状況100% |
ショップshop | Taobaoの出品者が現在販売中の商品を最大20件一覧で取得します。取り消し線付きの価格、カテゴリ、送料込みフラグ、メイン画像、ショップ評価を取得できます。各行に販売数やレビュー数は含まれません。shopには店舗名ではなく、出品者の数値ユーザーIDまたはショップリンクを指定します。 | 1,000リクエストあたり$1.39 | 良好・稼働状況100% |
レビューreviews | Taobao商品の購入者レビューを取得します。各レビューには評価、購入したバリエーション、「参考になった」の投票数、写真、追加レビュー、出品者の返信が含まれます。商品ID、商品リンク、または商品リンクを1つ含む共有テキストを指定してください。1回の取得ですべてのレビューが含まれるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
質問questions | Taobaoの商品ページにある購入者の質問と回答を、各質問の回答数と投稿日とともに取得します。answer_countは返される回答の数と異なる場合があり、回答が出品者からのものとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Taobaoの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードでTaobaoとTmallの出品を検索します。価格と発送元に加え、取得できる場合は販売数、評価、ショップ、クーポンや割引の情報を取得できます。最も安定しているのは通常のキーワード検索で、 | keyword | max_price, min_price, page, sort, tmall_only | Sync配信 | カタログ値：defaultLimit=20、maxLimit=20。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$13.5 | id · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · shop_id · sold_text · original_price · coupon_price · discount_type · is_tmall · brand · category_id · seller_credit_level · seller_positive_rate · shop_score_description · shop_score_service · shop_score_delivery · subtitle · search_rank · free_shipping · selling_points · review_tags · images · discount_rate · spu_id · category_path · review_count · latest_review · seller_type · shop_opened_at · shop_age_years · shop_item_count · shop_score_vs_industry · platform |
product_detail商品詳細 TaobaoまたはTmallの商品1件の詳細情報をすべて取得します。ブランド、価格、在庫、全SKU、属性、画像、送料、ショップ評価が含まれます。数値の商品ID、商品リンク、または商品リンクを1つだけ含む共有テキストを指定してください。共有コードのみの入力や期限切れのリンクは受け付けません。 | url | — | Sync配信 | — | 1,000リクエストあたり$4.5 | id · url · title · brand · price · original_price · currency · stock · sold_count · category_id · location · is_tmall · shop_name · shop_id · shipping_fee · ems_fee · express_fee · skus · sku_count · spec_values · props_images · attributes · main_image_url · description_images · description_html · video_url · coupon_price · price_usd · total_price · suggestive_price · has_discount · is_promotion · promo_type · is_virtual · brand_id · root_category_id · category_path · weight · size · favorite_count · fans_count · min_order_quantity · shipping_to · listed_at · modified_at · delist_at · images · category_name · description · keywords · titleOriginal · has_cn_title · shop_score_description · shop_score_service · shop_score_delivery · free_shipping · promotion_price · discount_price · discount_type · price_note · has_price_range · payment_methods · seller_id · seller_credit_level · seller_type · seller_type_label · selling_points · shop_logo_url · shop_url · shop_item_count · shop_new_item_count · shop_opened_at · review_tags · review_count · positive_rate · seven_day_return · reviews · platform |
shopショップ Taobaoの出品者が現在販売中の商品を最大20件一覧で取得します。取り消し線付きの価格、カテゴリ、送料込みフラグ、メイン画像、ショップ評価を取得できます。各行に販売数やレビュー数は含まれません。 | shop | seller, sort, user_id | Sync配信 | カタログ値：defaultLimit=20、maxLimit=20。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、20が上限として適用されます。 | 1,000リクエストあたり$1.39 | id · url · title · original_price · currency · category_id · free_shipping · shop_name · shop_id · seller_id · image_url · shop_url · shop_logo_url · shop_score_description · shop_score_service · shop_score_delivery · shop_item_count · platform |
reviewsレビュー Taobao商品の購入者レビューを取得します。各レビューには評価、購入したバリエーション、「参考になった」の投票数、写真、追加レビュー、出品者の返信が含まれます。商品ID、商品リンク、または商品リンクを1つ含む共有テキストを指定してください。1回の取得ですべてのレビューが含まれるとは限りません。 | url | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · author_avatar_url · images · review_append · platform · seller_reply |
questions質問 Taobaoの商品ページにある購入者の質問と回答を、各質問の回答数と投稿日とともに取得します。 | url | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · text · answer_count · posted_at · answers · platform |
Taobaoのsearchのパラメータはそれぞれどういう意味ですか？
キーワードでTaobaoとTmallの出品を検索します。価格と発送元に加え、取得できる場合は販売数、評価、ショップ、クーポンや割引の情報を取得できます。最も安定しているのは通常のキーワード検索で、pageによるページ送り（1ページ20件）にも対応していますが、ほとんどの行で販売数とショップ名が欠けています。価格帯の指定、popular、price_desc、tmall_onlyはページ送りに対応しておらず、後の3つは1リクエストあたり10件までに制限されます。在庫、真贋、配送は確認されません。
keyword必須- searchアクションで使用するTaobaoまたはTmallの商品検索語を指定します。ストア名での完全一致検索は行いません。
max_price任意- searchアクションで、min_priceと組み合わせて商品の最高価格フィルターを設定します。SKUの在庫上限を制御するものではありません。小数は整数に切り上げられる場合があります。価格範囲を指定した検索ではページ送りできません。
min_price任意- searchアクションで商品の最低価格フィルターを設定します。レビュースコアのフィルターやAPI料金のパラメータではなく、shop、product_detail、reviews、questionsには適用されません。小数は整数に切り捨てられる場合があります。価格範囲を指定した検索ではページ送りできません。
page任意- 商品検索のページ番号です。1〜50を指定でき、1ページあたり20件です。1ページ目の場合は省略してください。各ページは1回の呼び出しとして課金されます。ページ送りできるのはキーワードのみの検索に限られます（min_price、max_price、tmall_onlyを指定せず、sortは省略またはrelevance）。キーワードのみの検索のほうが信頼性の高い検索方法ですが、ほとんどの行には販売数やショップ名が含まれません。2ページ目以降をこれらのフィルターと組み合わせると課金前に拒否されるため、ページ送りする場合はフィルターを外してください。limitはそのページで取得する件数を設定するだけなので、ページ送り中は20のままにしてください。ランキングはリアルタイムで更新されるため、隣接するページで一部の商品が重複することがあります。ページを結合する際はidで重複を除去してください。
sort任意- 商品検索では、relevance（デフォルト）、popular、price_descを使用します。デフォルトおよびrelevanceの検索では最大20件、popularとprice_descでは最大10件まで取得でき、popularとprice_descはページ送りできません。該当する上限を超えるリクエストは課金前に拒否されます。price_ascには対応していません。reviewsとquestionsではsortを指定できません。shopでは指定してもエラーになりませんが、現時点では効果はありません。指定可能な値:
popularprice_descrelevance tmall_only任意- true（ブール値）を指定すると、商品検索をTmallの商品のみに絞り込みます。その場合、リクエストは10件までに制限され、ページ送りはできません。JSONのブール値のみを指定してください。"false"などの文字列や、この上限を超えるリクエストは課金前に拒否されます。
Taobaoのproduct_detailのパラメータはそれぞれどういう意味ですか？
TaobaoまたはTmallの商品1件の詳細情報をすべて取得します。ブランド、価格、在庫、全SKU、属性、画像、送料、ショップ評価が含まれます。数値の商品ID、商品リンク、または商品リンクを1つだけ含む共有テキストを指定してください。共有コードのみの入力や期限切れのリンクは受け付けません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- product_detail、reviews、questionsでは、数値の商品ID、Taobao/Tmallの商品URL、または商品URLを1つだけ含む共有メッセージを指定します。e.tb.cnおよびm.tb.cnのリンクは、商品ページへ安全に解決できる場合にのみ使用できます。TaoPasswordのみのトークン、期限切れのリンク、商品ページ以外のページは拒否されます。Taobao：商品IDとSKUの用語 — Taobaoでは、商品IDを商品リンク内のid=に続く数字と定義しており、SKUは色やサイズなど特定の属性の組み合わせを表します。商品IDとSKUを相互に置き換えて使わないでください。 · 確認日
Taobaoのshopのパラメータはそれぞれどういう意味ですか？
Taobaoの出品者が現在販売中の商品を最大20件一覧で取得します。取り消し線付きの価格、カテゴリ、送料込みフラグ、メイン画像、ショップ評価を取得できます。各行に販売数やレビュー数は含まれません。shopには店舗名ではなく、出品者の数値ユーザーIDまたはショップリンクを指定します。
shop必須- shopアクションで、販売者の数値のuserId（sellerId）またはショップのリンク（shop<shopId>.taobao.com）を指定します。その販売者が販売中の商品を、1リクエストあたり最大20件返します。limitを大きくしても返されるのは20件で、1回の呼び出しあたりの料金は変わりません。ショップ名ではありません。
seller任意- shopアクションで、販売者の数値userIdを指定するための互換用フォールバックです。数値のユーザーIDのみ受け付け、販売者のニックネームは使用できません。shopおよびuser_idより優先度が低くなります。
sort任意- 商品検索では、relevance（デフォルト）、popular、price_descを使用します。デフォルトおよびrelevanceの検索では最大20件、popularとprice_descでは最大10件まで取得でき、popularとprice_descはページ送りできません。該当する上限を超えるリクエストは課金前に拒否されます。price_ascには対応していません。reviewsとquestionsではsortを指定できません。shopでは指定してもエラーになりませんが、現時点では効果はありません。指定可能な値:
best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales user_id任意- shopアクションで、販売者の数値userIdを指定するための互換用フォールバックです。shopより優先度が低く、商品IDとしては使用できません。
Taobaoのreviewsのパラメータはそれぞれどういう意味ですか？
Taobao商品の購入者レビューを取得します。各レビューには評価、購入したバリエーション、「参考になった」の投票数、写真、追加レビュー、出品者の返信が含まれます。商品ID、商品リンク、または商品リンクを1つ含む共有テキストを指定してください。1回の取得ですべてのレビューが含まれるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- product_detail、reviews、questionsでは、数値の商品ID、Taobao/Tmallの商品URL、または商品URLを1つだけ含む共有メッセージを指定します。e.tb.cnおよびm.tb.cnのリンクは、商品ページへ安全に解決できる場合にのみ使用できます。TaoPasswordのみのトークン、期限切れのリンク、商品ページ以外のページは拒否されます。Taobao：商品IDとSKUの用語 — Taobaoでは、商品IDを商品リンク内のid=に続く数字と定義しており、SKUは色やサイズなど特定の属性の組み合わせを表します。商品IDとSKUを相互に置き換えて使わないでください。 · 確認日
Taobaoのquestionsのパラメータはそれぞれどういう意味ですか？
Taobaoの商品ページにある購入者の質問と回答を、各質問の回答数と投稿日とともに取得します。answer_countは返される回答の数と異なる場合があり、回答が出品者からのものとは限りません。
url必須- product_detail、reviews、questionsでは、数値の商品ID、Taobao/Tmallの商品URL、または商品URLを1つだけ含む共有メッセージを指定します。e.tb.cnおよびm.tb.cnのリンクは、商品ページへ安全に解決できる場合にのみ使用できます。TaoPasswordのみのトークン、期限切れのリンク、商品ページ以外のページは拒否されます。Taobao：商品IDとSKUの用語 — Taobaoでは、商品IDを商品リンク内のid=に続く数字と定義しており、SKUは色やサイズなど特定の属性の組み合わせを表します。商品IDとSKUを相互に置き換えて使わないでください。 · 確認日
Taobao 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":"taobao","action":"search","params":{"keyword":"<keyword>"}}'
Taobaoのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
価格スクレイピングの事業化：販売事業者が契約を更新する価格監視プロダクトの作り方
販売事業者が価格モニタリングにお金を払う理由と、サブスクリプションを解約する理由。商品マッチング、例外リスト、価格改定の承認ワークフローを通じて、価格データの提供方法、課金単位、パイロットの受け入れ基準を検討します。
記事を読む統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むAPIの失敗、クレジットの返還、照合：リクエストの正味課金額を監査する方法
タスク、呼び出し試行、配信状態、ウォレットイベントを分けて扱い、課金前の拒否、空の結果、クレジットの部分返金を二重計上せずに処理する方法を、整数を用いたオフライン例で解説します。
記事を読むTaobao APIに関する質問
Taobao APIでは何を取得できますか？
platformをtaobaoに設定します。現在のカタログには検索、商品詳細、ショップ、レビュー、質問が掲載されています。これらのアクション名はそれぞれ異なるTaobaoのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Taobaoに公式APIはありますか？
Taobao Open Platformは、TaobaoやTmallの出店者向けツールを開発するソフトウェアベンダー、サービスパートナー、ブランドを対象としています。商品や注文などの店舗データは、出店者がアプリを承認して付与するアクセストークンを使って読み取ります。購入者向けのアプリでは、代わりにTaobaoのアフィリエイト（Taobaoke）向け商品APIを利用します。
公式情報源： Taobao Open Platform：概要 · Taobao Open Platform：連携ガイド · 確認日
Taobaoの開発者アカウントやAPIキーは必要ですか？
いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。Taobaoの開発者アプリの登録、Taobao APIへのアクセス申請、Taobaoアカウントでのログインは必要ありません。また、アクションが返すのはTaobaoの公開データのみです。
Taobao APIの料金は1,000リクエストあたりいくらですか？
アクションに応じて1,000リクエストあたり$1.39から、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。
Taobaoのsearchリクエストを開始するには、どの入力を使用しますか？
searchアクションで使用するTaobaoまたはTmallの商品検索語を指定します。ストア名での完全一致検索は行いません。params内のkeywordとして送信してください。
Taobaoのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、price、currency、sold_countが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Taobaoのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。