Keyword Stats

Keywords Stats are specific to each interest, or keyword, targeted by an ad. Provide keywords in an ad set targeting spec. Keywords are known as Interests in Ads Manager. See also Ad Keyword Stats, Reference.

Using Keyword Stats

Query the keywordstats connection of the Ad object:

<API_VERSION>/<AD_ID>/keywordstats

To query from a particular day in the last week:

<API_VERSION>/<AD_ID>/keywordstats?date=YYYY-MM-DD

A sample response looks like this:

{
  "data": {
    "Good Housekeeping": {
      "id": "<id>",
      "name": "Good Housekeeping",
      "impressions": "65205",
      "unique_impressions": "52824",
      "clicks": "3209",
      "unique_clicks": "3175",
      "total_actions": "3383",
      "total_unique_actions": "2973",
      "actions": [
        {
          "action_type": "photo_view",
          "value": "42"
        },
        {
          "action_type": "video_view",
          "value": "40"
        },
        {
          "action_type": "post",
          "value": "31"
        },
....
        }
      ],
      "unique_actions": [
        {
          "action_type": "photo_view",
          "value": "38"
        },
        {
          "action_type": "video_view",
          "value": "17"
        },
....
          "action_type": "post_like",
          "value": "56"
        },
        {
          "action_type": "like",
          "value": "2929"
        },
....
        }
      ]
    },
    "Better Homes and Gardens (TV series)": {...}
  }
}