serp

Appearance

answer_box 字段说明 ​

1 . text 类型 ​

当 type 为 text 时，表示回答框内容为一段简短的直接回答，常见于日期、数字、地点、人物等事实类问题，形式上就是一段话的答案。

Logo

字段名说明
answer直接回答的文本内容
facts相关事实信息，键值对对象形式（用于补充结构化信息）
people_also_search_for相关人物或主题的补充信息，字符串数组（如“名称\n关键信息”）
rank当前模块在自然搜索列表中的排名位置，整数，越小越靠前
reference参考链接列表，数组形式，每项为一个对象
├─ display_link展示用域名路径
├─ link参考内容的网页链接地址
├─ snippet参考内容的简短摘要
├─ source参考内容来源网站名称
└─ title参考内容页面的标题
snippet回答框下方展示的简短摘要
title回答框的标题（如“主题 › 属性”）
type回答框类型，此案例为 text

测试用例 ​

bash
curl -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 'https://api.serp.hk/serp/google/search/basic' -X POST -d '{"q":"牛顿生日"}' --compressed

返回结果 ​

json
{
  "answer": "1643 年 1 月 4 日",
  "facts": {
    "出生地": "英国",
    "逝世年龄": "84 岁",
    "逝世日期": "1727 年 3 月 31 日"
  },
  "people_also_search_for": [
    "阿尔伯特·爱因斯坦\n1879 年 3 月 14 日",
    "伽利略·伽利莱\n1564 年 2 月 15 日",
    "约翰内斯·开普勒\n1571 年 12 月 27 日"
  ],
  "rank": 1,
  "reference": [
    {
      "display_link": "http://www.ipc.cas.cn › 科学传播",
      "link": "http://www.ipc.cas.cn/kxcb/kxpj/201811/t20181118_5185835.html",
      "source": "中国科学院理化技术研究所",
      "title": "历法的进步——从牛顿的生日谈起 - 中国科学院理化技术研究所"
    }
  ],
  "snippet": "按照现在国际通行的历法——格里高利历，牛顿的出生日是1643年1月4日。",
  "title": "艾萨克·牛顿 › 出生日期",
  "type": "text"
}

2 . scorecard 类型 ​

当 type 为 scorecard 时，表示回答框内容为结构化表格形式，常用于展示比分、统计数据或排行榜等内容，每行表示一个记录或条目。

Logo

字段名说明
answer直接回答的文本内容（通常为总数或关键数值，如总分）
rank当前模块在自然搜索列表中的排名位置，整数，越小越靠前
reference参考链接列表，数组形式，每项为一个对象
├─ display_link展示用域名或路径
├─ link参考内容的网页链接地址
├─ snippet参考内容的简短摘要
├─ source参考内容来源网站名称
└─ title参考内容页面的标题
table表格内容数组，每项为一个对象键值对，表示一行记录
title回答框的标题（如“Scorecard”）
type回答框类型，此案例为 scorecard

测试用例 ​

bash
curl -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 'https://api.serp.hk/serp/google/search/basic' -X POST -d '{"q":"MS Dhoni balls faced in World Cup 2011 final"}' --compressed

返回结果 ​

json
{
    "rank": 1,
    "reference": [
      {
        "display_link": "https://en.wikipedia.org › wiki › 2011_Cricket_World_...",
        "link": "https://en.wikipedia.org/wiki/2011_Cricket_World_Cup_final",
        "source": "Wikipedia",
        "title": "2011 Cricket World Cup final - Wikipedia"
      }
    ],
    "table": [
      {
        "info": "Indian Batting"
      },
      {
        "Balls": "122",
        "Player": "Gautam Gambhir",
        "Status": "b Perera"
      },
      {
        "Balls": "49",
        "Player": "Virat Kohli",
        "Status": "c \u0026 b Dilshan"
      },
      {
        "Balls": "79",
        "Player": "Mahendra Singh Dhoni",
        "Status": "not out"
      }
    ],
    "title": "Scorecard",
    "type": "scorecard"
  }

