API 文档
一个通用端点,传service_code选择要调用的功能。价格跟网页端完全一致,不因为走API或走对话入口而不同。
鉴权
在控制台创建API Key,放进Authorization头。只有Max及以上订阅档位能创建Key。
Authorization: Bearer sk-your-key-here
快速开始
列出可用功能与价格
curl https://silink.ai/api/v1/business/services \
-H "Authorization: Bearer sk-your-key-here"
OpenAPI 规范 / Postman
只覆盖本API的精简规范,含13个service_code各自的payload schema,可直接导入Postman / Insomnia / 代码生成器:
/developer/openapi.json ·
/developer/openapi.yaml
MCP(AI Agent 平台)
同一套功能以 MCP 工具形式提供(Streamable HTTP)。在 Claude Desktop / n8n / Clay 等支持 MCP 的平台里添加服务器,URL 填下面这个,鉴权用同一把 API Key 作 Bearer。13 个功能各是一个工具,先调 list_services 看价格和余额。
MCP URL: https://silink.ai/mcp
Authorization: Bearer sk-your-key-here
调用一个功能
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code":"verify.brand_check","payload":{"brand":"...","markets":["us_uk"]}}'
幂等
建议在请求体里带idempotency_key(推荐用uuid4)——同一个key重复调用直接返回第一次的结果,不会重复扣费。不传的话服务器自动生成一个,但不带重试保护。
Sandbox(免费测试)
不需要Max/Business订阅——登录后在控制台一键领取一把 sk-test- 开头的Key,对全部13个功能免费调用。返回真实结构、真实数据的示例响应(不是实时查询,数据会过时),每个功能每月20次免费额度,不扣spTok。想接入正式生产,再升级订阅换正式Key,代码不用改,换Key即可。
Authorization: Bearer sk-test-your-sandbox-key
响应体固定带 sandbox:true 和 sandbox_note 说明用量;额度用完返回402 sandbox_quota_exceeded。
异步模式(耗时长的服务)
report.new_product_intelligence(20-40秒)和report.target_list_export(1-3分钟)这两个最耗时的服务支持async:true。扣款仍然是同步的(跟不传async时规则完全一样),但引擎运行推迟到后台——请求立即返回202和job_id,不用让HTTP连接空等几分钟。
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code":"report.target_list_export","payload":{"industry":"..."},"async":true,"callback_url":"https://yourapp.com/webhooks/silink"}'
# → HTTP 202
{"ok":true,"async":true,"job_id":"job_...","status":"queued",
"status_url":"https://silink.ai/api/v1/business/jobs/job_...",
"callback_secret":"..."}
查状态(拉取)
curl https://silink.ai/api/v1/business/jobs/job_your_job_id \
-H "Authorization: Bearer sk-your-key-here"
不传callback_url也完全可以,轮询这个端点直到status变成succeeded/failed即可。status包括queued/running/succeeded/failed。
收回调(推送)
callback_url必须是https://,且不能指向内网/本机地址。任务完成后POST到这个地址,body结构见下;失败(非2xx或超时)会按10s/1min/5min/15min/1h/3h/6h/12h退避重试,共8次,全部失败后标记exhausted——但这只影响推送,结果本身永远能从上面的status端点查到,不会丢。
POST https://yourapp.com/webhooks/silink
X-SiLink-Signature: sha256=<hex>
X-SiLink-Job-Id: job_...
{"event":"job.succeeded","job_id":"job_...","service_code":"report.target_list_export",
"idempotency_key":"...","ok":true,"result":{ ... },"usd_charged":1200,"payment_intent_id":"pi_..."}
验签: X-SiLink-Signature 是 sha256=hmac_sha256(callback_secret, 原始请求体字节)。callback_secret只在建任务的202响应里出现一次,请立即保存。
限速
按API Key计,60秒滑动窗口。超过限速返回429,响应体带retry_after(秒)和limit_per_min,并带标准Retry-After响应头,SDK可以直接按这个值退避重试。
| 订阅档位 | 每分钟调用上限 |
|---|
| max | 60 |
| business | 600 |
HTTP/1.1 429 Too Many Requests
Retry-After: 12
{"detail":{"error":"rate_limited","retry_after":12,"limit_per_min":60,"msg":"..."}}
需要更高限速的合作平台请联系我们。
响应格式
成功响应统一是ok:true + result。result的结构因service_code而异;计费字段因该服务是否走订阅池而不同。
走订阅池的服务(绝大多数)
{
"ok": true,
"service_code": "discover.buyers",
"result": { ... },
"sptok_charged": 1000,
"price_charged_usd_reference": 10.0,
"volume_discount_factor": 1.0,
"idempotency_key": "…",
"replayed": false
}
不进池的服务(标有 not pooled)
按次用账户已保存的付款方式直接扣款。扣款成功返回usd_charged + payment_intent_id;自动扣款失败时返回HTTP 200但ok:false,带checkout_url,此时不会跑引擎也不会扣款。
{ "ok": false, "error": "offsession_charge_failed", "checkout_url": "https://…",
"checkout_session_id": "cs_live_…", "deliver_url": "https://silink.ai/api/v1/business/checkout/cs_live_…/deliver" }
让用户在checkout_url完成付款后,用同一把Key对deliver_url发POST,服务会执行并返回结果;付款未完成返回402 checkout_pending。deliver是幂等的,重复调用回放结果,不重复扣款。
report.* 类服务的result里带download_urls,用它去下载PDF/DOCX/MD/TXT,响应体里不直接带文件。
错误码
| 状态码 | error | 含义 |
|---|
| 400 | unknown_service_code | 未知或尚未开放的service_code,响应体available字段列出可用的 |
| 400 | engine_rejected_input | 引擎拒绝了输入参数。已扣款会自动退款 |
| 401 | — | API key无效或未激活 |
| 402 | insufficient_sptok | spTok余额不足,响应体带need/have |
| 402 | volume_over_limit | 本月调用量超过10万次,需客制报价 |
| 403 | tier_insufficient | 订阅档位没有API权限(需要Max及以上) |
| 402 | checkout_pending | deliver端点:付款尚未完成 |
| 400 | async_not_supported | 这个service_code不支持async:true,响应体列出哪些支持 |
| 400 | invalid_callback_url | callback_url必须是https://且不能指向内网/本机地址 |
| 429 | rate_limited | 超过限速,见上方限速一节 |
| 500 | engine_error | 引擎执行失败。已扣款会自动退款 |
所有非2xx响应的结构都是 {"detail":{"error":"…","msg":"…"}}。不进池服务的自动扣款失败不是错误码,是HTTP 200 + ok:false,见响应格式一节。
功能参考
发现买家（每次搜索，10个候选）
$10
service_code: discover.buyers
单次调用耗时约9-12秒(两次LLM+数据库扫描),同步返回完整结果,无流式进度。
payload字段:
product — 产品/需求描述(必填) · province — 限定省份(可选)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "discover.buyers", "payload": {"product": "...", "province": "..."}, "lang": "zh"}'
发现供应商（每次搜索，10个候选）
$10
service_code: discover.suppliers
单次调用耗时约5-8秒,同步返回完整结果,无流式进度。
payload字段:
product — 产品/需求描述(必填) · province — 限定省份(可选)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "discover.suppliers", "payload": {"product": "...", "province": "..."}, "lang": "zh"}'
发现中国买家（按省份/行业清单）
$49
service_code: discover.cn_buyers
返回全部31省买家密度排名;传province时一并返回该省买家企业清单。
payload字段:
industry — 行业名称(必填) · province — 若指定,额外返回该省买家企业名录(可选)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "discover.cn_buyers", "payload": {"industry": "...", "province": "..."}, "lang": "zh"}'
发现竞争对手
$29
service_code: discover.competitors
返回同业竞对完整清单,单次调用最多返回500条(超出按评分排序截断,capped字段标记是否发生截断)。
payload字段:
company — 目标企业全称(必填) · same_province_only — 是否仅限同省(可选,默认false)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "discover.competitors", "payload": {"company": "...", "same_province_only": true}, "lang": "zh"}'
出海品牌核查／中国品牌核查
$99
service_code: verify.brand_check
payload字段:
brand — 品牌名(必填) · markets — 目标市场id列表,见brand_check.MARKETS
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "verify.brand_check", "payload": {"brand": "...", "markets": ["us_uk"]}, "lang": "zh"}'
企业深度风险核验（诉讼/失信/变更）
$49
service_code: verify.deep_risk_check
payload字段:
identifier — 企业全称或18位统一社会信用代码(必填)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "verify.deep_risk_check", "payload": {"identifier": "..."}, "lang": "zh"}'
中国行业分析报告
$79
service_code: report.industry_overview
$79/次,走普通spTok订阅池扣款(低于$299门槛)。返回download_urls获取PDF/DOCX/MD/TXT四格式报告。耗时约10-20秒。
payload字段:
industry — 行业名称(必填) · province — 限定省份(可选)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "report.industry_overview", "payload": {"industry": "...", "province": "..."}, "lang": "zh"}'
选落地省份决策（行业推荐）
$99
service_code: decide.province
给定行业,返回全部31省目标企业密度排名(不截断)。语义是'给行业推荐落地省份',不是查询单个具体省份的详情。
payload字段:
industry — 行业名称(必填,如'电子设备制造')
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "decide.province", "payload": {"industry": "..."}, "lang": "zh"}'
中国供应商对比
$149
service_code: decide.compare_suppliers_5
跟网页/check/compare付费流程同一个full_compare()引擎,已在生产环境验证真实完成过付款+交付全流程。
payload字段:
names — 企业全称字符串数组,2-5家(必填)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "decide.compare_suppliers_5", "payload": {"names": ["...", "..."]}, "lang": "zh"}'
海外市场优选决策
$29
service_code: decide.market
返回全部覆盖国家的采购方数量排序(不截断)。
payload字段:
product — 产品/需求描述(必填)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "decide.market", "payload": {"product": "..."}, "lang": "zh"}'
企业起名／更名／取英文名
$39
service_code: build.naming
payload字段:
company — 中文企业全称(必填)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "build.naming", "payload": {"company": "..."}, "lang": "zh"}'
New Product Intelligence Report不进池
$899
service_code: report.new_product_intelligence
$899/次,不吃订阅月度池(v3.1规定超过$299门槛一律单独计费)。优先用账户已保存的付款方式直接扣款;扣款失败时返回checkout_url改走人工确认付款。耗时约20-40秒。
payload字段:
product — 产品/需求描述(必填) · mode — design或deconstruct,默认design
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "report.new_product_intelligence", "payload": {"product": "...", "mode": "..."}, "lang": "zh"}'
目标名单导出报告(30家)不进池
$1200
service_code: report.target_list_export
$1200/次,最多30家企业的完整名单+联系方式+PDF/DOCX/MD/TXT四格式报告,不吃订阅月度池,走跟New Product Report同样的off-session扣款。耗时可能长达1-3分钟(含AI批量生成入选理由+联系方式现抓)。返回download_urls,不在响应体里直接带二进制文件。
payload字段:
industry — 行业名称(必填) · province — 限定省份(可选) · tiers — 限定档位列表如['listed','srdi'](可选) · min_insured — 最小参保人数门槛,默认2(可选)
curl -X POST https://silink.ai/api/v1/business/run \
-H "Authorization: Bearer sk-your-key-here" \
-H "Content-Type: application/json" \
-d '{"service_code": "report.target_list_export", "payload": {"industry": "...", "province": "...", "tiers": ["listed", "high_tech"], "min_insured": 2}, "lang": "zh"}'