キーワードインサイト

Postmanで実行 ❯

GET insights/keywords/search¶

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

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

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

リソースURL¶

https://ads-api.x.com/10/insights/keywords/search

パラメーター¶

名前	説明
granularity 必須	`start_time`および`end_time`で示される時間範囲について返されるデータの詳細度を指定します。たとえば、`HOUR`に設定すると、`start_time`から`end_time`までの1時間ごとのデータポイントが表示されます。タイプ: 列挙使用可能な値: `DAY`、`HOUR`
keywords 必須	検索を絞り込むためのキーワードで構成されるカンマ区切りの文字列。すべてのキーワードは互いに論理和（OR）で結ばれます。注: 最大10個のキーワード（`keywords`と`negative_keywords`の組み合わせ）を使用できます。タイプ: 文字列例: `developers`
start_time 必須	取得するデータを`start_time`と`end_time`の間の時間枠で収集されるデータに制限します。ISO 8601で表します。タイプ: 文字列例: `2017-07-10T00:00:00Z`
end_time 任意	取得するデータを`start_time`と`end_time`の間の時間枠で収集されるデータに制限します。ISO 8601で表します。注: デフォルト値は、現在の時間になります。タイプ: 文字列例: `2017-07-11T00:00:00Z`
location 任意	結果をユーザーのアカウントの場所で絞り込むためにGET targeting_criteria/locationsエンドポイントから取得するターゲティング値。現在のところ、国レベルの場所のみがサポートされています。タイプ: 文字列例: `0ce8b9a7b2742f7e`
negative_keywords 任意	除外するキーワードで構成されるカンマ区切りの文字列。すべてのネガティブキーワードは互いに論理和（OR）で結ばれます。注: 最大10個のキーワード（`keywords`と`negative_keywords`の組み合わせ）を使用できます。タイプ: 文字列例: `rain`

リクエストの例¶

GET https://ads-api.x.com/10/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
    ]
  }
}