Web 数据 · DomScan 产品

统一 URL 情报 API 参考

从 URL 提取规范化页面元数据、预览字段、结构化数据和公开身份信号。

你将获得什么

从 URL 提取规范化页面元数据、预览字段、结构化数据和公开身份信号。

同步批量RESTMCPSDK

适合选择此产品的场景

适用对象

当产品或工作流需要结构化响应中的当前公开页面证据时,使用专用 API。

适合选择此产品的场景

在深入收集前需要规范化 URL 结构和面向风险的 URL 信号时选择。

你将获得什么

从 URL 提取规范化页面元数据、预览字段、结构化数据和公开身份信号。

端点

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

GET /v1/url-intelligence 查看 API 参考
POST /v1/url-intelligence/bulk 查看 API 参考

积分和身份验证

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

操作示例

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

GET /v1/url-intelligence

查询参数

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

响应字段

字段 类型
requested_url string
final_url string
status integer
fetch_state string
content_type string | null
redirects integer
title string | null
description string | null
canonical_url string | null
language string | null
favicon_url string | null
preview_image_url string | null
manifest_url string | null
theme_color string | null
open_graph object
twitter_card object
structured_data object
structured_data.types[] string[]
structured_data.items integer
structured_data.parse_errors integer
robots object
robots.meta[] string[]
robots.header[] string[]
robots.indexable boolean | null
security_headers object
links object
links.total integer
links.internal integer
links.external integer
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
contacts object
contacts.emails[] string[]
contacts.phones[] 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/url-intelligence?url=https%3A%2F%2Fexample.com&skip_cache=1"

响应示例

{
  "requested_url": "https://example.com",
  "final_url": "https://example.com",
  "status": 1,
  "fetch_state": "ok",
  "open_graph": {},
  "twitter_card": {},
  "structured_data": {
    "types": [
      "example"
    ],
    "items": 1,
    "parse_errors": 1
  },
  "robots": {
    "meta": [
      "example"
    ],
    "header": [
      "example"
    ],
    "indexable": false
  },
  "links": {
    "total": 1,
    "internal": 1,
    "external": 1
  },
  "social_profiles": [
    {
      "platform": "github",
      "type": "social",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high",
      "handle": "example"
    }
  ],
  "contacts": {
    "emails": [
      "[email protected]",
      "[email protected]"
    ],
    "phones": [
      "example"
    ]
  },
  "meta": {
    "checked_at": "2026-08-27T12:00:00Z",
    "cached": false,
    "fetch_transport": "worker",
    "fetch_error": "timeout"
  },
  "content_type": "domain",
  "redirects": 1,
  "title": "example",
  "description": "example",
  "canonical_url": "https://example.com",
  "language": "en",
  "favicon_url": "https://example.com",
  "preview_image_url": "https://example.com",
  "manifest_url": "https://example.com",
  "theme_color": "example",
  "security_headers": {}
}

限制和证据边界

结果描述观测到的公开证据及其来源。
批量操作会处理多个受支持的输入,同时保留文档化的逐项结果。
部分表示部分请求项目或组件已完成,而其他项目或组件未完成。
已缓存表示使用了存储的证据;如有新鲜度元数据,请一并查看。
证据可能随时间变化;如有提供,请使用时间戳和新鲜度字段。
产品仅评估公开输入和可公开观测的证据。

审核日期:2026-08-22

常见问题

在哪里可以找到 统一 URL 情报 的请求和响应参考?

使用 统一 URL 情报 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

应如何解读 统一 URL 情报 返回的未知或不完整结果?

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

统一 URL 情报 如何计费?

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