1688商品詳細API

POST

APIの稼働状況

24時間の稼働状況
99%
24時間の平均応答時間
54.07 s
  • 良好/正常
  • 利用可能
  • 制限あり
  • ほぼ停止
良好

過去24時間

過去30日間

商品リンクまたは数値のofferIdから1688の商品情報を1件取得します。段階別価格、最小注文数、在庫、バリエーション、仕様、画像、販売者情報が含まれます。price_tiersは数量が増えるほど単価が下がる価格設定を示します。バリエーションフィールドがなくても、そのバリエーションが在庫切れとは限りません。

POST https://api.everyinfra.com/api/v1/socialを送信し、platformにalibaba1688、actionにproduct_detailを指定します。 料金は1,000リクエストあたり$1.39(1回あたり$0.001389)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

1688商品詳細は、1件の卸売商品の公開情報をまとめて取得します。価格帯と段階価格、最小注文数量と価格単位、在庫と販売数、バリエーション詳細、評価と高評価率、画像に加え、サプライヤーの名前・種別・創業年・フォロワー数・お気に入り数、サンプルやドロップシッピングへの対応可否も含まれます。購買の検討やサプライヤー比較で、このサプライヤーから仕入れるべきかを判断するのに役立ちます。

urlには1688の商品リンク、商品リンクを1つだけ含む共有テキスト、または数値のオファーIDを指定します。ショップのトップページや検索ページは受け付けません。価格はprice_tiersで確認してください。数量が増えるほど単価が下がります。positive_rateは0〜1の割合で、パーセントではありません。skusのオプション・価格・在庫はプラットフォームに記載がある場合にのみ返されるため、値がなくても在庫切れとは限りません。

AIプロンプト

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

エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにalibaba1688、actionにproduct_detailを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ:
  - url: product_detailでは、detail.1688.comまたはm.1688.comの商品URL、商品URLを1つだけ含む共有メッセージ、または数値のofferIdを使用してください。qr.1688.comの共有リンクは、安全に解決した結果が商品ページとなる場合にのみ受け付けます。ストアページと検索ページは受け付けません。
- 1つのオブジェクトを返します。主なフィールド: id、url、title、text、price_min(価格帯の下限)、price_max(価格帯の上限)、currency、price_tiers(段階価格です)、min_order_quantity(最小注文数量(MOQ))、stock(在庫数)、sold_count(販売数)、category(プラットフォーム独自の分類体系におけるカテゴリ名で、プラットフォーム間で正規化…)。フィールドは全部で68個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688を参照してください。.
- リクエストボディの例:
{
  "platform": "alibaba1688",
  "action": "product_detail",
  "params": {
    "url": "https://detail.1688.com/offer/873514490218.html"
  }
}
- 料金:1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

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

リクエストパラメータ

#
名前場所型必須デフォルト説明
Authorizationheaderstringはい-Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
platformbodystringはいalibaba1688プラットフォームの識別子です。値は固定です。
actionbodystringはいproduct_detail機能の識別子です。値は固定です。
urlbody.paramsstringはい-product_detailでは、detail.1688.comまたはm.1688.comの商品URL、商品URLを1つだけ含む共有メッセージ、または数値のofferIdを使用してください。qr.1688.comの共有リンクは、安全に解決した結果が商品ページとなる場合にのみ受け付けます。ストアページと検索ページは受け付けません。商品が掲載終了している、または存在しない場合、結果は空で、empty_reasonはitem_not_foundとなり、課金されません。同じ商品について24時間以内に再度リクエストすると同じ結果が返され、こちらも課金されません。

コードサンプル

#
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": "alibaba1688",
  "action": "product_detail",
  "params": {
    "url": "https://detail.1688.com/offer/873514490218.html"
  }
}'

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

レスポンス例

