# 按 HTML 词条查找域名 **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/domain_analytics/technologies/domains_by_html_terms/live` **Tags:** DataForSEO 查找 HTML 中包含给定 `search_terms` 的域名——这里是原始字符串匹配，而 `post_dataforseo_domains_tech_domains_by_technology_live` 匹配的是检测到的技术。适用于没有任何检测器能识别的跟踪代码片段、联盟标签或模板特征。返回 `total_count`、`items_count`、`offset`、`offset_token` 和 `items`，每项携带与技术搜索相同的资料。 ### 计费参考 - 计量方式：按上报的响应成本计量。 - 参考请求估算：0.012 美元。 - 参考客户倍率：1.0。不得对已结算的客户金额再次应用。 仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。 ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "search_terms": { "type": "array", "items": { "type": "string" }, "description": "目标搜索词
必填字段
指定目标 HTML 元素、标签、属性、其内容或以上全部
如果指定多个搜索词，则只会返回首页 HTML 代码中包含所有指定词的域名
可指定的搜索词数量上限：10
示例：
[\"data-attrid\"]" }, "keywords": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "域名标题、描述或元关键词中的目标关键词
可选字段
UTF-8 编码
可指定的关键词数量上限：10
示例：
[\"seo\",\"software\"]

有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅这篇 帮助中心文章" }, "mode": { "type": [ "string", "null" ], "description": "搜索模式
可选字段
可能的搜索模式类型：
strict_entry - 按指定搜索词中的顺序、间隔和分隔符精确匹配结果
entry - 忽略指定搜索词中的顺序、间隔和分隔符进行匹配
默认值：entry" }, "filters": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ] }, "description": "结果筛选参数数组
可选字段
可同时添加多个筛选条件（最多 8 个）
应在条件之间设置逻辑运算符 and、or
支持以下运算符：
<、<=、>、>=、=、<>、in、not_in、like、not_like
可在 like 和 not_like 中使用 % 运算符，匹配任意长度（零个或多个字符）的字符串
示例：
[\"domain\",\"like\",\"%seo%\"]

[[\"country_iso_code\",\"=\",\"US\"],
\"and\",
[\"domain_rank\",\">\",100]]

[[\"domain_rank\",\">\",100],
\"and\",
[[\"country_iso_code\",\"=\",\"US\"],\"or\",[\"country_iso_code\",\"=\",\"CA\"]]]

有关筛选条件的更多信息，请参阅 Domain Analytics Technologies API - 筛选条件" }, "order_by": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "结果排序规则
可选字段
可用字段：
domain_rank、domain、last_visited、country_iso_code、language_code、content_language_code
可能的排序类型：
asc - 结果将按升序排列
desc - 结果将按降序排列
应使用逗号设置排序类型
示例：
[\"last_visited,desc\"]
默认规则：
[\"domain_rank,desc\"]
注意，单次请求中最多可设置三条排序规则
应使用逗号分隔多条排序规则
示例：
[\"last_visited,desc\",\"domain_rank,desc\"]" }, "limit": { "type": [ "integer", "null" ], "description": "返回的域名数量上限
可选字段
默认值：100
最大值：10000" }, "offset": { "type": [ "integer", "null" ], "description": "返回域名在结果数组中的偏移量
可选字段
默认值：0
如果指定值 10，结果数组中的前十个域名将被省略，数据将从后续域名开始提供；
注意：最大值为 9999，limit 与 offset 之和不得超过 10000；
如需偏移更多结果，请使用 offset_token" }, "offset_token": { "type": [ "string", "null" ], "description": "用于后续请求的令牌
可选字段
在每次请求响应的同名字段中提供；
使用此参数可在单次请求尝试获取超过 100,000 条结果时避免超时；
通过指定响应数组中的唯一 offset_token 值，你将获得初始任务的后续结果；
offset_token 值对每个后续任务都是唯一的
注意：如果请求中指定了 offset_token，所有其他参数都应与此前的请求保持一致
有关此参数的更多信息，请参阅我们的 帮助中心" } }, "example": [ { "search_terms": [ "data-attrid" ], "order_by": [ "last_visited,desc" ], "limit": 10, "offset": 0 } ] } ] }, "example": [ { "search_terms": [ "data-attrid" ], "order_by": [ "last_visited,desc" ], "limit": 10, "offset": 0 } ] } ``` ## Responses ### 200 — 操作成功 Headers: - `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。 **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo" } ] } ``` ### 400 — 无法处理该请求。请检查请求参数。 ### 401 — 需要有效的 Felo API 密钥。 ### 402 — 由于未满足计费要求，请求无法继续。 ### 403 — 该账户无权执行此操作。 ### 429 — 已达到请求或支出限额。 ### 502 — 服务无法完成该请求。 ### 503 — API 或计费服务暂时不可用。 ### 504 — 服务在处理请求时超时。 ### default — 错误响应；上游透传响应可能采用提供方格式 **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "API 的当前版本" }, "status_code": { "type": [ "integer", "null" ], "description": "通用状态码\n完整响应码列表见此处" }, "status_message": { "type": [ "string", "null" ], "description": "通用信息性消息\n完整的一般信息性消息列表见此处" }, "time": { "type": [ "string", "null" ], "description": "总执行时间，秒" }, "cost": { "type": [ "number", "null" ], "description": "任务总费用，美元", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "tasks 数组中的任务数", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "tasks 数组中返回错误的任务数", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "任务标识符\n我们系统中 UUID 格式的唯一任务标识符" }, "status_code": { "type": [ "integer", "null" ], "description": "任务的状态码\n由 DataForSEO 生成，范围如下：10000-60000\n完整响应码列表见此处" }, "status_message": { "type": [ "string", "null" ], "description": "任务的信息性消息\n完整的一般信息性消息列表见此处" }, "time": { "type": [ "string", "null" ], "description": "执行时间，秒" }, "cost": { "type": [ "number", "null" ], "description": "任务总费用，美元", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "result 数组中的元素数", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL 路径" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "包含你在 POST 请求中指定的相同参数" } } } ``` ### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo `#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo" } ] }, "description": "任务数组" } } } ] } ``` ### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo `#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo` ```json { "type": "object", "properties": { "total_count": { "type": [ "integer", "null" ], "description": "数据库中相关条目的总数", "format": "int64" }, "items_count": { "type": [ "integer", "null" ], "description": "结果数组中的条目数", "format": "int64" }, "offset": { "type": [ "integer", "null" ], "description": "指定的偏移值" }, "offset_token": { "type": [ "string", "null" ], "description": "后续请求的令牌
在设置新任务时指定唯一的 offset_token，即可获取初始任务的后续结果；
offset_token 值对每个后续任务都是唯一的" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByLiveItem" } ] }, "description": "条目数组" } } } ``` ### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo `#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo" } ] }, "description": "结果数组" } } } ] } ``` ### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByLiveItem `#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByLiveItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "元素类型" }, "domain": { "type": [ "string", "null" ], "description": "指定的域名" }, "title": { "type": [ "string", "null" ], "description": "域名元标题" }, "description": { "type": [ "string", "null" ], "description": "域名元描述" }, "meta_keywords": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "域名元关键词" }, "domain_rank": { "type": [ "integer", "null" ], "description": "目标域名的反向链接排名
如需了解该指标及其计算方式，请参阅此帮助中心文章" }, "last_visited": { "type": [ "string", "null" ], "description": "我们的爬虫最近访问该域名的日期
采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
示例：
2022-10-10 12:57:46 +00:00" }, "country_iso_code": { "type": [ "string", "null" ], "description": "域名 ISO 代码
目标域名被判定所属国家的 ISO 代码" }, "language_code": { "type": [ "string", "null" ], "description": "域名语言
目标域名被判定关联的语言代码" }, "content_language_code": { "type": [ "string", "null" ], "description": "内容语言
目标域名上内容所用的语言代码" }, "phone_numbers": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "目标的电话号码
目标网站上显示的联系电话" }, "emails": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "目标的电子邮箱
目标网站上显示的电子邮箱" }, "social_graph_urls": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "社交媒体链接和账号
目标网站社交图谱中检测到的社交媒体 URL" }, "technologies": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_TechnologiesInfo" } ], "description": "目标域名使用的技术
包含网站上所用技术名称的对象；
如需获取技术及其结构的完整列表，请参阅 technologies 端点" } }, "description": "条目数组" } ``` ### Response36Afe1097B20_TechnologiesInfo `#/components/schemas/Response36Afe1097B20_TechnologiesInfo` ```json { "type": "object", "properties": { "add_ons": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "analytics": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "web_development": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "security": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "business_tools": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "sales": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "other": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "user_generated_content": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "booking": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "privacy": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "servers": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "location": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "content": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "media": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "marketing": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "communication": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } }, "utilities": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } } } } ```