Marketing API Version

Ad Keyword Stats

Stats specific to each interest, or keyword, targeted by an ad. Provide keywords in ad set targeting spec. Keywords are known as Interests in Ads Manager. See Click Tracking Tags and Keyword Stats, Guide.

When someone sees an ad targeting multiple keywords, we attribute the impression to all keywords if they fall in that interest segment. For example, if someone with sports and outdoor interests sees an ad targeting both, attribute 1 impression to sports and 1 to outdoor. If someone has only sports as an interest, attribute 1 impression to sports and 0 impressions to outdoor.


Query for the past 7 days excluding current day. The IDs you use in ad_ids must be for ads active in the past 7 days and the ads must use interest targeting.