#
October 13, 2026 at 04:57(UTC)に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報(名前、ハンドル、アバター、プロフィールリンク、連絡先)を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
json
{  "id": "req_…",  "platform": "alibaba1688",  "action": "product_detail",  "results": {    "id": "•••",    "url": "https://detail.1688.com/offer/873514490218.html",    "title": "跨境专供Pro6蓝牙耳机真无线入耳式超长续航tws运动无线蓝牙耳机",    "price_min": 7.1,    "price_max": 13.8,    "currency": "CNY",    "min_order_quantity": 2,    "stock": 7682692,    "sold_count": 16813,    "category": "蓝牙耳机",    "unit": "条",    "supplier_name": "深圳高耳基科技有限公司",    "supplier_fans": "582",    "supplier_type": "normal_factory",    "supplier_favorited_count": 582,    "supports_dropship": {      "enabled": false,      "consignPrice": null,      "consignPriceTiers": [],      "channels": [],      "channelDetails": [],      "protections": [],      "downstreamPerformance": null,      "metrics": {        "orders30d": null,        "orders7d": null,        "pickupRate48h": null,        "pickupRate24h": null,        "distributorCount": null,        "downstreamStoreCount": null,        "publishDate": null      }    },    "supports_sampling": false,    "is_out_of_stock": false,    "skus": [      {        "id": "•••",        "name": "Pro6蓝牙耳机  紫色",        "options": {          "颜色": "Pro6蓝牙耳机  紫色"        },        "price": 7.6,        "original_price": 7.6,        "stock": 665434,        "available": true,        "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ngwdIg1fNlJ87ZHWL_!!2218564053995-0-cib.jpg"      },      {        "id": "•••",        "name": "八代蓝牙耳机简配",        "options": {          "颜色": "八代蓝牙耳机简配"        },        "price": 9.6,        "original_price": 9.6,        "stock": 666024,        "available": true      },      {        "id": "•••",        "name": "Pro6蓝牙耳机 粉色",        "options": {          "颜色": "Pro6蓝牙耳机 粉色"        },        "price": 7.6,        "original_price": 7.6,        "stock": 664567,        "available": true,        "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VHBm431fNlJGJw3Jm_!!2218564053995-0-cib.jpg"      }    ],    "images": [      "https://cbu01.alicdn.com/img/ibank/O1CN01RrMK531fNlLKVri2p_!!2218564053995-0-cib.jpg",      "https://cbu01.alicdn.com/img/ibank/O1CN01oiS7FO1fNlJFcPVcJ_!!2218564053995-0-cib.jpg",      "https://cbu01.alicdn.com/img/ibank/O1CN019hrirk1fNlJGpWQke_!!2218564053995-0-cib.jpg"    ],    "description_images": [      "https://cbu01.alicdn.com/img/ibank/O1CN01xDu8VE1fNlOMt4i8Z_!!2218564053995-0-cib.jpg",      "https://cbu01.alicdn.com/img/ibank/O1CN01mTmUSS1fNlONCMZWr_!!2218564053995-0-cib.jpg",      "https://cbu01.alicdn.com/img/ibank/O1CN01myoX5I1fNlONcSew0_!!2218564053995-0-cib.jpg"    ],    "video_url": "https://cloud.video.taobao.com/play/u/2218564053995/p/2/e/6/t/1/482069395965.mp4",    "specs": [      {        "name": "芯片类型",        "value": "中科蓝讯"      },      {        "name": "功能",        "value": "防水,降噪,呼吸灯,超长续航,通话功能,语音控制,支持音乐,数显屏幕,电竞低延迟"      },      {        "name": "续航时间",        "value": "0-4小时"      }    ],    "rating": 4.7,    "review_count": 20,    "positive_rate": 0.95,    "sold_display": "已售2.2万+件",    "want_buy_count": 127,    "category_path": "数码、电脑 > 手机配件 > 蓝牙耳机",    "services": [      "7天无理由退货",      "晚发必赔"    ],    "winport_url": "https://winport.1688.com/page/index.html?memberId=b2b-2218564053995870c8&_tabId_=index&upstreamSource=od&offerId=873514490218",    "platform": "1688",    "rating_scale": 5  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

レスポンスフィールド

#

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

フィールド意味
idプラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。
urlプラットフォーム上のレコードへのリンクです。
titleタイトルです。プラットフォームにタイトルがない場合(テキストのみの投稿など)はnullになります。
textHTMLを除去した本文です。省略されることなく全文が返されます(一部のプラットフォームでは一覧結果自体に抜粋しか含まれません。その場合は各プラットフォームのフィールドの注記に記載しています)。
price_min価格帯の下限。
price_max価格帯の上限。
currency価格の通貨コードです(例:CNY、USD)。priceフィールドが存在してもcurrencyがnullの場合は、通貨を推測しないでください。
price_tiers段階価格です。注文数量が増えるほど単価が下がります。各段階は最小数量とあわせて確認してください。
min_order_quantity最小注文数量(MOQ)。1688での卸仕入れにおける最初の条件です。まずこれを確認してください。
stock在庫数。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
sold_count販売数。
categoryプラットフォーム独自の分類体系におけるカテゴリ名で、プラットフォーム間で正規化されていません。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
unit価格の単位(個、点、箱など)。
supplier_nameサプライヤー名。
supplier_fansサプライヤーのフォロワー数。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_founded_yearサプライヤーの設立年。
supplier_typeサプライヤーの事業形態(例:メーカー、卸売業者)です。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_favorited_countサプライヤーがお気に入りに追加された回数。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supports_dropshipサプライヤーが1個単位での代理発送(ドロップシッピング)に対応しているかどうか。在庫を持たずに販売する場合の重要な絞り込み条件です。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supports_samplingサプライヤーがサンプルを提供しているかどうか。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
is_out_of_stock商品が在庫切れかどうか。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
skusバリエーションの詳細(ある場合)。各行のオプション、価格、在庫、購入可否は、プラットフォームのデータに記載がある場合にのみ返されます。値がなくても在庫切れとは限りません。商品詳細では、同期呼び出しの場合に次のバリエーションフィールドが空になることがあります:weight_g、length_cm、width_cm、height_cm、volume_cm3、image_url、original_price。必要な場合は非同期呼び出しを使用してください。
imagesメイン商品画像のリンクで、ページ上の順序で並びます。product_detailでは一部の商品でバリエーション(SKU)画像も含まれます。説明エリアの画像はdescription_imagesに含まれます。画像がない場合は含まれません。
description_images詳細説明の画像URL一覧で、商品ページ上の元の順序で並びます。商品ページに画像がない場合はnullです。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
video_url商品ページに動画がある場合の商品動画URLです。
specs商品仕様表です。{name, value}のペアのリストで返されます(例:「素材:TPU」)。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
rating商品の総合評価(1〜5)です。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
rating_scale同じ行のratingの最大値です。5段階評価では5、10点満点では10になります。行に評価がある場合のみ含まれます。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
review_countレビューの総数です。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
positive_rate高評価率を0〜1の小数で表します(0.999 = 99.9%)。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
sold_display元の表示どおりの販売数です(中国語の原文。例:100k+件販売)。数値が必要な場合はsold_countを使用してください。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
want_buy_countこの商品を「欲しい」に登録したバイヤーの数です(仕入れ需要の指標)。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
category_path中国語の階層名による完全なカテゴリパスです(例:デジタル > スマホアクセサリー > スマホケース。実際は原語で表記されます)。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
services商品のサービスラベルです(例:返品送料無料、配送遅延補償)。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
promotions現在適用中のプロモーション名です。
customization_supportedサプライヤーがカスタマイズ(オリジナルデザイン、サンプル製作)に対応しているかどうかを示します。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
winport_urlサプライヤーの1688ストアページへのリンクです。
cityプラットフォームの言語で表記された都市名で、正規化されていません。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
provinceサプライヤーの所在地の省。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_yearsサプライヤーの1688プラットフォームでの出店年数。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
package_dimensionsプラットフォーム上の意味のまま
couponsプラットフォーム上の意味のまま
promotion_detailsプラットフォーム上の意味のまま
service_detailsサービス保証の詳細です。code(サービスコード)、name、description(ルール)、rule_url(ルールページ)を含みます。services / service_tagsには名称のみが含まれます。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
purchase_limitsプラットフォーム上の意味のまま
mix_wholesaleプラットフォーム上の意味のまま
supports_mix組み合わせ注文(異なるスタイルを組み合わせて最小注文数量を満たす注文)に対応しているかどうか。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
review_tags購入者の印象タグです。形式は[{tag, count}]で、例えば「生地が柔らかい」×2のようになります。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
refund_rateプラットフォーム上の意味のまま
review_negative_countプラットフォーム上の意味のまま
review_neutral_countプラットフォーム上の意味のまま
review_with_photo_count写真付きレビューの件数です。nullは0ではなく、値が提供されていないことを意味します。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
review_with_text_countテキスト付きレビューの件数です。nullは0ではなく、値が提供されていないことを意味します。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_statsサプライヤーのプロフィールです(値のあるキーのみ)。employee_count、plant_area_sqm(工場面積、m²)、plant_type(例:自社工場)、equipment_count(主要設備数)、product_count(販売中の商品数)、repeat_rate(リピート購入者率、0-1)、repeat_buyer_count_text / cross_border_buyer_count_text(300+など、表示どおりのリピート購入者数と越境購入者数)、response_rate(0-1)、positive_review_rate(0-1)、fulfillment_rate(0-1)、certificate_count / certificates / management_certificates(証明書の数、名称、マネジメントシステム認証)、patent_count、oem_mode(OEM/ODM)、own_brands(表示どおりの自社ブランド)、brand_count、partner_brand、is_major_brand_partner(大手ブランドへの供給実績の有無)、scale_tier(規模区分)、honorsを含みます。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_scoresプラットフォーム上の意味のまま
supplier_metric_tagsプラットフォーム上の意味のまま
supplier_rankプラットフォーム上の意味のまま
supplier_industry_belt産業集積地の認定情報です。description(例:地域アパレル産業集積地における1688認定の旗艦店)、link_url(認定ページ)を含みます。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_certification第三者による工場監査または事業監査の情報です。agency(sgs、tuvなどの監査機関コード)、report_number(表示どおりのレポート番号)、report_url(レポートページ)を含みます。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_verification_tagsプラットフォーム上の意味のまま
supplier_inspection_report_urlプラットフォーム上の意味のまま
supplier_videosプラットフォーム上の意味のまま
supplier_address表示どおりのサプライヤー住所です。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_coordinatesサプライヤーの所在地です。形式は{longitude, latitude}です。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
supplier_main_categoryサプライヤーの主要カテゴリです。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
customizationプラットフォーム上の意味のまま
shippingプラットフォーム上の意味のまま
unit_weight_kg1個あたりの重量(キログラム)。商品詳細では、同期呼び出しの場合に空になることがあります。非同期呼び出しでは通常返されます。
platform取得元プラットフォームの識別子で、リクエストのplatformと同じです(例:xiaohongshu、tiktok)。

FAQ

#

段階価格はどう読めばよいですか?

#

price_tiersは数量帯ごとの単価を示し、購入数が増えるほど下がります。min_order_quantityは最小注文数量、unitは価格単位です。コストを見積もるには、予定数量が該当する数量帯を確認してください。

メーカーと商社はどう見分けられますか?

#

supplier_typeはサプライヤーがメーカーか商社かを示します。supplier_founded_year、supplier_fans、supplier_favorited_countとあわせて見ると、営業年数や注目度を判断できます。

在庫データのないバリエーションは売り切れということですか?

#

必ずしもそうではありません。skusのオプション・価格・在庫・購入可否はプラットフォームに記載がある場合にのみ返されるため、欠けていても売り切れとは限りません。商品全体の状況はis_out_of_stockで確認してください。同期呼び出しではstock、positive_rate、supports_dropshipなどのフィールド(カテゴリ、レビュー、サービス、サプライヤー情報、バリエーションのサイズと重量。すべてフィールド一覧に記載されています)が空になることがあります。これらが必要な場合は非同期呼び出しを使用してください。

エラーと課金

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

エラー

公式リファレンス

#

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

  • 1688:商品、仕様、最小注文数量 ↗

    1688の調達関連ドキュメントでは、商品のofferId、仕様のspecId、購入数量を区別し、最小注文数量は別途検証しています。これらの用語は説明のために引用しているだけで、このエンドポイントは発注書の作成やプレビューを行いません。

    確認日:2026-09-04

Google Analyticsは同意が必要 プライバシー