身份与验证 · DomScan 产品

网站身份资产 API 参考

从公开网站提取有来源依据的徽标、网站图标、预览资源、主题颜色和声明的个人资料。

你将获得什么

从公开网站提取有来源依据的徽标、网站图标、预览资源、主题颜色和声明的个人资料。

同步批量RESTMCPSDK

适合选择此产品的场景

适用对象

用于改善表单处理、确定人工审查优先级、补充组织资料,并连接网站声明的资产。

适合选择此产品的场景

需要收集网站声明的公开身份资产,例如图标、资料和面向组织的链接时选择。

你将获得什么

从公开网站提取有来源依据的徽标、网站图标、预览资源、主题颜色和声明的个人资料。

端点

集成前,请查看支持的操作、输入、输出、执行模式和响应限制。

GET /v1/identity-assets 查看 API 参考
POST /v1/identity-assets/bulk 查看 API 参考

积分和身份验证

2 需要身份验证。有关确切费用和按项计费,请查看操作参考。

操作示例

使用文档化的操作来收集、评估、补充、验证、比较、保护或监测公开证据。

GET /v1/identity-assets

查询参数

参数 类型 必需
domain string 必需
skip_cache string
允许的值 1
可选

响应字段

字段 类型
domain string
website_url string
fetch_state string
organization_name string | null
assets object
assets.logo_url string | null
assets.logo_kind string | null
assets.logo_source string | null
assets.logo_verification string | null
assets.favicon_url string | null
assets.touch_icon_url string | null
assets.preview_image_url string | null
assets.manifest_url string | null
assets.theme_color string | null
assets.candidates[] object[]
assets.candidates[] object
assets.candidates[].url string
assets.candidates[].kind string
assets.candidates[].source string
assets.candidates[].type string | null
assets.candidates[].sizes string | null
assets.candidates[].score integer
assets.candidates[].confidence string
social_profiles[] object[]
social_profiles[] object
social_profiles[].platform string
social_profiles[].type string
social_profiles[].handle string | null
social_profiles[].url string
social_profiles[].source string
social_profiles[].confidence string
confidence number
evidence[] string[]
meta object
meta.checked_at string
meta.cached boolean
meta.fetch_transport string
meta.fetch_error string

请求示例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-assets?domain=example.com&skip_cache=1"

响应示例

{
  "domain": "example.com",
  "website_url": "https://example.com",
  "fetch_state": "ok",
  "assets": {
    "logo_url": "https://example.com",
    "logo_kind": "logo",
    "logo_source": "public_data",
    "logo_verification": "verified",
    "favicon_url": "https://example.com",
    "touch_icon_url": "https://example.com",
    "preview_image_url": "https://example.com",
    "manifest_url": "https://example.com",
    "theme_color": "example",
    "candidates": [
      {
        "url": "https://example.com",
        "kind": "example",
        "source": "public_data",
        "type": "domain",
        "sizes": "example",
        "score": 85,
        "confidence": "high"
      }
    ]
  },
  "social_profiles": [
    {
      "platform": "github",
      "type": "social",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high",
      "handle": "example"
    }
  ],
  "confidence": 0.85,
  "evidence": [
    "example"
  ],
  "meta": {
    "checked_at": "2026-08-27T12:00:00Z",
    "cached": false,
    "fetch_transport": "worker",
    "fetch_error": "timeout"
  },
  "organization_name": "example"
}

限制和证据边界

结果描述观测到的公开证据及其来源。
批量操作会处理多个受支持的输入,同时保留文档化的逐项结果。
覆盖范围受文档化输入、预算、来源和响应限制约束。
部分表示部分请求项目或组件已完成,而其他项目或组件未完成。
产品仅评估公开输入和可公开观测的证据。

审核日期:2026-08-22

常见问题

在哪里可以找到 网站身份资产 的请求和响应参考?

使用 网站身份资产 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

应如何解读 网站身份资产 返回的未知或不完整结果?

未知或部分结果表示无法完全确定所请求的证据。在后续决策中保留结果状态、置信度、新鲜度和限制信息。

网站身份资产 如何计费?

费用取决于操作和执行模式。有关当前积分费用、身份验证要求和按项规则,请查看端点参考。