KOL Match
✍️ 中国自媒体 📰 中国媒体 🌏 海外自媒体 🗞️ 海外媒体 API 接口
VIP 专享

把整个媒体库接进你自己的系统

一套 REST API,覆盖 4 万+ 中国自媒体与媒体资源,以及海外达人库。代理商、SaaS 产品和 MCN 可以直接对接,不必再来回传表格。

API 面向 VIP 客户开放。注册账号后联系我们开通。

curl
curl https://kol.ltd/api/ext/self-media?category=cn_wemedia \
  -H "Authorization: Bearer kol_live_xxxxxxxxxxxx"

{
  "data": [
    {
      "id": "mbx_10241",
      "account_name": "科技每日推送",
      "platform": "微信公众号",
      "category": "cn_wemedia",
      "price": "480.00",
      "currency": "CNY",
      "delivery_days": 1
    }
  ],
  "total": 43105
}

谁在用

把资源库、报价和订单状态接进你已经在用的系统。

🏢

代理商与公关公司

最新资源与报价直接同步进内部报价单,不用每周找我们要表格。

🤖

自建平台与 SaaS

在你自己的产品里展示资源、下单,并把发布链接回传给你的客户。

📊

数据与比价

按平台、行业、地区批量拉取报价,做成本分析和竞品对比。

🔁

自动化流程

把发稿接进内容日历或工单系统,状态变化自动同步过去。

现有接口

以下接口已经在线,拿到 Key 就能调用。

GET/api/ext/self-media检索发稿资源库,支持平台、行业、关键词与分页
GET/api/ext/self-media/facets列出可用的分类、平台与行业筛选值
GET/api/ext/self-media/{id}获取单个资源的报价与出稿时间
POST/api/ext/orders下发稿订单,自动从账户钱包扣款
GET/api/ext/orders列出本账户的发稿订单
GET/api/ext/orders/{id}获取订单详情,含每条稿件的状态与回传链接
POST/api/ext/orders/{id}/pay充值后支付一笔待付款订单
POST/api/ext/orders/{id}/items/{itemId}/request-refund对某条稿件发起退款申请
GET/api/ext/wallet查询账户钱包余额
GET/api/ext/wallet/ledger查询钱包流水(充值、消费、退款)
GET/api/ext/creators检索海外达人,支持平台、粉丝层级与关键词
GET/api/ext/creators/{id}获取达人档案与受众数据
GET/api/ext/campaigns列出投放活动
GET/api/ext/analytics账户维度的效果汇总
GET/api/ext/me校验 Key 是否有效

完整字段与示例见 openapi.json

三步接入

01

注册账号

注册并开通 VIP 后,就能在设置里生成 API Key。

02

生成 Key

Key 只在生成时完整显示一次,请当作密码保存。

03

开始调用

带上 Authorization 头请求 /api/ext,返回标准 JSON。

接口约定

600 / min
每 IP 每分钟请求上限
Bearer kol_…
认证方式
JSON · REST
响应格式

🔐 Key 绑定账号

每个 Key 属于创建它的账号。调用 /me 可以确认当前身份;订单与钱包接口只能看到本账号的数据,下单也只扣本账号的余额。

🧯 花多少由你定

每把 Key 可以单独设置单笔上限和日限额,也可以直接关掉下单权限。超过单笔上限返回 403,超过日限额返回 429,钱包分文不动。调 /me 可以看到今天还剩多少额度。

Key 与创建它的账号绑定,下单直接扣该账号的钱包余额。请像密码一样保管。

需要更高频率或专属接口?

VIP 客户可以申请独立配额、IP 白名单和定制字段。