Docs
開發者中心控制台esimoa.com
    • 簡介
    • 快速開始
    • 身分驗證
    • 概覽
    • 搜尋 eSIM
    • eSIM 詳情
    • 販售國家
    • OpenAPI 規格
    • 追蹤與佣金
    • 速率限制與錯誤
    • 概覽
    • Claude
    • ChatGPT
    • Gemini
    • 其他 MCP 用戶端
    • 概覽
    • 身分驗證
    • 商品搜尋
    • 商品詳情
    • 販售國家
    • 錯誤與速率限制
  1. 文件
  2. 合作夥伴 API(B2B)
  3. 商品搜尋

合作夥伴 API(B2B)

商品搜尋

GET /b2b/v1/products — 依國家、關鍵字、天數、流量等搜尋 esimoa 商品。

本頁內容
  • 請求
  • 查詢參數
  • 排序
  • 分頁
  • 回應
  • PartnerProduct 物件

請求#

GET/b2b/v1/products
curl "https://api.esimoa.com/b2b/v1/products?country=JP&isUnlimited=true&minDays=5&sortBy=price&limit=20" \
  -H "X-API-Key: $ESIMOA_PARTNER_KEY"
const params = new URLSearchParams({
  country: 'JP',
  isUnlimited: 'true',
  minDays: '5',
  sortBy: 'price',
  limit: '20',
  page: '1',
});
const res = await fetch(`https://api.esimoa.com/b2b/v1/products?${params}`, {
  headers: { 'X-API-Key': process.env.ESIMOA_PARTNER_KEY },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.code}: ${body.message}`);

const { data: products, total, page, limit } = body;
import os
import requests

res = requests.get(
    "https://api.esimoa.com/b2b/v1/products",
    params={"country": "JP", "isUnlimited": "true", "minDays": 5, "sortBy": "price", "limit": 20, "page": 1},
    headers={"X-API-Key": os.environ["ESIMOA_PARTNER_KEY"]},
    timeout=10,
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['code']}: {body['message']}")

products = body["data"]

查詢參數#

所有參數皆為選填。超出範圍的值回傳 400,未知參數會被忽略。

參數類型說明
countrystringISO 3166-1 alpha-2 國家代碼(如 JP),其他格式回傳 400
qstring關鍵字(最多 60 個字元)
isUnlimitedbooleantrue 僅無限流量,false 排除無限流量 — true | false(也可用 1 | 0)
minDays · maxDaysinteger有效天數範圍,1–365
minDataGBnumber最少流量(GB),0–1000
hasLocalNumberboolean是否提供當地電話號碼 — true | false(也可用 1 | 0)
isMultiCountryboolean是否多國商品 — true | false(也可用 1 | 0)
sortBystringrecommended(預設)| price | validity | data
sortOrderstringasc | desc — 省略時依 sortBy 使用預設值
pageinteger從 1 開始,預設 1
limitinteger1–50,預設 20

排序#

sortBy預設 sortOrder含義
recommendeddescesimoa 推薦排序(含銷量)— 與網站順序一致
priceasc價格由低到高
validityasc有效期由短到長
datadesc流量由多到少

分頁#

page 從 1 開始。回應會回傳 page、limit 與 total,最後一頁為 ceil(total / limit)。

回應#

200 OKjson
{
  "success": true,
  "data": [
    {
      "id": "partner_9VKPYQ3JRYVK5797",
      "name": "Japan Unlimited 5일",
      "country": "Japan",
      "countryCode": "JP",
      "coverageCountries": ["JP"],
      "isMultiCountry": false,
      "dataAmount": "Unlimited",
      "isUnlimited": true,
      "validityDays": 5,
      "priceKRW": 12000,
      "currency": "KRW",
      "networkType": "5G",
      "localNetworks": ["SoftBank"],
      "isLocalNetwork": true,
      "fupPolicy": null,
      "hotspotEnabled": true,
      "hasLocalNumber": false,
      "voiceMinutes": null,
      "smsCount": null,
      "supportTopUp": false,
      "supportsUsim": false,
      "activationType": "instant"
    }
  ],
  "total": 128,
  "page": 1,
  "limit": 20
}

PartnerProduct 物件#

欄位類型說明
idstring'partner_<packageCode>' — 與 esimoa 網站的商品 id 相同
namestring格式為「<地區> <流量> <N>일」的顯示名稱(韓文天數後綴)。其他語言請用結構化欄位自行組合
countrystring涵蓋地區顯示文字(多國商品會列出國家)
countryCodestring?ISO 國家代碼 — 無則省略
coverageCountriesstring[]可用國家代碼列表
regionstring?區域 — 無則省略
isMultiCountryboolean是否多國商品
dataAmountstring目錄顯示文字('10GB'、'Unlimited'、'1GB/Day + Unlimited' …)
dataAmountGBnumber?GB 數值 — 完全無限流量時省略
isUnlimitedboolean是否無限流量
validityDaysinteger有效天數
priceKRW / currencyinteger / 'KRW'esimoa 零售價(韓元)— v1 沒有合作夥伴價
networkTypestring網路(如 5G)— 未知時為 ''
localNetworksstring[]當地電信業者列表
isLocalNetworkboolean是否使用當地網路(非漫遊)
fupPolicystring | null公平使用政策(FUP)說明
hotspotEnabledboolean | null是否支援熱點 — null 表示未知
hasLocalNumberboolean是否提供當地電話號碼
voiceMinutesinteger | null通話分鐘 — -1 為無限,null 為不提供
smsCountinteger | null簡訊則數 — null 為不提供
supportTopUpboolean | null是否可加值 — null 表示未知
supportsUsimboolean是否也以實體 USIM 販售
activationTypestring開通方式(如 'instant')

注意

回應中不含供應商與成本欄位。欄位只會新增,名稱與含義不會改變,解析時請忽略未知欄位。

最後更新: 2026年10月1日

上一頁身分驗證下一頁商品詳情

本頁內容

  • 請求
  • 查詢參數
  • 排序
  • 分頁
  • 回應
  • PartnerProduct 物件

將 esimoa eSIM 接入您產品的 API 與 MCP

資源

  • 文件
  • API 參考
  • 合作夥伴 API(B2B)
  • MCP 伺服器
  • OpenAPI 規格

esimoa

  • 首頁
  • eSIM 方案
  • 開發者中心
  • 控制台
  • 合作夥伴入口網站

公司

  • 公司介紹
  • 合作諮詢
  • 服務條款
  • 隱私政策
  • 交付與退款政策

支援

  • support@esimoa.com
  • 客服聊天

NBase Korea Co., Ltd.

京畿道龍仁市水枝區新水路767號, A棟902室(東川洞,盆唐水枝U-TOWER)

美國總部: NBASE CORP. · Corporate Park, Irvine, CA 92606, USA

© 2026 esimoa. All rights reserved.