Meme 服务

根据领域，获取某领域一个时间段内的资讯需要认证¥1/次

POST/v1/meme/memeItemsByDomain

接口说明

指定新闻领域和日期范围，获取该时间段内的所有资讯条目。

由于数据量可能较大，上游 API 响应时间可能需要数分钟，因此采用异步任务模式——本接口不会直接返回资讯数据，而是返回一个 taskId，你需要通过查询获取某领域资讯的结果接口轮询获取最终结果。

调用流程：

提交查询参数，立即返回 taskId 和 pending 状态
后台 Worker 调用外部 API 获取数据
轮询查询获取某领域资讯的结果接口查询任务状态
当 status 变为 completed 时，output 字段包含完整的查询结果

请求参数：

domain：领域标识，指定要查询的新闻领域
startDate：开始日期，格式 YYYY-MM-DD
endDate：结束日期，格式 YYYY-MM-DD
isAggregation：可选，是否启用聚合去重，默认 false

返回值：

taskId：任务唯一标识符，用于后续查询任务状态和结果
status：任务状态，固定为 pending

调用建议：

提交任务后建议每隔 3-5 秒轮询一次
当 status 变为 completed 或 failed 时停止轮询
整个查询过程一般不会超过 5 分钟，极端情况下最长 20 分钟
若任务超过 20 分钟未完成，系统将自动标记为失败并退还费用

错误说明：

HTTP 状态码	含义
401	API Key 无效
402	余额不足

授权说明：

需要提供有效的 API Key（Bearer Token）
费用在任务提交时冻结，任务完成后确认扣除，失败时自动退还

请求头

参数类型必填说明

Authorizationstring是

从 Memene API 开放平台获取的 API Key。是 Bearer Token 格式，例如：Bearer sk_memene_xxx_yyy。可以点击此处获取 API KEY

请求参数

参数类型必填说明

domainstring是

领域筛选（如 'AI', 'Finance'）

startDatestring是

开始日期，格式 YYYY-MM-DD

endDatestring是

结束日期，格式 YYYY-MM-DD

isAggregationboolean否

是否启用聚合（去重和合并），默认 false

请求示例

application/json

json

{
  "domain": "AI",
  "startDate": "2025-03-06",
  "endDate": "2025-03-13",
  "isAggregation": true
}

响应结构

202

Default Response

application/json

字段类型说明

taskIdstring

任务 ID，用于后续查询结果

statusstring

任务状态，提交后固定为 pending

示例

json

{
  "taskId": "task_abc123",
  "status": "pending"
}

401

Default Response

application/json

字段类型说明

errorstring

messagestring

示例

json

{
  "error": "Unauthorized",
  "message": "无效的 API Key"
}