Skip to main content
POST
技术摘要

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
technology_paths
string[]
必填

目标技术路径,必填字段(如果未指定 groups、technologies 和 categories)。每条技术路径应指定为一个单独对象,其中包含“path”和“name”;“path”应指定为“$group_id.$category_id”,“name”应为目标技术的名称;每个技术路径对象之间应使用逗号分隔。你可以在此页面查看技术组 ID、类别 ID 和技术名称的完整列表。注意:此数组中最多可以指定 10 条技术路径。示例:[{"path": "content.cms","name": "wordpress"}, {"path": "marketing.crm","name": "salesforce"}]

groups
string[]
必填

目标技术组的 ids;必填字段。如果未指定 technologies、technology_paths、categories 或 keywords,您可以在此页面查找完整的技术组 ids 列表;注意:此数组最多可指定 10 个技术组;示例:["sales", "marketing"]

categories
string[]
必填

目标技术类别的 id;如果未指定 groups、technology_paths、technologies 或 keywords,则此字段为必填字段;可以在此页面查看完整的技术类别 id 列表;注意:此数组中最多可以指定 10 个技术类别;示例:["payment_processors","crm"]

technologies
string[]
必填

目标技术 如果未指定 groups、technology_paths、categories 或 keywords,则为必填字段 您可以在此页面查看可指定的完整技术列表 注意:此数组中最多可指定 10 项技术 示例:["Google Pay","Salesforce"]

keywords
string[]
必填

域名标题、描述或 meta keywords 中的目标关键词;如果未指定 groups、technology_paths、categories 或 technologies,则为必填字段。最多可指定 10 个关键词;采用 UTF-8 编码;示例:["seo","software"]。有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制,请参阅这篇帮助中心文章

mode
string

搜索模式;可选字段。可用的搜索模式类型:as_is – 搜索与指定的组 ID、类别 ID 或技术名称完全匹配的结果;entry – 搜索与指定的组 ID、类别 ID 或技术名称部分匹配的结果。默认值:as_is

filters
string[]

结果筛选参数数组,可选字段。可以同时添加多个筛选条件(最多 8 个),条件之间应设置逻辑运算符 and、or。支持以下运算符:, , >, >=, =, , in, not_in, like,not_like。可以将 % 运算符与 like 和 not_like 搭配使用,以匹配包含零个或多个字符的任意字符串。可以使用以下参数筛选结果:domain_rank, last_visited, country_iso_code, language_code, content_language_code。示例:[["country_iso_code","=","US"], "and", ["domain_rank",">",800]]。有关筛选条件的更多信息,请参阅 Domain Analytics Technologies API – Filters

internal_list_limit
integer

内部数组中的最大元素数,可选字段。您可以使用此字段限制以下数组中的元素数量:countries、languages、content_languages、keywords。默认值:10;最小值:1;最大值:10000

tag
string

用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值

响应

成功响应

version
string

API 的当前版本

status_code
integer

通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况

status_message
string

常规信息消息;可在此处查看常规信息消息的完整列表

time
string

执行时间(秒)

cost
number

任务总成本(美元)

tasks_count
integer

tasks 数组中的任务数量

tasks_error
integer

返回错误的 tasks 数组中的任务数量

tasks
string[]

任务数组

tasks.id
string

任务标识符,系统中采用 UUID 格式的唯一任务标识符

tasks.status_code
integer

DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看

tasks.status_message
string

任务的信息性消息,你可以在此处查看通用信息性消息的完整列表

tasks.time
string

执行时间(秒)

tasks.cost
number

任务成本(美元)

tasks.result_count
integer

结果数组中的元素数量

tasks.path
string[]

URL 路径

tasks.data
object

包含您在 POST 请求中指定的相同参数

tasks.result
string[]

结果数组

tasks.result.countries
object

网站按国家/地区的分布,包含国家/地区代码以及每个国家/地区的网站数量

tasks.result.languages
object

按语言划分的网站分布,包含语言代码及每种语言对应的网站数量

tasks.result.content_languages
object

按内容语言划分的网站分布,包含内容语言代码及每种语言的网站数量

tasks.result.keywords
object

网站按关键词的分布,包含在网站标题、描述或 meta keywords 中发现的关键词,以及使用每个关键词的网站数量