Memene API

开发文档
开发者控制台
Meme 服务按订阅方案 ID 获取历史日报列表
Meme 服务

按订阅方案 ID 获取历史日报列表需要认证¥0.05/次

GET/v1/meme/dailySummaries

接口说明

按订阅方案 ID 翻页获取该方案(在 Memene 体系内也称为 "频道")的历次日报概览。 返回的每条日报包含速览短句、Top 话题列表、对应日期与方案信息,可直接用于 列表展示或作为后续详情查询的索引。

典型用法(AI 调用建议的"两步"流程):

  1. 先通过 按用户查询订阅方案列表 拿到目标 planId(如果你已经有 planId,可以跳过此步)。

  2. 调用本接口翻页读取该方案的历史日报。常见做法:

    • 想看 "最近 N 期日报":用 start=0&end=N&orderByDate=desc
    • 想按时间区间过滤:"orderByDate=desc&startDate=<ms>&endDate=<ms>", start/end 同时收窄为本批分页范围。

查询参数:

参数类型是否必填说明
planIdstring必填目标订阅方案 ID(即频道 ID)
startstring(number)必填起点索引(0 表示从最新一条开始)
endstring(number)必填终点索引(不包含),end - start 即一批最多返回多少条
orderByDate"asc" | "desc"可选排序方向;默认 desc(最新优先)
startDatestring(number)可选起始时间戳,毫秒级字符串
endDatestring(number)可选截止时间戳,毫秒级字符串
onlyFavorites"true" | "false"可选是否仅返回收藏过的日报;通常对外调用方填 false 或不传

关于 start/end:上游使用 "从最新一条为 0 开始的下标区间"。也就是说 start=0&end=20 拿到最新 20 期;下一页用 start=20&end=40。 始终传字符串数字即可(如 "0" / "20"),路由会透传。

返回值结构:

data
├── totalCount             # 当前过滤条件下的总日报数,用于客户端分页
└── historyRecords[]       # 本批日报记录
    ├── id                 # 数据库自增 ID
    ├── refSubscribePlanId # 关联订阅方案 ID(与查询 planId 一致)
    ├── planName           # 方案名(冗余便于直接展示)
    ├── date               # 日报对应日期,YYYY-MM-DD
    ├── timestamp          # 日报生成毫秒级时间戳
    ├── week               # 星期几(中文)
    ├── summaryTitle       # 日报短标题(系统生成)
    ├── title              # 日报详细标题
    ├── contentSummary[]   # 速览短句列表,可直接拼接展示
    ├── topTopicList[]     # 当日 Top N 话题,每项含 index/topic/isRelated
    ├── isFavorited        # 当前调用上下文下是否已收藏
    └── avatar             # 方案封面图,便于卡片渲染

速读字段建议(写 AI Prompt 时优先消费):

  • 想拿日报"一句话总结":用 summaryTitletitle
  • 想拿日报"速览短句":用 contentSummary 数组,每条短句已是可读句子。
  • 想拿日报"重点话题":用 topTopicListtopic 字段,按数组顺序即重要度。

错误说明:

HTTP 状态码含义
400planId / start / end 缺失或格式错误
401API Key 无效
402余额不足
502上游 Meme API 服务暂时不可用

授权说明:

  • 需要提供有效的 API Key(Bearer Token)
  • 每次调用按 unitPrice 扣除相应费用,失败时自动退还
请求头
参数类型必填说明
Authorizationstring

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

请求参数
参数类型必填说明
planIdstring

订阅方案 ID。可通过订阅方案列表接口获取,作为本接口的主要筛选条件。

startstring

起点索引(字符串数字)。0 表示从最新一条日报开始;用于分页配合 end。

endstring

终点索引(字符串数字,不包含该位置)。end - start 等于本次最多返回的条数。

orderByDateascdesc

按日期排序方向。asc=升序,desc=降序。默认 desc。

startDatestring

起始时间戳(毫秒级字符串)。仅返回该时间之后的日报。

endDatestring

截止时间戳(毫秒级字符串)。仅返回该时间之前的日报。

onlyFavoritestruefalse

是否仅返回已收藏的日报。true/false 字符串。默认 false。

响应结构
200

Default Response

application/json
字段类型说明
statusCodenumber

状态码。200 表示成功。

statusTextstring

状态文本。

dataobject

历史日报数据主体。

totalCountnumber

满足条件的日报总条数。可用于实现客户端分页。

historyRecordsarray

本次返回的日报记录列表,按 orderByDate 排序。

idnumber

日报记录的数据库自增 ID。

refSubscribePlanIdstring

关联的订阅方案 ID。

planNamestring

订阅方案名称(冗余字段,便于直接展示)。

datestring

日报对应的内容日期,格式 YYYY-MM-DD。

timestampnumber

日报生成时间的毫秒级时间戳。

weekstring

对应中文星期,如 "星期一"。

summaryTitlestring

日报标题(系统生成的简短描述)。

titlestring

日报详细标题(通常含日期后缀)。

contentSummaryarray

日报速览短句列表,可直接拼接展示作为内容摘要。

topTopicListarray

当日 Top N 话题列表。索引大致代表话题在原文中的位置。

indexnumber

话题在日报全文中的原始序号。

topicstring

话题标题。

isRelatedboolean

是否被判定为与订阅方案主题相关。

isFavoritedboolean

当前请求上下文下,该日报是否已被收藏。

avatarstring

订阅方案封面图,便于直接展示。

示例
json
{
  "statusCode": 200,
  "statusText": "OK",
  "data": {
    "totalCount": 1,
    "historyRecords": [
      {
        "id": 2188,
        "refSubscribePlanId": "cm6u2wnxw0000pbv90wk75eff",
        "planName": "人工智能前瞻报",
        "date": "2025-02-24",
        "timestamp": 1740348307992,
        "week": "星期一",
        "summaryTitle": "前瞻报_2025-02-24",
        "title": "DeepSeek 的崛起,揭示了美国的技术泡沫_2025-02-24",
        "contentSummary": [
          "DeepSeek 的崛起,揭示了美国的技术泡沫!",
          "AI 盛宴来袭,千亿资本引发人才争夺战!",
          "DeepSeek 引领 AI 革命,冲击 AGI 的未来!"
        ],
        "topTopicList": [
          {
            "index": 1,
            "topic": "DeepSeek 的崛起,揭示了美国的技术泡沫!",
            "isRelated": true
          },
          {
            "index": 2,
            "topic": "AI 盛宴来袭,千亿资本引发人才争夺战!",
            "isRelated": true
          }
        ],
        "isFavorited": false,
        "avatar": "https://yuansun-assests.oss-cn-hangzhou.aliyuncs.com/newsdiy/assets/subscribeChannel/templatePlanCover/cat_01.jpg"
      }
    ]
  }
}
400

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Bad Request",
  "message": "缺少必要的 planId 或 userId"
}
401

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Unauthorized",
  "message": "无效的 API Key"
}
402

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Payment Required",
  "message": "余额不足"
}
502

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Bad Gateway",
  "message": "上游 Meme API 服务暂时不可用"
}