开发者 API

通过 REST API 接入 MADBRiEF 的 AI 营销资讯、案例库与日报数据。基于 API Key 鉴权，按套餐计量限流。

认证方式

所有请求需在 Header 中携带 API Key：

Authorization: Bearer mk_xxxxxxxxxxxxxxxx

API Key 以 mk_ 开头。请妥善保管，切勿提交到公开仓库。

前往管理后台创建 API Key →

接口列表

GET/api/v1/open/articlesarticles:read
AI 营销资讯文章列表
参数：limit (1-50) · offset · category · industry · q
GET/api/v1/open/casescases:read
MAD案例库
参数：limit · offset · brand · category · q
GET/api/v1/open/digestdigest:read
最新 AI 日报
参数：无
GET/api/v1/open/sourcessources:read
已上线信源墙
参数：无

示例请求：

curl -H "Authorization: Bearer mk_xxx" \
  https://madbrief.com/api/v1/open/articles?limit=10

套餐与限流

套餐月配额速率权限价格
免费100 次/月10 次/分钟全部只读¥0

更多套餐即将推出，如需更高配额请联系商务。

响应与错误码

200 成功
401 API Key 缺失/无效/已禁用
403 无该接口的 scope 权限
429 触发分钟限流或超出月配额
503 服务暂不可用

限流响应头：X-RateLimit-Remaining（剩余次数）、X-RateLimit-Quota（月配额）