网站标题与图标 API：URL 输入、空字段与返回边界

GuGuData 网站标题与图标 API 使用 GET 提交公开网页 URL，返回 Title 和 Favicon 两个字符串。只取得标题或只取得有效图标也可以成功；未取得的一项为空字符串，两项均不可用时返回失败。适合书签、导航目录和链接卡片整理，不保证任意站点都能访问。

接口与输入

项目	说明
请求方法	GET
接口地址	`https://api.gugudata.com/websitetools/favicon`
返回格式	JSON，UTF-8
鉴权	对应产品有效 AppKey；下方示例使用 Header

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	无	已开通本商品的 APPKEY；也可使用现有 Header 或 Bearer 鉴权，不同时要求多个载体。
url	string	是	无	公开网页地址，兼容现有可安全归一化的裸域名表达。

参数名和大小写按契约传递。鉴权凭据可以通过 Header 提供，不需要在公开 URL 中放入真实 AppKey。

请求示例

以下为集成示例，未使用真实凭据执行。YOUR_APPKEY 是占位符，正式调用需要对应产品权益。GET 参数由 --data-urlencode 分别编码。

bash 复制代码

curl --get 'https://api.gugudata.com/websitetools/favicon' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'url=https://www.gugudata.com/'

返回字段

参数名	参数类型	备注
DataStatus.RequestParameter	string	本次真实可读业务参数，不含凭据；Demo 对应实际样例输入。
DataStatus.StatusCode	integer	100 成功；参数、依赖及公共鉴权错误见状态码说明。
DataStatus.StatusDescription	string	业务处理结果说明。
DataStatus.ResponseDateTime	string	响应生成时间，不代表数据源更新时间。
DataStatus.DataTotalCount	integer	成功为 1，表示一个结果对象。
Data.Title	string	实际网页标题，保留 Unicode 并解码 HTML 实体；未取得时为空字符串。
Data.Favicon	string	页面实际可用的图标地址；未取得时为空字符串。

公开 Demo 样本

2026 年 11 月 6 日回读了对应公开 Demo。公开 Demo 的输入为 https://www.gugudata.com/，下方是本次实际返回的两个业务字段。

json 复制代码

{
  "DataStatus": {
    "StatusCode": 100
  },
  "Data": {
    "Title": "咕咕数据 | 专业的数据提供商",
    "Favicon": "https://www.gugudata.com/static-assets/favicon-96x96.72cdf49adc48918ee23e.png"
  }
}

公开 Demo 是样本结构证据，不代表上方带占位符的生产请求已经执行，不用于推断固定性能、完整覆盖范围或长期有效性。

字段解释与使用边界

建议提交完整 HTTPS URL。历史裸域名输入按既有规则补 http://，不要据此假定自动优先使用 HTTPS。图标可能来自相对地址解析，返回的是可用资源 URL，不是图像字节；页面更新后地址可能变化。Title 应按普通文本展示，不拼接为可信 HTML。空 Favicon 时可使用业务自己的占位图，不能把空字段误判成接口完全失败。DataTotalCount=1 表示一个结果对象，不是图标数量或分页总数。

错误与结果核对

先检查 HTTP 状态，再检查 DataStatus.StatusCode，业务成功值为 100。字段大小写应保留，不能将其他产品的成功码直接套用。参数、鉴权、权益、额度、限流和依赖失败应分别处理；错误码、限额与价格按当前文档及订单核对，不能将业务状态码全部当作 HTTP 状态码。

读取状态成功后，再分别判断标题和图标是否非空。遇到鉴权、限流或依赖失败应明确提示或重试，不伪装成已取得空白站点资料。

参考文档

本文由 GuGuData 产品方整理，接口契约核对日期为 2026 年 11 月 6 日。