GEO-博客文章-列表

接口信息

• 接口地址: {your-site-url}/api/skill/geo/article-list
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 分页获取博客文章的 GEO 数据列表。

认证

请求头中需要携带 skill-access-token：

请求参数

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/geo/article-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": 5,
                "shop_id": 359,
                "article_id": 620,
                "language_code": "en",
                "summary": "This article explains how to choose a suitable camping tent based on outdoor usage scenarios.",
                "semantic_content": "This article is a camping tent selection guide that helps users evaluate different tent options before purchase.",
                "article_type": "Buying Guide",
                "topic": "Camping Tent Selection Guide",
                "category_path": ["Sports & Outdoors", "Outdoor Recreation", "Camping & Hiking", "Camping Equipment Selection"],
                "key_topics": ["Camping tent selection", "Tent size and capacity"],
                "key_points": ["The suitable tent size depends on the number of users."],
                "key_facts": [{"fact": "Tent selection should consider the number of people.", "source": "Article content"}],
                "definitions": [{"term": "Camping Tent", "definition": "A temporary shelter designed for outdoor activities."}],
                "user_questions": ["How do I choose the right camping tent?"],
                "solution_scenarios": ["Users preparing for camping trips"],
                "target_users": ["Beginner campers", "Outdoor enthusiasts"],
                "steps": [{"step": 1, "description": "Identify the camping scenario."}],
                "decision_factors": [{"factor": "Capacity", "description": "Choose a tent size according to the number of users."}],
                "comparison_dimensions": ["Size", "Capacity", "Material"],
                "limitations": ["The article provides general selection guidance."],
                "prerequisites": ["Users should understand their intended camping environment."],
                "related_products": [{"type": "Product Category", "name": "Camping Tents"}],
                "related_collections": [{"type": "Collection", "name": "Camping Equipment"}],
                "related_articles": [{"relationship": "follow_up", "topic": "Camping Equipment Checklist"}],
                "entities": [{"type": "Product Category", "name": "Camping Tent"}],
                "search_terms": ["how to choose a camping tent"],
                "faq": [{"question": "What should I consider when choosing a camping tent?", "answer": "Users should consider camping environment, tent capacity, material, portability."}],
                "geo_score": "93.50",
                "source_content_hash": "a7c92d8f3e5b1a9c7d4e8f6a2b3c5d7e",
                "created_at": "2026-08-20 10:19:52",
                "updated_at": "2026-08-20 18:50:22"
            }
        ],
        "total": 5,
        "pageSize": 1,
        "totalPage": 5
    },
    "message": "success"
}

返回字段说明

列表中每个元素为一条博客文章 GEO 数据，完整字段说明见 GEO-博客文章-保存。

注意事项

1. article_ids 支持数组与逗号分隔字符串两种传法
2. 一个文章可存在多条不同语言的 GEO 数据