GEO-自定义页面-列表
接口信息
- 接口地址:
{your-site-url}/api/skill/geo/page-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) |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
page_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/page-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,
"page_id": 112,
"language_code": "en",
"summary": null,
"semantic_content": null,
"page_type": "",
"topic": "",
"category_path": [],
"key_topics": [],
"key_facts": [],
"benefits": [],
"applications": [],
"target_users": [],
"user_questions": [],
"solution_scenarios": [],
"search_terms": [],
"entities": [],
"related_topics": [],
"faq": [],
"related_products": [],
"related_collections": [],
"commercial_info": [],
"geo_score": "0.00",
"source_content_hash": "",
"created_at": "2026-08-20 00:23:20",
"updated_at": "2026-08-20 00:23:20"
}
],
"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 | 总页数 |
注意事项
page_ids支持数组与逗号分隔字符串两种传法- 一个页面只允许存在一份 GEO 数据(按
page_id唯一)