欢迎访问极媒数据 · 新媒体数据服务平台登录免费注册
← 返回首页

API Docs

接口文档

HTTPS + JSON,按次计费,失败不扣费。Base URL:https://www.xmedi.cn/api/v1。机器可读契约: openapi.json

接入三步

02

创建 Key 并充值

控制台创建 API Key;对公转账后由商务入账,可开发票。

03

集成调用

请求头带 X-XMEDI-Key,POST JSON 到对应路径。

鉴权与计费

  • 请求头 X-XMEDI-Key: xm_live_…(也可用 ?key= 或请求体 key 字段)。Key 只放在服务端,不要写进前端或公开仓库。
  • 每个接口单价见下方目录。成功返回 code = 0 才扣费;参数错误、平台取数失败、超时均不扣费。
  • 每次响应的 meta 带 request_id、本次扣费 cost_fen(分)与余额 balance_fen。排查问题时请提供 request_id。

调用示例

cURL · 示例
curl -X POST https://www.xmedi.cn/api/v1/wechat/search/articles \
  -H "X-XMEDI-Key: xm_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"品牌名"}'
响应
{
  "code": 0,
  "message": "ok",
  "data": { "items": [ ... ] },
  "meta": {
    "request_id": "0b6f…",
    "cost_fen": 15,
    "balance_fen": 9985
  }
}

接口目录

加载中…

错误码

失败时 HTTP 状态码非 200,code 非 0,error_code 为稳定字符串,可用于程序判断。

codeerror_codeHTTP说明
40001VALIDATION_ERROR400参数缺失或格式错误,data.details 给出字段
40100UNAUTHORIZED401API Key 缺失、无效或已吊销
40200INSUFFICIENT_BALANCE402余额不足,充值后重试
40400NOT_FOUND404接口路径不存在
42900RATE_LIMITED429超过该接口每分钟调用上限
50200UPSTREAM_ERROR502平台侧取数失败或超时,可稍后重试;不扣费
50300NOT_AVAILABLE503接口暂不可用;不扣费

服务架构

1

客户系统

您的业务、看板或 Agent 通过 HTTPS 调用。

2

极媒数据开放 API

API Key 鉴权、按次计量、限流与统一字段契约。

3

多平台数据供给

平台能力分层选路,保障微信等场景的实时性。

企业采购与定制

需要合同与发票、更高并发、专属字段或私有化对接,请联系商务。

免费注册商务咨询