Skip to main content
POST
设置实时“基于 URL 的 Bing Ads 关键词建议”任务
此端点根据给定网页 URL 的内容提供关键词建议。它会分析页面并返回相关关键词列表,以及表示该关键词与用户搜索查询匹配概率的置信度分数。

示例

第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

费用与请求规则

公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.09
  • 计费依据: response_usd
  • 公开参考倍率: 1.0
  • 结算证据来源: response_body

授权

Authorization
string
header
必填

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

请求体

application/json
target
string
必填

要扫描潜在关键词的目标网页 URL,必填字段,最大长度:2000 个字符

language_name
string
必填

Full name of the search engine language. Required if language_code is not supplied; either language_name or language_code is sufficient.

language_code
string

搜索引擎语言代码;如果未指定 language_name,则为必填字段。如果使用此字段,则无需指定 language_name。您可以通过向 https://api.dataforseo.com/v3/keywords_data/bing/keyword_suggestions_for_url/languages 单独发送请求,获取包含 language_code 的可用语言列表。示例:en

exclude_brands
boolean

确定结果是否排除品牌关键词,可选字段

响应

成功响应

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.keyword
string

建议的关键词

tasks.result.confidence_score
number

介于 0.0 和 1.0 之间的分数,表示该关键词与用户搜索查询匹配的概率