プラットフォームの稼働状況
- 24時間の稼働状況
- 99%
過去30日間
利用可能な機能
1688の各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | 商品キーワードで1688の卸売商品を一覧表示します。価格帯、最小注文数、注文数、リピート率、販売者情報が含まれます。並び順やorder_countは、正確な販売数や最終見積もりを示すものではありません。 | 1,000リクエストあたり$2.78 | 良好・稼働状況100% |
商品詳細product_detail | 商品リンクまたは数値のofferIdから1688の商品情報を1件取得します。段階別価格、最小注文数、在庫、バリエーション、仕様、画像、販売者情報が含まれます。price_tiersは数量が増えるほど単価が下がる価格設定を示します。バリエーションフィールドがなくても、そのバリエーションが在庫切れとは限りません。 | 1,000リクエストあたり$1.39 | 良好・稼働状況99% |
プラットフォーム内の商品画像検索image_search | image_urlの商品写真1枚を1688の商品と照合し、類似する卸売商品を最大5件取得します。タイトル、CNY価格、最小注文数、販売者、リンクが含まれます。rankはこの画像に対する一致順位であり、売上ランキングではありません。 | 1,000リクエストあたり$5.56 | 良好・稼働状況98% |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
1688の各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 商品キーワードで1688の卸売商品を一覧表示します。価格帯、最小注文数、注文数、リピート率、販売者情報が含まれます。並び順や | keyword | city, max_price, min_price, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$2.78 | id · url · title · text · price_min · price_max · currency · min_order_quantity · order_count · repurchase_rate · category · city · province · supplier_name · is_out_of_stock · supports_dropship · images · supplier_type · supplier_years · supplier_shop_url · supplier_composite_score · sold_count_text · service_tags · product_badges · rating · rating_scale · review_count · positive_rate · sold_count · sold_display · want_buy_count · stock · unit · category_path · video_url · winport_url · supplier_fans · supplier_founded_year · price_tiers · specs · description_images · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
product_detail商品詳細 商品リンクまたは数値のofferIdから1688の商品情報を1件取得します。段階別価格、最小注文数、在庫、バリエーション、仕様、画像、販売者情報が含まれます。 | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · title · text · price_min · price_max · currency · price_tiers · min_order_quantity · stock · sold_count · category · unit · supplier_name · supplier_fans · supplier_founded_year · supplier_type · supplier_favorited_count · supports_dropship · supports_sampling · is_out_of_stock · skus · images · description_images · video_url · specs · rating · rating_scale · review_count · positive_rate · sold_display · want_buy_count · category_path · services · promotions · customization_supported · winport_url · city · province · supplier_years · package_dimensions · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
image_searchプラットフォーム内の商品画像検索
| image_url | — | Sync配信 | カタログ値：defaultLimit=5、maxLimit=5。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$5.56 | id · url · title · price · currency · min_order_quantity · order_count · supplier_name · image_url · rank · platform |
1688のsearchのパラメータはそれぞれどういう意味ですか？
商品キーワードで1688の卸売商品を一覧表示します。価格帯、最小注文数、注文数、リピート率、販売者情報が含まれます。並び順やorder_countは、正確な販売数や最終見積もりを示すものではありません。
keyword必須- 1688の卸売商品の検索語を指定します（例：保温マグ、段ボール箱）。店舗名やofferIdではなく商品を表す語を使用してください。最小注文数量と段階別価格は商品詳細に含まれて返されます。
city任意- 1688の卸売商品のクエリを都市名のテキストで絞り込みます。このフィルターはアカウントの所在地を反映せず、返される販売者の住所も変更しません。また、単一商品の詳細リクエストで絞り込みが継続して適用されることも保証されません。
max_price任意- 卸売商品を単価の上限（数値）で絞り込みます。小数も指定できます。呼び出しが人民元の整数単位でのフィルタリングにフォールバックした場合は切り上げられるため（145.98は146になります）、範囲は広がる方向にのみ変わります。min_priceと組み合わせて価格帯を区切るもので、注文数量の段階を区切るものではありません。また、すべてのSKUバリエーションや数量割引の段階を網羅するとは限りません。
min_price任意- 卸売商品を単価の下限（数値）で絞り込みます。小数も指定できます。呼び出しが人民元の整数単位でのフィルタリングにフォールバックした場合は切り捨てられるため（39.81は39になります）、範囲は広がる方向にのみ変わります。このパラメータは商品の条件を設定するもので、最小注文数量やAPIの利用額の上限を設定するものではありません。返される段階別価格は注文数量によって異なります。
sort任意- 検索結果の商品をrelevance（searchのデフォルト）、popular、price_asc、price_descで並べ替えます。並べ替えの基準を指定しても、ペイロードに正確な販売数や総取引額が含まれるとは限りません。指定可能な値:
popularprice_ascprice_descrelevance
1688のproduct_detailのパラメータはそれぞれどういう意味ですか？
商品リンクまたは数値のofferIdから1688の商品情報を1件取得します。段階別価格、最小注文数、在庫、バリエーション、仕様、画像、販売者情報が含まれます。price_tiersは数量が増えるほど単価が下がる価格設定を示します。バリエーションフィールドがなくても、そのバリエーションが在庫切れとは限りません。
url必須- product_detailでは、detail.1688.comまたはm.1688.comの商品URL、商品URLを1つだけ含む共有メッセージ、または数値のofferIdを使用してください。qr.1688.comの共有リンクは、安全に解決した結果が商品ページとなる場合にのみ受け付けます。ストアページと検索ページは受け付けません。1688：商品、仕様、最小注文数量 — 1688の調達関連ドキュメントでは、商品のofferId、仕様のspecId、購入数量を区別し、最小注文数量は別途検証しています。これらの用語は説明のために引用しているだけで、このエンドポイントは発注書の作成やプレビューを行いません。 · 確認日
1688のimage_searchのパラメータはそれぞれどういう意味ですか？
image_urlの商品写真1枚を1688の商品と照合し、類似する卸売商品を最大5件取得します。タイトル、CNY価格、最小注文数、販売者、リンクが含まれます。rankはこの画像に対する一致順位であり、売上ランキングではありません。
image_url必須- image_searchでは、公開されているHTTPSの商品画像URLを1つ指定してください。このアクションは画像を1枚送信し、一致する1688の出品を最大5件返します。詳細情報やSKU情報の付加は含まれません。1688オープンプラットフォーム：画像からの類似商品検索 — 1688のオープンプラットフォームには、画像URLまたは画像データを受け付ける公式の類似商品検索が記載されています。この出典が示すのは、プラットフォーム側の画像から商品を検索する仕組みのみです。EveryInfraでの画像1枚までの制限、最大5件の結果、レスポンスフィールドの許可リスト、課金、結果の提供方法は、EveryInfraが公開しているドキュメントで定めています。 · 確認日
1688 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":"alibaba1688","action":"search","params":{"keyword":"<keyword>"}}'
1688のガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
価格スクレイピングの事業化：販売事業者が契約を更新する価格監視プロダクトの作り方
販売事業者が価格モニタリングにお金を払う理由と、サブスクリプションを解約する理由。商品マッチング、例外リスト、価格改定の承認ワークフローを通じて、価格データの提供方法、課金単位、パイロットの受け入れ基準を検討します。
記事を読む統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むAPIの失敗、クレジットの返還、照合：リクエストの正味課金額を監査する方法
タスク、呼び出し試行、配信状態、ウォレットイベントを分けて扱い、課金前の拒否、空の結果、クレジットの部分返金を二重計上せずに処理する方法を、整数を用いたオフライン例で解説します。
記事を読む1688 APIに関する質問
1688 APIでは何を取得できますか？
platformをalibaba1688に設定します。現在のカタログには検索、商品詳細、プラットフォーム内の商品画像検索が掲載されています。これらのアクション名はそれぞれ異なる1688のオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
1688に公式APIはありますか？
Alibabaの1688 Open Platformは、1688の出店者や、1688から仕入れ・ドロップシッピングを行う購入者向けに、出品、受注管理、越境購買などのツールを開発するソフトウェアベンダーを対象としています。1,600社を超えるパートナーベンダーが掲載されています。
公式情報源： 1688 Open Platform · 確認日
1688の開発者アカウントやAPIキーは必要ですか？
いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。1688の開発者アプリの登録、1688 APIへのアクセス申請、1688アカウントでのログインは必要ありません。また、アクションが返すのは1688の公開データのみです。
1688 APIの料金は1,000リクエストあたりいくらですか？
アクションに応じて1,000リクエストあたり$1.39から、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。
1688のsearchリクエストを開始するには、どの入力を使用しますか？
1688の卸売商品の検索語を指定します（例：保温マグ、段ボール箱）。店舗名やofferIdではなく商品を表す語を使用してください。最小注文数量と段階別価格は商品詳細に含まれて返されます。params内のkeywordとして送信してください。
1688のsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、price_min、price_maxが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
1688のアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。