- name
- followin-openapi
- description
- Documents Followin OpenAPI endpoints for agent integration. Use when calling feed APIs, channel feeds, trending, category feeds, or integrating with Followin OpenAPI.
- metadata
Followin OpenAPI
Agent 调用 Followin 信息流接口时使用本 skill。
说明：「频道」也称为「情报」或「情报中心」。
Base URL
https://api.followin.io鉴权
所有 OpenAPI 请求需携带 API Key，支持两种方式：
| 方式 | 示例 |
|---|---|
| Query 参数 | ?apikey=YOUR_API_KEY |
| Header | Authorization: YOUR_API_KEY |
支持的语言
以下接口的 lang 参数支持以下语言代码：
| 代码 | 说明 |
|---|---|
zh-Hans | 简体中文 |
zh-Hant | 繁体中文 |
en | 英语 |
vi | 越南语 |
ko | 韩语 |
接口列表
1. 热榜
获取今日热榜 feed 列表。
请求 GET /open/feed/list/trending
| 参数 | 必填 | 说明 |
|---|---|---|
| type | 否 | 类型：hot_news（默认）、pop_info |
| count | 否 | 数量，默认 15 |
| need_bind_tag | 否 | 是否仅返回有标签的，默认 false |
| lang | 否 | 语言：zh-Hans、zh-Hant、en、vi、ko |
响应
{
"list": [ { "id", "title", "content", "publish_time", "page_url", "related_feeds", ... } ],
"update_time": 1234567890
}2. 分类推荐
按分类获取推荐 feed 列表。
请求 GET /open/feed/:category_name
| 路径参数 | 说明 |
|---|---|
| category_name | 分类名：news（快讯）、articles（文章） |
| Query 参数 | 必填 | 说明 |
|---|---|---|
| count | 否 | 每页数量，默认 10，最大 30 |
| last_cursor | 否 | 分页游标（时间戳），默认 0 |
| only_important | 否 | 仅重要快讯（news 有效），默认 false |
| no_ad | 否 | 不展示广告，默认 false |
| lang | 否 | 语言：zh-Hans、zh-Hant、en、vi、ko |
响应
{
"list": [ { "id", "title", "content", "publish_time", "page_url", ... } ],
"has_more": true,
"last_cursor": "1234567890",
"last_source": "biz",
"rec_request_id": ""
}3. 指定频道信息流
获取单个频道（情报/情报中心）的信息流。
请求 GET /open/channel/feeds
| 参数 | 必填 | 说明 |
|---|---|---|
| code | 是 | 频道 code |
| count | 否 | 每页数量，默认 20，最大 30 |
| last_cursor | 否 | 分页游标，默认 0 |
| lang | 否 | 语言：zh-Hans、zh-Hant、en、vi、ko |
支持的频道 code
macro- 宏观listing_delisting- 上币/下币altcoin_update- 山寨币更新quant_signal- 量化信号live_trading_signal- 实盘信号token_unlock- 代币解锁fund_movement- 资金异动all_potential_airdrop- 空投教程airdrop_issue- 领取通知kol_post- KOL 动态trading_signal- 点位喊单trading_strategy- 交易策略meme_discover- 发现 memememe_opportunity- meme 交易机会alpha_aggregator- Alpha 聚合器exchange_coin_update- 交易所上币动态
响应
{
"list": [ { "id", "title", "content", "publish_time", "page_url", ... } ],
"has_more": true,
"last_cursor": "20"
}4. 所有频道 feed_card 信息流
获取支持 feed_card 的频道（情报/情报中心）混合信息流（含卡片）。
请求 GET /open/channel/feeds/card
| 参数 | 必填 | 说明 |
|---|---|---|
| count | 否 | 每页数量，默认 20，最大 30 |
| last_cursor | 否 | 分页游标，默认 0 |
| lang | 否 | 语言：zh-Hans、zh-Hant、en、vi、ko |
响应
{
"list": [
{
"id": 123,
"title": "...",
"content": "...",
"publish_time": 1234567890,
"page_url": "https://...",
"feed_card": {
"card_type": "f1_news",
"fields": [ { "key", "value", "key_text", "value_text" } ],
"show_feed": true
}
}
],
"has_more": true,
"last_cursor": "20"
}分页
- 首次请求：
last_cursor=0或不传 - 后续请求：使用上一页返回的
last_cursor has_more=false表示无更多数据
curl 示例
# 1. 热榜
curl -X GET "https://api.followin.io/open/feed/list/trending?type=hot_news&count=15&lang=en&apikey=YOUR_API_KEY"
# 2. 分类推荐（快讯 / 文章）
curl -X GET "https://api.followin.io/open/feed/news?count=20&lang=en&apikey=YOUR_API_KEY"
curl -X GET "https://api.followin.io/open/feed/articles?count=20&last_cursor=0&lang=zh-Hans" \
-H "Authorization: YOUR_API_KEY"
# 3. 指定频道（macro）
curl -X GET "https://api.followin.io/open/channel/feeds?code=macro&count=20&last_cursor=0&lang=en&apikey=YOUR_API_KEY"
# 4. 所有频道 feed_card
curl -X GET "https://api.followin.io/open/channel/feeds/card?count=20&last_cursor=0&lang=en&apikey=YOUR_API_KEY"
# 5. 分页（使用上一页返回的 last_cursor）
curl -X GET "https://api.followin.io/open/channel/feeds/card?count=20&last_cursor=20&lang=zh-Hans" \
-H "Authorization: YOUR_API_KEY"