GEO-博客专辑-列表
接口信息
- 接口地址:
{your-site-url}/api/skill/geo/blog-collection-list - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址,如https://your-domain.com/apimanager666 - 请求方式:
GET - 说明: 分页获取博客专辑的 GEO 数据列表。
认证
请求头中需要携带 skill-access-token:
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
collection_ids |
array[string] | 否 | 博客专辑 ID 过滤。支持数组格式,也支持英文逗号隔开的 ID 字符串,如 343,324,54 |
pageNum |
int | 否 | 页码,从 1 开始,缺省为 1 |
pageSize |
int | 否 | 每页个数,缺省为 20 |
language_code |
string | 否 | GEO 语言代码,缺省为 en |
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/geo/blog-collection-list?pageNum=1&pageSize=10' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw ''
返回结果
code 为 200 表示调用成功;code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"list": [
{
"id": 4,
"shop_id": 359,
"collection_id": 5001,
"language_code": "en",
"summary": "An AI-generated summary of the blog collection, explaining what the collection is about.",
"semantic_content": "A comprehensive semantic description of the blog collection, helping LLMs understand the knowledge domain.",
"blog_type": "Educational Guide",
"topic": "Outdoor Camping Equipment Knowledge and Selection Guide",
"category_path": ["Outdoor Recreation", "Camping Equipment", "Camping Gear Selection"],
"key_topics": ["Camping equipment selection", "Outdoor gear knowledge"],
"key_questions": ["How to choose suitable camping equipment?"],
"target_users": ["Outdoor enthusiasts", "Camping beginners"],
"applications": ["Outdoor camping", "Hiking"],
"use_cases": ["Learning camping product knowledge"],
"content_pillars": ["Introduction to Camping Equipment", "Equipment Selection Guide"],
"knowledge_relationships": [{"from": "Basic Camping Knowledge", "to": "Equipment Selection"}],
"search_terms": ["best camping equipment guide"],
"entities": [{"type": "industry", "name": "Outdoor Recreation"}],
"faq": [{"question": "What topics does this blog collection cover?", "answer": "This collection covers camping equipment knowledge."}],
"geo_score": "85.50",
"source_content_hash": "a8f7d9e6c5b4a3219876543210abcdef1234567890abcdef1234567890abcd",
"created_at": "2026-08-20 19:41:17",
"updated_at": "2026-08-20 19:41:39"
}
],
"total": 4,
"pageSize": 1,
"totalPage": 4
},
"message": "success"
}
返回字段说明
列表中每个元素为一条博客专辑 GEO 数据,完整字段说明见 GEO-博客专辑-保存。
| 字段 | 类型 | 说明 |
|---|---|---|
code |
int | 状态码,200 表示成功 |
message |
string | 执行结果的文字描述 |
data |
object | 分页数据 |
data.list |
array[object] | 博客专辑 GEO 列表 |
data.total |
int | 总记录数 |
data.pageSize |
int | 每页个数 |
data.totalPage |
int | 总页数 |
注意事项
collection_ids支持数组与逗号分隔字符串两种传法- 一个博客专辑可存在多条不同语言的 GEO 数据