高性能索引架构 · TB 级数据毫秒级检索 · 双节点全球加速
支持多关键词联合过滤，自动建立行号索引，提供双节点接入方案。
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
cx |
是 | String | 检索词，多个条件用英文逗号分隔 |
key |
是 | String | 您的 Access Key |
page |
否 | Int | 页码，默认 1 |
limit |
否 | Int | 每页记录数，默认 100，最大 500 |
1. 单条件精准查询
通过手机号、姓名或身份证号快速定位。
2. 多条件过滤（AND 逻辑）
用英文逗号分隔多个关键词，结果同时包含所有词。
3. 分页控制
通过 page 和 limit 调整返回范围。
xg_msg 表示查询命中层级：
| 状态码 | 类型 | 说明 | 参考耗时 |
|---|---|---|---|
| xg_002 | 数据缓存 | 一级缓存命中，直接读取 JSON 结果 | < 20ms |
| xg_003 | 行号索引 | 二级缓存命中，精准定位文件内容 | 100～300ms |
| xg_err | 请求错误 | 详见返回的错误信息 | - |
| xg_000_A3 | 单条件索引 | 手机号/姓名索引直接命中 | < 50ms |
| xg_000_A3_MULTI | 多条件索引 | 多关键词先索引后过滤 | < 100ms |
{
"xg_msg": "xg_002",
"total_count": 150,
"current_page": 1,
"total_pages": 15,
"remaining_pages": 14,
"user": "XG_test",
"expiry": "2099-12-31",
"query_time_ms": 18.5,
"data": [
{
"name": "刘**",
"phone": "138****8888",
"school": "**市**小学",
"id_card": "120101********1234",
"email": "liu@example.com",
"id_num": "2024001"
}
]
}
import requests
def search(api_key="Your_Key"):
api_url = "https://xgapi.xg66.top/api"
cx = input("输入检索词（逗号分隔）：").strip()
params = {"cx": cx, "key": api_key, "page": 1, "limit": 10}
try:
resp = requests.get(api_url, params=params, timeout=15)
res = resp.json()
print(f"状态: {res['xg_msg']} | 耗时: {res['query_time_ms']}ms | 总数: {res['total_count']}")
for item in res.get("data", []):
print(f" {item['name']} | {item['phone']} | {item['school']}")
except Exception as e:
print(f"请求失败: {e}")
if __name__ == "__main__":
search()