OpenAPI 3.1.0 · Clay / n8n / Make / AI 智能体
StoreTechScan 开发者 API 与 OpenAPI 规范
通过同步接口,每次补全 1–100 个域名: /api/v1/inspect 使用 Bearer API 密钥认证。DNS 错误、超过 8 秒的超时、TLS 错误、5xx、429 等失败或不可访问域名,会在同一次请求内自动退还积分。
快速开始(cURL)
curl -X POST https://storetechscan.ytriple.dev/api/v1/inspect \
-H "Authorization: Bearer zsk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domains": ["gymshark.com", "allbirds.com"]}'
单域名 GET 请求(便于 Clay / Make 调用)
curl -H "Authorization: Bearer zsk_live_YOUR_API_KEY" \ "https://storetechscan.ytriple.dev/api/v1/inspect?domain=gymshark.com"
选择调用流程
交互查看可使用网页工作台与 CSV。自动化可使用付费同步 API,每次最多 100 个去重域名;超过上限会在预留积分前拒绝。
错误与重试
- 401:检查 Bearer 密钥。402:检查可用余额。400:修正输入或拆分批次。
- 新的 inspect 请求可能再次扣费。遇到结果不明的超时,请先保留已有响应并核查积分账本,不要盲目重试。
- 网页免费预览额度不适用于同步 API 请求。不计费失败会在结算时退还预留积分。
- 在 Python urllib 或自定义脚本中调用时,请显式传入 User-Agent 请求头(例如 StoreTechScanClient/1.0),以免边缘防爬规则拦截默认脚本标识。
每个运行中的服务实例默认最多同时处理 4 个同步检测请求。超出时会在预留积分前返回 429 和 Retry-After。请在调用端排队,不要无限并发。
GET /api/v1/credits
Authorization: Bearer zsk_live_YOUR_KEY
主要返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| billable | boolean | false 适用于 DNS_ERROR、TIMEOUT、TLS_ERROR、HTTP_5XX、HTTP_429、WAF_CHALLENGE、SSRF_BLOCKED(不扣积分) |
| tech_stack | string[] | 检测到的框架、电商平台、营销/客服应用与像素 |
| shopify_products_count_sample | number | null | 来自公开端点的样本数量: /products.json?limit=250 (0 为已确认的空目录,null 为未获取;超大目录可能采用较小样本) |
| shopify_price_min / median / max | number | null | 商品变体价格分布,币种字段为 shopify_currency |
| icp_vertical / business_model / icp_one_liner | string | 依据首页建议的行业与业务模式(B2C / DTC、B2B、SaaS、服务商) |
| icp_fit_score / is_real_merchant / has_b2b_wholesale | number | boolean | 校准潜客评分(1.0–5.0)、真实活跃商户核验与批发/B2B 信号(付费调用返回 calibrated_ai) |
| primary_email / generic_emails | string[] | 仅公开职能邮箱(info@、support@、sales@、hello@、contact@、partnerships@、team@、press@) |