Upcoming API Changes

Changes to the API potentially breaking

Changes with the API

Please see What's New for new features.

Changes in Effect February 17, 2023

  • Google Business Profile has changed the available social analytics data available. The new fields available are the following. Previous fields will still be present, but with a zero value and fully removed on March 17, 2003.
"businessBookings": 0,
"businessConversations": 0,
"businessDirectionRequests": 328,
"businessFoodOrders": 0,
"businessImpressionsDesktopMaps": 153,
"businessImpressionsDesktopSearch": 9675,
"businessImpressionsMobileMaps": 65,
"businessImpressionsMobileSearch": 2070,
"callClicks": 2,
"websiteClicks": 134

Changes in Effect October 1, 2022

  • Get All Posts descriptions, text, message fields standardized to post field.

Changes in Effect September 12, 2022

  • TikTok fields deprecated: shareUrl. Use postUrl instead.
  • TikTok fields deprecated: shareUrl. Use postUrl instead.
  • TikTok social field deprecated: userName. User username instead.
  • Instagram social analytics impressions, reach, and website clicks increased from 30-days to 180-days total.

Changes in Effect June 17, 2022

  • For all history endpoints the fields createdAt, createdTime, and timestamp will be replaced with the created field which returns the creation time in UTC format.
  • The scheduleDate field will no longer return an Object by a String containing the schedule time in UTC format.
  • The undocumented created_date field on /history will be removed. Use created instead.
Please see the endpoints for the comments in the response.

Changes in Effect April 22, 2022

Analytics on a Facebook post returns reactions as an object in the following format.
"reactions": {
"like": 1, // Like reactions
"love": 1 // Love reactions
"anger": 1, // Anger reactions
"haha": 1, // Haha reactions
"wow": 1, // Wow reactions
"sorry": 1, // Sorry reactions
"total": 6 // Total number of reactions
This aligns with the new data set returned in the Social Analytics for Facebook.

Changes in Effect April 1, 2022


History by default will return the last 20 posts. Up to 500 can be returned with the lastRecords parameter.