3 . finance 类型 ​

当 type 为 finance 时，表示回答框内容为结构化金融信息表格，常用于展示股票行情、价格变动、财务数据等，每行表示一个指标或记录。

Logo

字段名说明
answer直接回答的文本内容（通常为关键价格或总览信息）
rank当前模块在自然搜索列表中的排名位置，整数，越小越靠前
reference参考链接列表，数组形式，每项为一个对象
├─ display_link展示用域名或路径
├─ link参考内容的网页链接地址
├─ snippet参考内容的简短摘要
├─ source参考内容来源网站名称
└─ title参考内容页面的标题
currency货币单位（如 USD、CNY 等）
exchange交易所名称（如 NASDAQ、NYSE）
market市场行情对象，包含当前日期、价格、价格变动及状态等信息
├─ date数据时间戳（如“8月22日 GMT-4 下午7:59”）
├─ price当前市场价格
├─ price_movment盘后价格变动对象，包括方向、百分比和绝对值
│ ├─ movement涨跌方向（Up / Down）
│ ├─ percentage涨跌百分比
│ └─ price盘后价
└─ trending当前价格类型（如“盘后价”）
previous_close昨日收盘价
price当前价格（可能与 market.price 相同或略有差异）
price_movement当前价格变动对象（类似 market.price_movment，但可针对当天）
stock股票代码（如 NVDA）
table表格内容数组，每项为一个对象，表示一个财务指标或行情数据行
├─ name指标名称（如“开盘”、“最高”、“市盈率”）
└─ value指标对应的数值（字符串形式，可能带单位）
title回答框标题（通常为公司名称或股票名称，如“英伟达”）
type回答框类型，此案例为 finance

测试用例 ​

bash
curl -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 'https://api.serp.hk/serp/google/search/basic' -X POST -d '{"q":"nvidia stock"}' --compressed

返回结果 ​

json
{
    "currency": "USD",
    "exchange": "NASDAQ",
    "market": {
      "date": "8月27日 GMT-4 上午12:17",
      "price": 182.35,
      "price_movment": {
        "movement": "Up",
        "percentage": 0.32,
        "price": 0.58
      },
      "trending": "盘后价"
    },
    "previous_close": 179.81,
    "price": 181.77,
    "price_movement": {
      "date": "今天",
      "movement": "Up",
      "percentage": 1.09,
      "price": 1.96
    },
    "rank": 1,
    "stock": "NVDA",
    "table": [
      {
        "name": "开盘",
        "value": "180.06"
      },
      {
        "name": "最高",
        "value": "182.39"
      },
      {
        "name": "最低",
        "value": "178.81"
      },
      {
        "name": "市值",
        "value": "4.39万亿"
      },
      {
        "name": "市盈率",
        "value": "58.55"
      },
      {
        "name": "股息收益率",
        "value": "0.022%"
      },
      {
        "name": "52 周高点",
        "value": "184.48"
      },
      {
        "name": "52 周低点",
        "value": "86.63"
      }, 
      {
        "name": "季度分红金额",
        "value": "0.010"
      }
    ],
    "title": "英伟达",
    "type": "finance"
  }

4 . time 类型 ​

当 type 为 time 时，表示回答框内容为 当前时间信息，通常包含：具体时间（时:分）、日期（星期几 + 月份 + 日期 + 年份 + 时区）、所在城市或地区

Logo

字段名说明
answer直接回答的核心内容，这里为当前时间（时:分）
rank回答在当前搜索结果中的出现顺序
snippet附加的时间信息，通常包含完整日期、时区、地点等，可能会有多行，用换行符 \n 分隔
type回答框类型，此案例为 time

测试用例 ​

bash
curl -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 'https://api.serp.hk/serp/google/search/basic' -X POST -d '{"q":"北京时间"}' --compressed

返回结果 ​

json
  {
    "answer": "11:34",
    "rank": 1,
    "snippet": "2025年9月17日（星期三）   (GMT+8)\n中国北京市的时间",
    "type": "time"
  }