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 总页数

注意事项

  1. collection_ids 支持数组与逗号分隔字符串两种传法
  2. 一个博客专辑可存在多条不同语言的 GEO 数据
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-08-23 16:17:25

results matching ""

    No results matching ""