Comment on page
Upcoming API Changes
Changes to the API potentially breaking
- The
/history/instagram
endpoint fieldscaption
,message
,createdTime
andtimestamp
fields were deprecated on April 1, 2023 and will be removed. Please use thepost
andcreated
fields. - The
/history/linkedin
endpoint fieldmediaUrls
will be returned as an array instead of an object to support multiple images. You can force the array being returned now by including the LinkedIn query parameter?multiMedia=true
. Please note, before December 1, 2023 themultiMedia
query parameter must be used to return media with multiple images. After December 1, 2023 multiple images will be returned by default. - The Scheduled Action TikTok webhook will have the String
platform
deprecated. Please use theplatforms
array field as is done for other Scheduled Action webhooks. - The delete comment docs have been corrected to align with the correct return.
- The TikTok commentId field will be replaced with the id field to align with the standard comment delete format.
- The Twitter delete comment return will no longer contain a
posts
array so the return aligns with the standard comment delete format. The new return will be as follows:"twitter": {"action": "delete","status": "success","id": "Ugy2m5u-LS9M29Gn3hd4AaABAg"}
The following social analytics endpoint YouTube fields will be returned as numeric instead of String values.
subscriberCount
videoCount
viewCount
We have upgrade to Twitter's new API version 2. Twitter has deprecated a few fields in Version 2, which affects the /analytics/social and getAllHistory endpoints. These following fields will still be returned until September 1, 2023, but will have a zero or empty string value.
Deprecated Fields:
bannerImageUrl: "",
favoritesCount: 0,
friendsCount: 0,
likedCount: 0
We're excited to launch TikTok direct publishing, comment management, and advanced analytics. Your users will no longer need to open their TikTok mobile app to post and enter caption text. Now after sending via Ayrshare, the TikTok video and caption is directly published.
We're also introducing adding, getting, and deleting TikTok comments + demographic analytics data.
Your user will need to unlink and relink their TikTok account to enable direct publishing. Existing connections will continue with the indirect method and require the TikTok mobile app to publish.
- 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
}
- Get All Posts descriptions, text, message fields standardized to
post
field.
- TikTok fields deprecated:
shareUrl
. UsepostUrl
instead.
- TikTok fields deprecated:
shareUrl
. UsepostUrl
instead. - TikTok social field deprecated:
userName
. Userusername
instead. - Instagram social analytics impressions, reach, and website clicks increased from 30-days to 180-days total.
- For all history endpoints the fields
createdAt
,createdTime
, andtimestamp
will be replaced with thecreated
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. Usecreated
instead.
Please see the endpoints for the comments in the response.
/analytics
"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.
History by default will return the last 20 posts. Up to 500 can be returned with the
lastRecords
parameter. Last modified 14d ago