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 与创建它的账号绑定,下单直接扣该账号的钱包余额。请像密码一样保管。