Xianyu API
Xianyu（Goofish）はAlibabaの中古品マーケットプレイスです。searchはキーワードに一致する出品を返します。item_detailは数値のアイテムIDまたはgoofish.comのアイテムリンクで複数の出品をまとめて読み取り、出品ごとに1件を返します。
中古品の出品はすぐに売れたり取り下げられたりするため、各行はリクエスト時点のスナップショットです。検索結果のwant_countは出品カードから取得され、カードに表示されていない場合はnullになります。item_detailではさらに、10段階の商品状態、閲覧数と保存数、すべての写真、説明文、出品者の高評価率を取得できます。取得できなかった出品はmissedに返され、課金されません。
プラットフォームの稼働状況
- 24時間の稼働状況
- 100%
過去30日間
利用可能な機能
Xianyuの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | 検索フレーズでXianyuの中古品の出品を閲覧します。1回の呼び出しで最大50件です。価格、都市、「欲しい」数、タグ、オークションフラグ、出品者の信用ランクを取得できます。出品タイトルを検索するには、中国語の語句や型番が最も適しています。want_countがnullの場合はカードに表示されていなかったことを意味し、0ではありません。 | 1,000リクエストあたり$5.56 | 良好・稼働状況100% |
出品詳細item_detail | 1〜20件の商品IDまたはgoofish.comのリンクから、Xianyuの出品情報の詳細を取得します。説明、状態スコア、送料、所在地、出品者の詳細な統計を取得できます。condition_levelは10段階評価です。Xianyuが非表示にしている場合、sold_countはnullになります。取得できなかった出品分は返金されます。 | 1,000リクエストあたり$5.56 | 良好・稼働状況100% |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Xianyuの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 検索フレーズでXianyuの中古品の出品を閲覧します。1回の呼び出しで最大50件です。価格、都市、「欲しい」数、タグ、オークションフラグ、出品者の信用ランクを取得できます。出品タイトルを検索するには、中国語の語句や型番が最も適しています。 | keyword | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$5.56 | item_id · url · title · price · original_price · currency · city · image_url · want_count · tags · category_id · free_shipping · is_auction · has_video · posted_at · seller_id · seller_name · seller_avatar_url · seller_credit_label · platform |
item_detail出品詳細 1〜20件の商品IDまたはgoofish.comのリンクから、Xianyuの出品情報の詳細を取得します。説明、状態スコア、送料、所在地、出品者の詳細な統計を取得できます。 | urls | — | Sync配信 | — | 1,000リクエストあたり$5.56 | item_id · url · title · text · price · original_price · currency · shipping_fee · condition_level · status · quantity · want_count · view_count · collect_count · sold_count · province · city · category_id · image_url · images · posted_at · seller_id · seller_name · seller_url · seller_item_count · seller_sold_count · seller_good_review_rate · seller_reply_rate_24h · district · division_id · lat · lng · poi_name · poi_id · seller_avatar_url · seller_city · seller_bio · seller_joined_at · seller_last_seen · seller_zhima_verified · seller_zhima_level · seller_zhima_level_code · seller_credit_level · seller_identity_tags · seller_other_items · platform |
Xianyuのsearchのパラメータはそれぞれどういう意味ですか？
検索フレーズでXianyuの中古品の出品を閲覧します。1回の呼び出しで最大50件です。価格、都市、「欲しい」数、タグ、オークションフラグ、出品者の信用ランクを取得できます。出品タイトルを検索するには、中国語の語句や型番が最も適しています。want_countがnullの場合はカードに表示されていなかったことを意味し、0ではありません。
keyword必須searchで使用するXianyuの検索語句（1～100文字）です。英訳よりも中国語の語句や型番のほうが出品者のタイトルに一致しやすくなります。商品IDや出品者名ではありません。
Xianyuのitem_detailのパラメータはそれぞれどういう意味ですか？
1〜20件の商品IDまたはgoofish.comのリンクから、Xianyuの出品情報の詳細を取得します。説明、状態スコア、送料、所在地、出品者の詳細な統計を取得できます。condition_levelは10段階評価です。Xianyuが非表示にしている場合、sold_countはnullになります。取得できなかった出品分は返金されます。
urls必須item_detailで使用する、1～20件のXianyu出品の配列です。各要素は数値の商品ID（searchが返すitem_id）またはhttps://www.goofish.com/item?id=<digits>形式のリンクで、同じ出品は1回までしか指定できません。課金は出品ごとに行われ、読み取れなかった出品は返金されます。アプリの共有短縮リンクは使用できません。Alibaba Open Platform：Xianyuの商品IDと状態ランク — 認可済みのXianyu ISVパートナー向けのAlibabaの商品照会APIでは、1件の出品を数値のXianyu商品IDで識別し、状態をstuff_statusで区分します。100は新品、95は95%新品相当、-1はほぼ新品です。呼び出しにはAlibabaのパートナー環境内での認可が必要です。この資料で確認できるのは識別子と状態の用語のみであり、EveryInfraがこのAPIを使用していることや、あらゆる出品のすべてのフィールドを取得できることを意味するものではありません。 · 確認日
Xianyu 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":"xianyu","action":"search","params":{"keyword":"<keyword>"}}'
Xianyu APIに関する質問
Xianyu APIでは何を取得できますか？
platformをxianyuに設定します。現在のカタログには検索と出品詳細が掲載されています。これらのアクション名はそれぞれ異なるXianyuのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Xianyuのsearchリクエストを開始するには、どの入力を使用しますか？
searchで使用するXianyuの検索語句（1～100文字）です。英訳よりも中国語の語句や型番のほうが出品者のタイトルに一致しやすくなります。商品IDや出品者名ではありません。params内のkeywordとして送信してください。
Xianyuのsearchはどのフィールドを返しますか？
宣言されたスキーマにはitem_id、title、price、original_priceが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Xianyuのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。item_detailrunsは同期でのみ動作します。1回の呼び出し内で返すすべてのデータ（バッチのすべての対象、または商品のすべてのSKU）を読み取るため、"mode": "async"を指定したリクエストには課金前に422が返されます。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。