关键词洞察

凭借一组关键词,获取关联的推文数量以及 30 个相关的关键词集合。推文数量仅对应输入关键词,而不对应相关的关键词。

允许的最大时间范围 (end_time - start_time) 为 7 天。

请注意,结果的范围由单个地理位置(国家/地区)限定。

资源 URL

https://ads-api.twitter.com/8/insights/keywords/search

参数

名称 说明
granularity
必需

指定为 start_timeend_time 表示的时间范围返回的数据的粒度。例如,设置为 HOUR 时,你会看到 start_timeend_time 之间每小时的数据点。请求。

类型:enum

可能值:DAYHOUR

keywords
必需

以逗号分隔的关键词字串,用于缩小搜索范围。所有关键词之间都是“或”的关系。

注意:最多可使用 10 个关键词(keywordsnegative_keywords )。

类型:string

示例:developers

start_time
必需

将检索数据范围限定为 start_timeend_time 时间窗口间收集的数据。以 ISO 8601 表示。

类型:string

示例:2017-07-10T00:00:00Z

end_time
可选

将检索数据范围限定为 start_timeend_time 时间窗口间收集的数据。以 ISO 8601 表示。

注意:默认为当前时间。

类型:string

示例:2017-07-11T00:00:00Z

location
可选

你可从 GET targeting_criteria/locations 端点获取的定位值,用于根据账号用户所在位置缩小结果范围。请注意,目前仅支持国家/地区级别的位置。

类型:string

示例:0ce8b9a7b2742f7e

negative_keywords
可选

要排除的关键词字符串,以逗号分隔。所有否定关键词之间都是“或”的关系。

注意:最多可使用 10 个关键词(keywordsnegative_keywords )。

类型:string

示例:rain

请求示例

GET https://ads-api.twitter.com/8/insights/keywords/search?end_time=2018-02-02&granularity=DAY&keywords=developers&start_time=2018-02-01

响应示例

{
  "request": {
    "params": {
      "start_time": "2018-02-01T00:00:00Z",
      "end_time": "2018-02-02T00:00:00Z",
      "granularity": "DAY",
      "keywords": [
        "developers"
      ]
    }
  },
  "data": {
    "related_keywords": [
      "dev",
      "developer",
      "coders",
      "mysql",
      "devs",
      "#technology",
      "#developers",
      "security",
      "programmers",
      "#tech",
      "javascript",
      "#iot",
      "#bigdata",
      "cloud",
      "devops",
      "php",
      "developer",
      "programmer",
      "engineer",
      "big data",
      "agile",
      "app",
      "programming",
      "ios",
      "maker",
      "startups",
      "developer's",
      "java",
      "#devops",
      "startup"
    ],
    "tweet_volume": [
      15707
    ]
  }
}