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.