キーワードインサイト

キーワードのグループを指定して、関連するツイートのボリュームと30個の関連キーワードセットを取得します。ツイートのボリュームは、入力キーワードにのみ対応し、関連キーワードには対応しません。

7日の最大時間範囲(end_time - start_time)が許可されます。

結果の範囲は1つの地域(国)に制限されます。

リソースURL

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

パラメーター

名前 説明
granularity
必須

start_timeおよびend_timeで示される時間範囲について返されるデータの詳細度を指定します。たとえば、HOURに設定すると、start_timeからend_timeまでの1時間ごとのデータポイントが表示されます。

タイプ: 列挙

使用可能な値: DAYHOUR

keywords
必須

検索を絞り込むためのキーワードで構成されるカンマ区切りの文字列。すべてのキーワードは互いに論理和(OR)で結ばれます。

: 最大10個のキーワード(keywordsnegative_keywordsの組み合わせ)を使用できます。

タイプ: 文字列

例: developers

start_time
必須

取得するデータをstart_timeend_timeの間の時間枠で収集されるデータに制限します。ISO 8601で表します。

タイプ: 文字列

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

end_time
任意

取得するデータをstart_timeend_timeの間の時間枠で収集されるデータに制限します。ISO 8601で表します。

: デフォルト値は、現在の時間になります。

タイプ: 文字列

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

location
任意

結果をユーザーのアカウントの場所で絞り込むためにGET targeting_criteria/locationsエンドポイントから取得するターゲティング値。現在のところ、国レベルの場所のみがサポートされています。

タイプ: 文字列

例: 0ce8b9a7b2742f7e

negative_keywords
任意

除外するキーワードで構成されるカンマ区切りの文字列。すべてのネガティブキーワードは互いに論理和(OR)で結ばれます。

: 最大10個のキーワード(keywordsnegative_keywordsの組み合わせ)を使用できます。

タイプ: 文字列

例: 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
    ]
  }
}