用户数据

接口概述

GET /v3/appendix/user_data

调用本接口可获取当前账户的详细信息：

• API 使用
• 调用频率与限额
• 消费与余额
• 各功能价格信息
• 订到期时间
• 账户基础信息（如登录名、时区）

计费说明

调用本接口不收费。

响应中的顶层 cost 通常为 0，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求地址

GET https://api.seermartech.cn/v3/appendix/user_data

认证方式

请在请求头中使用 Bearer Token：

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

请求参数

本接口为 GET 请求，无请求体。

响应结构

接口返回 JSON 数据，顶层 tasks 数组，每个任务对象中结果。

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码
status_message	string	通用状态信息
time	string	总执行时间，单位秒
cost	float	本次请求总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务结果数组

完整错误码与状态信息可参考 /v3/appendix/errors。建议在接时做好异常与错误处理。

tasks[] 字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000
status_message	string	任务状态说明
time	string	当前任务执行时间，单位秒
cost	float	当前任务费用，单位 USD
result_count	integer	result 数组中的数量
path	array	请求路径
data	array / object	GET 请求 URL 中传的参数
result	array	结果数组

result[] 字段

字段名	类型	说明
login	string	当前账户登录名
timezone	string	当前账户时区，可在个人资料设置中
rates	object	API 调用速率信息
statistics	object	API 调用统计信息
money	object	账户资金与消费信息，单位 USD
price	object	各接口价格
backlinks_subscription_expiry_date	string / null	外链数据订到期时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00；若无有效订则为 null
llm_mentions_subscription_expiry_date	string / null	LLM Mentions 订到期时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00；若无有效订则为 null

---

结果对象详解

rates

返回当前账户在不同时间维度下的调用限额。

结构说明

字段名	类型	说明
$type_of_grouping	object	分组类型，可为 day、minute
$func_name	object	功能名称
$func_type	object	功能类型，部分可能为整数键名
$func_name	integer	某一功能的调用上限
total_$func_name	integer	某类功能的总调用上限

statistics

返回 API 调用统计，按时间维度聚合。

结构说明

字段名	类型	说明
$type_of_grouping	object	分组类型，可为 day、minute
$func_name	object	功能名称
$func_type	object	功能类型，部分可能为整数键名
$func_name	integer	某一功能的调用次数
total_$func_name	integer	某类功能的总调用次数
value	string	分组时间值；day 格式为 yyyy-MM-dd，minute 格式为 yyyy-MM-dd HH:mm

money

返回账户、余额、消费限额和消费统计。

字段说明

字段名	类型	说明
total	float	账户累计金额，单位 USD
balance	float	当前账户余额，单位 USD
limits	object	消费限额
statistics	object	消费统计，单位 USD

money.limits / money.statistics 通用结构

字段名	类型	说明
$type_of_grouping	object	分组类型，可为 day、minute
$func_name	object	功能名称
$func_type	object	功能类型，部分可能为整数键名
$func_name	integer	某一功能的消费限额或消费金额
total_$func_name	integer	某类功能的总消费限额或总消费金额
value	string	分组时间值；day 格式为 yyyy-MM-dd，minute 格式为 yyyy-MM-dd HH:mm

price

返回各产品线、功能类型、优级对应的价格。

字段说明

字段名	类型	说明
$api_name	object	上层 API 分组
$func_type	object	功能类型，部分可能为整数键名
$func_name	object	功能名称
$priority	object	任务优级，可为 priority_normal、priority_high
cost_type	string	计费方式
cost	float	单价，单位 USD

cost_type 取值

值	说明
per_result	按 result 数组中每一行结果计费
per_request	按每次 GET 或 POST 请求计费

---

代码示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/appendix/user_data" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

url = "https://api.seermartech.cn/v3/appendix/user_data"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
result = response.json

if result.get("status_code") == 20000:
 print(result)
 # 在这里处理账户数据
else:
 print(f"error. Code: {result.get('status_code')} Message: {result.get('status_message')}")

TypeScript

import axios from "axios";

axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/appendix/user_data",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 const result = response.data;
 // 在这里处理返回数据
 console.log(result);
 })
 .catch((error) => {
 console.error(error);
 });

---

响应示例

说明：原始示例中的 price 对象大量动态键名与产品模块，非常长。以下示例保留了接口的核心结构，便于理解返回格式。真实返回中会更多 API 分组、功能名称、优级与价格项。

{
 "version": "0.1.20250526",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1656 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "6d8d8d52-5c8d-4a6a-9f2f-1234567890ab",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1201 sec.",
 "cost": 0,
 "result_count": 1,
 "path": [
 "v3",
 "appendix",
 "user_data"
 ],
 "data": {
 "api": "appendix",
 "function": "user_data"
 },
 "result": [
 {
 "login": "your_login",
 "timezone": "UTC",
 "rates": {
 "day": {},
 "minute": {}
 },
 "statistics": {
 "day": [],
 "minute": []
 },
 "money": {
 "total": 1000,
 "balance": 850.25,
 "limits": {
 "day": {},
 "minute": {}
 },
 "statistics": {
 "day": [],
 "minute": []
 }
 },
 "price": {
 "appendix": {
 "user_data": {
 "priority_normal": {
 "cost_type": "per_request",
 "cost": 0
 },
 "priority_high": {
 "cost_type": "per_request",
 "cost": 0
 }
 }
 },
 "serp": {
 "live": {
 "regular": {
 "priority_normal": {
 "cost_type": "per_request",
 "cost": 0.002
 }
 }
 }
 }
 },
 "backlinks_subscription_expiry_date": "2050-01-01 00:00:00 +00:00",
 "llm_mentions_subscription_expiry_date": "2026-02-28 14:01:38 +00:00"
 }
 ]
 }
 ]
}

---

使用说明

1. 调用本接口获取当前账户与使用状态。
2. 重点以下字段：

• money.balance：当前余额
• money.statistics：消费明细与聚合统计
• rates：调用限额
• statistics：接口调用次数
• price：各功能价格
• backlinks_subscription_expiry_date：外链数据订到期时间
• llm_mentions_subscription_expiry_date：LLM Mentions 订到期时间

3. 若需计算单次接口的人民币参考价格，可按以下换算：
   • 人民币参考价以响应头 X-SeerMarTech-Charge-CNY 为准

• 例如某接口单价 0.002 USD，参考价约 ¥0.0320 / 次

4. 实计费请始终以接口响应中的 cost 字段为准。

错误处理建议

• 顶层 status_code 不为 20000 时，表示本次请求未成功。
• 即使顶层成功，也建议逐项检查 tasks[].status_code。
• 对于动态结构字段（如 price、rates、statistics），建议使用可递归解析的方式处理对象层级，写死字段路径。
• 由于该接口返回可能较大，建议在系统中做好：
• 响应缓存
• 字段容处理
• 空值判断（是订到期时间可能为 null）

实用场景

• 监控账户余额：定时拉取 money.balance，在余额不足前预警， SEO 任务因欠费中断。
• 核对接口成本：读取 price 与响应 cost，建立成本台账，便于项目报价和毛利分析。
• 控制调用频率：结合 rates 与 statistics 识别分钟级或天级限额，防止批量任务触发频控。
• 审计团队使用：按时间维度分析 statistics 和 money.statistics，判断哪些接口使用最频繁、消耗最高。
• 管理订续费：跟踪 backlinks_subscription_expiry_date 与 llm_mentions_subscription_expiry_date，提前安排续费，数据服务到期。