--- title: "Changes to Get ad group analytics" method: GET path: "/ad_accounts/{ad_account_id}/ad_groups/analytics" --- # Changes to Get ad group analytics `GET /ad_accounts/{ad_account_id}/ad_groups/analytics` > Every recorded change to this operation, newest first. ## Timeline Changed in 15 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 17 info - **2025-12-11** (v5) `79f62f71f05b`: 2 info - **2025-10-16** (v5) `14c297539b64`: 7 info - **2025-07-16** (v5) `43134ca41f18`: 6 info - **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 13 info - **2024-08-14** (v5) `89c27ed39cfd`: 2 info - **2024-02-08** (v5) `7529b464d5cb`: 2 info - **2023-07-14** (v5) `52586a274771`: 22 info - **2023-05-12** (v5) `689b4b267639`: 19 info - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking - **2022-09-07** (v5) `bd20b6eb152f`: 1 warning, 7 info - **2022-07-11** (v5) `0d5998752011`: 3 info - **2022-04-08** (v5) `c561dee8c137`: 3 info - **2021-12-16** (v5) `2a34d1d22a47`: 1 warning - **2021-11-05** (v5) `8583f6373a80`: 32 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 17 info - added the enum value `COLLECTION_PIN_ITEM_CLICKTHROUGH_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `COLLECTION_PIN_ITEM_CLICKTHROUGH_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `COLLECTION_PIN_ITEM_IMPRESSION_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `COLLECTION_PIN_ITEM_IMPRESSION_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_APP_INSTALL` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_APP_INSTALL_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_APP_INSTALL_COST_PER_ACTION` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_ASSISTED_APP_INSTALL` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_COLLECTION_PIN_ITEM_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_COLLECTION_PIN_ITEM_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - for the `query` request parameter `click_window_days`, the type was generalized from `integer` to `number` - for the `query` request parameter `engagement_window_days`, the type was generalized from `integer` to `number` - for the `query` request parameter `view_window_days`, the type was generalized from `integer` to `number` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `404` - added the non-success response with the status `429` - **2025-12-11** (v5) `79f62f71f05b`: 2 info - added the enum value `TOTAL_APP_INSTALL_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_INAPP_APP_INSTALL_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - **2025-10-16** (v5) `14c297539b64`: 7 info - for the `query` request parameter `ad_group_ids`, the maxItems was increased from `100` to `250` - added the enum value `TOTAL_ADD_TO_WISHLIST` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_SUBSCRIBE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_VIDEO_15SEC_UNIQUE_VIEWS` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_15SEC_UNIQUE_VIEWS_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_15SEC_UNIQUE_VIEWS_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_3SEC_VIEWS_1` to the property `items/` of the `query` request parameter `columns` - **2025-07-16** (v5) `43134ca41f18`: 6 info - added the new optional `query` request parameter `reporting_timezone` - added the enum value `AD_GROUP_BUDGET_IN_LOCAL_CURRENCY` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_GROUP_BUDGET_TYPE` to the property `items/` of the `query` request parameter `columns` - added the enum value `CAMPAIGN_BRAND_LABEL` to the property `items/` of the `query` request parameter `columns` - added the enum value `CAMPAIGN_BUDGET_OPTIMIZATION` to the property `items/` of the `query` request parameter `columns` - added the enum value `PRODUCT_GROUP_AD_VIDEO_TAG` to the property `items/` of the `query` request parameter `columns` - **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 13 info - the response property `items/AD_GROUP_ID` became optional for the status `200` - the endpoint scheme security `client_credentials` was added to the API - added the new optional `query` request parameter `aggregate_report_rows` - added the enum value `AD_GROUP_BID_MULTIPLIER` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_GROUP_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_GROUP_OPTIMIZATION` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `COST_PER_OUTBOUND_CLICK_IN_DOLLAR_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `IS_PREMIERE_CAMPAIGN` to the property `items/` of the `query` request parameter `columns` - added the enum value `OUTBOUND_CTR_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `PRODUCT_GROUP_AD_IMAGE_TAG` to the property `items/` of the `query` request parameter `columns` - added the enum value `PROMO_ID` to the property `items/` of the `query` request parameter `columns` - added the enum value `PROMO_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_SPEND_IN_DOLLAR` to the property `items/` of the `query` request parameter `columns` - **2024-08-14** (v5) `89c27ed39cfd`: 2 info - added the enum value `PAID_VIDEO_VIEWABLE_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `QUIZ_PIN_RESULT_OPEN` to the property `items/` of the `query` request parameter `columns` - **2024-02-08** (v5) `7529b464d5cb`: 2 info - added the enum value `COST_PER_OUTBOUND_CLICK_IN_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_MRC_VIEWS_1` to the property `items/` of the `query` request parameter `columns` - **2023-07-14** (v5) `52586a274771`: 22 info - added the new enum value `0.00` to the `query` request parameter `click_window_days` - added the new enum value `0.00` to the `query` request parameter `engagement_window_days` - added the new enum value `0.00` to the `query` request parameter `view_window_days` - added the new enum value `14.00` to the `query` request parameter `click_window_days` - added the new enum value `14.00` to the `query` request parameter `engagement_window_days` - added the new enum value `14.00` to the `query` request parameter `view_window_days` - added the enum value `CAMPAIGN_OBJECTIVE_TYPE` to the property `items/` of the `query` request parameter `columns` - added the enum value `CUSTOM_ROAS` to the property `items/` of the `query` request parameter `columns` - added the enum value `ORDER_LINE_ID` to the property `items/` of the `query` request parameter `columns` - added the enum value `ORDER_LINE_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_AVERAGE_SUBPAGE_CLOSEUP_PER_SESSION` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_ADD_TO_CART_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CHECKOUT_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CUSTOM_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_LEAD_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_PAGE_VISIT_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_SEARCH_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_SIGNUP_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_UNKNOWN_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_VIEW_CATEGORY_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_WATCH_VIDEO_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - **2023-05-12** (v5) `689b4b267639`: 19 info - added the enum value `COST_PER_LEAD` to the property `items/` of the `query` request parameter `columns` - added the enum value `LEADS` to the property `items/` of the `query` request parameter `columns` - added the enum value `QUIZ_COMPLETED` to the property `items/` of the `query` request parameter `columns` - added the enum value `QUIZ_COMPLETION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_PIN_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_CLOSEUP` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_REPIN` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_SWIPE_LEFT` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_SWIPE_RIGHT` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_REPIN` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_SWIPE_LEFT` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_SWIPE_RIGHT` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - **2022-09-07** (v5) `bd20b6eb152f`: 1 warning, 7 info - for the `path` request parameter `ad_account_id`, the maxLength was set to `19` - api tag `ad_groups` added - api tag `ad_accounts` removed - added the enum value `ADVERTISER_ID` to the property `items/` of the `query` request parameter `columns` - added the enum value `PIN_PROMOTION_ID` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CLICK_ADD_TO_CART` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_OFFLINE_CHECKOUT` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_VIEW_ADD_TO_CART` to the property `items/` of the `query` request parameter `columns` - **2022-07-11** (v5) `0d5998752011`: 3 info - added the enum value `TOTAL_WEB_SESSIONS` to the property `items/` of the `query` request parameter `columns` - added the enum value `WEB_SESSIONS_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `WEB_SESSIONS_2` to the property `items/` of the `query` request parameter `columns` - **2022-04-08** (v5) `c561dee8c137`: 3 info - added the enum value `TOTAL_CLICK_LEAD` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_ENGAGEMENT_LEAD` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_VIEW_LEAD` to the property `items/` of the `query` request parameter `columns` - **2021-12-16** (v5) `2a34d1d22a47`: 1 warning - changed the pattern of the `path` request parameter `ad_account_id` from `\d+` to `^\d+$` - **2021-11-05** (v5) `8583f6373a80`: 32 info - added the enum value `CAMPAIGN_DAILY_SPEND_CAP` to the property `items/` of the `query` request parameter `columns` - added the enum value `CAMPAIGN_LIFETIME_SPEND_CAP` to the property `items/` of the `query` request parameter `columns` - added the enum value `CAMPAIGN_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `CLICKTHROUGH_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `CLICKTHROUGH_1_GROSS` to the property `items/` of the `query` request parameter `columns` - added the enum value `CLICKTHROUGH_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `CPC_IN_MICRO_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `CPM_IN_MICRO_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `ECPC_IN_MICRO_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `ECPM_IN_MICRO_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `ENGAGEMENT_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `ENGAGEMENT_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `IDEA_PIN_PRODUCT_TAG_VISIT_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `IDEA_PIN_PRODUCT_TAG_VISIT_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `IMPRESSION_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `IMPRESSION_1_GROSS` to the property `items/` of the `query` request parameter `columns` - added the enum value `IMPRESSION_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_CHECKOUT_COST_PER_ACTION` to the property `items/` of the `query` request parameter `columns` - added the enum value `OUTBOUND_CLICK_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `OUTBOUND_CLICK_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `PAID_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - added the enum value `PIN_ID` to the property `items/` of the `query` request parameter `columns` - added the enum value `REPIN_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `REPIN_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `SPEND_IN_MICRO_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CUSTOM` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_ENGAGEMENT` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_IDEA_PIN_PRODUCT_TAG_VISIT` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_IMPRESSION_USER` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_LEAD` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_LENGTH` to the property `items/` of the `query` request parameter `columns` - added the non-success response with the status `400` --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/ad_groups/analytics/get.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/ad_groups/analytics/get)