This is the documentation for the Brandwatch SMM v1 API. Read the content of this page carefully, including the API Licence Agreement, to understand how to be a good API citizen and to understand general restrictions and concerns. Your usage and access to the API is expressly conditioned on your compliance with the policies, restrictions and other provisions related to the API set forth in our API Licence Agreement and any other documentation we provide you. You must be compliant with these restrictions in the Brandwatch Terms of Service and the Brandwatch Privacy Policy, in all uses of the API. It also entails you must always ensure to be compliant with requirements from networks from which you use the content. If Falcon.io believes that you have or attempted to violate any term, condition or the spirit of these policies or agreements, your right to access and use the API may be temporarily or permanently revoked.

Brandwatch may modify the attributes and resources available to the API and our policies related to access and use of the API from time to time without advance notice. Brandwatch will use commercially reasonable efforts to notify you of any modifications to the API or policies through notifications or posts on the Brandwatch Developer Website. Brandwatch also tracks deprecation of attributes of the API on its Changes Roadmap. Modification of the API may have an adverse effect on Brandwatch Applications, including but not limited to changing the manner in which Brandwatch Applications communicate with the API and display or transmit Your Data. Brandwatch will not be liable to you or any third party for such modifications or any adverse effects resulting from such modifications.

Brandwatch’s SMM API is rate limited. This means we only allow a certain number of requests per customer organization. We reserve the right to adjust the rate limit for given endpoints in order to provide a high-quality of service for all clients. If the rate limit is exceeded, Brandwatch will respond with an HTTP 429 Too Many Requests response code and a body that details the reason for the limit.

Each customer can create up to 5 API keys. Each API key has a rate limit of 43.200 calls per month, bringing the monthly total to 216.000 calls per customer.

Rate limits overview

In order to authenticate with the API endpoints, an apikey must be provided as a query parameter. The apikey is a secret between your organization and Brandwatch and can only be obtained through Brandwatch. In other words, all requests to an endpoint must have ?apikey={YOUR_API_KEY} in the URL, e.g. https://api.falcon.io/teams?apikey={YOUR_API_KEY}

For instructions on how to get access please visit this link: Get access to APIs

If you have any questions please contact our support at apisupport@brandwatch.com

Facebook will sunset the API version currently used by Measure, resulting in the deprecation of certain unique metrics. Due to this change, Measure will no longer be able to fetch or update these metrics with new data when retrieving insights for Facebook-connected channels; historical data may remain available, but no further updates will be provided after the deprecation takes effect. The affected metrics are the following:

CHANNEL:

• Paid reach → channel/reach_paid/day

• Viral reach → channel/reach_viral/day

• Non-viral reach → channel/reach_nonviral/day

• Organic reach → channel/reach_organic/day

• Video viewers → channel/video_viewers/day

Reach (channel/reach/day) metric will return the new Facebook Viewers value since 1 Jan 2026. Before this date, Facebook Reach values will still be returned.

CONTENT:

• Paid reach → content/reach_paid/lifetime

• Organic reach → content/reach_organic/lifetime

• Fan reach → content/reach_fan/lifetime

• Viral reach → content/reach_viral/lifetime

• Non-viral reach → content/reach_nonviral/lifetime

• Non fans reach → content/reach_non_fan/lifetime

• Organic video viewers → content/video_viewers_organic/lifetime

• Paid Video viewers → content/video_viewers_paid/lifetime

• Video viewers → content/video_viewers/lifetime

Reach (content/reach/lifetime) metric will return the new Facebook Viewers value since 1 Jan 2026. Before this date, Facebook Reach values will still be returned.

Removed documentation of deprecated Channels APIs

Added support for TikTok in channel metrics:

• Reach → channel/reach/day

• Engagement Rate (Reach) -> channel/engagement_rate_reach/day

• Interaction Rate (Reach) -> channel/interaction_rate_reach/day

Added support for TikTok in content metrics:

• User follows → content/user_follows/lifetime

• Saves → content/saves/lifetime

Updated TikTok content metrics:

• content/engagements/lifetime → now includes Saves

• content/interactions/lifetime → now includes Saves

New Instagram content metrics:

• content/reposts/lifetime

• content/skip_rate/lifetime

Updated Instagram content metrics:

• content/engagements/lifetime -> Adding reposts metric

• content/interactions/lifetime -> Adding reposts metric

New Instagram channel metrics:

• channel/reposts/day

Added new group for Integrations Data Exporter

Facebook will sunset the API version currently used by Measure, resulting in the deprecation of certain Video View (10s) metrics. Due to this change, Measure will no longer be able to fetch or update these metrics with new data when retrieving insights for Facebook-connected channels; historical data may remain available, but no further updates will be provided after the deprecation takes effect. The affected metrics are the following:

CHANNEL

• Video views (10s): channel/video_views_10s/day

CONTENT

• Video views (10s): content/video_views_10s/lifetime

• Organic video views (10s): content/video_views_organic_10s/lifetime

• Paid video views (10s): content/video_views_paid_10s/lifetime

• Video viewers (10s): content/video_viewers_10s/lifetime

• Video autoplays (10s): content/video_views_autoplayed_10s/lifetime

• Video click to play (10s): content/video_views_clicked_to_play_10s/lifetime

• Video views with sound on (10s): content/video_views_sound_on_10s/lifetime

• Video retention rate (10s): content/video_retention_rate_10s/lifetime

Removed incorrect export options in Engage.

• It is not possible to export LinkedIn content. It was previously shown as option in the Export API.

Marked legacy Channel endpoints as deprecated in favour of v2 ones

• Get Team Channels

• Get Channels

• Get Channel

• Get Channel Groups

Added new endpoints for Channels

• Get Channels V2 added

• Get Channel V2 added

• Get Channel Groups V2 added

• Get Channel Group V2 added

Measure has added the following metric names to the list of supported channel level metrics

• channel/followers/day → Followers

• channel/followers_decrease/day → Followers decrease

• channel/followers_increase/day → Followers increase

• channel/followers_net/day → Net new followers

• channel/likes_total/day → Page likes (old Facebook Fans values)

• channel/likes_total_increase/day → Page likes increase (old Facebook Fans increase values)

• channel/likes_total_decrease/day → Page likes decrease (old Facebook Fans decrease values)

• channel/net_likes_total/day → Net new page likes (old Facebook Net new fans values)

Important Note

To avoid breaking existing client integrations with the Measure API, the current Fans metrics will be retained for 4 months, returning the values from the new Followers metrics. On February 1st, 2026 the following fans metrics will be removed and no longer supported.

• channel/fans/day (alternative: channel/followers/day)

• channel/fans_increase/day (alternative: channel/followers_increase/day)

• channel/fans_decrease/day (alternative: channel/followers_decrease/day)

• channel/net_fans/day (alternative: channel/followers_net/day)

Added Export CSV for Measure supported metrics

• Get Channel Metrics Metadata added

• Get Content Metrics Metadata added

Added new endpoint for Engage

• Create Messages API added

Support for YouTube draft handling

Added new endpoint for Engage

• TPR metrics export

Added new endpoint in benchmark API

• get custom engagement weight

Add new targeting options for Facebook:

• Feed targeting

  • College years
  • Genders
  • Interests
  • Geographic locations

• Targeting

  • Age min

• Support for Pinterest draft handling

• Deprecation of channels in copy publishing endpoint

Facebook draft updated to include facebook REEL placement

Added missing thumbnailFrameMillisec property to Content API for facebook video posts

LinkedIn draft updated to include LinkedIn Poll content type

Corrected Instagram carousel media field name (originalImage > originalPicture) when handling drafts

Added missing Title property to Facebook video content when handling drafts

LinkedIn draft updated to include LinkedIn Document content type

Added support for tagging users in instagram videos

Added support for tagging collaborators in instagram posts (pictures, videos, carousels)

Deprecation: stop supporting since and until with offset without colon (eg.: +0200) within campaign's APIs

Facebook will deprecate some of their metrics:Changelog - Facebook Pages API - Documentation - Meta for Developers, Measure will no longer be able to update the metrics with new data when fetching insights for Facebook channels. The affected metrics are the following:

• Engagements: channel/engagements/day

• Engagement Rate: channel/engagement_rate/day

• Engagement Rate (Reach): channel/engagement_rate_reach/day

• Clicks: channel/clicks/day

• Clicks by type: channel/clicks_by_type/button_clicks/day

• Clicks by type: channel/clicks_by_type/link_clicks/day

• Clicks by type: channel/clicks_by_type/other_clicks/day

• Clicks by type: channel/clicks_by_type/photo_view/day

• Clicks by type: channel/clicks_by_type/video_play/day

• Link clicks: channel/link_clicks/day

• Video plays: channel/video_plays/day

• Photo clicks: channel/photo_clicks/day

• Other clicks: channel/other_clicks/day

• Negative actions: channel/negative_actions/day

• Negative actions by type: channel/negative_actions_by_type/total/day

• Negative actions by type: channel/negative_actions_by_type/hide_all_clicks/day

• Negative actions by type: channel/negative_actions_by_type/hide_clicks/day

• Negative actions by type: channel/negative_actions_by_type/report_spam_clicks/day

• Negative actions by type: channel/negative_actions_by_type/unlike_page_clicks/day

• Negative fans: channel/negative_fans/day

• Channel views by logged in/out: channel/views_by_logged_in_out/total/day

• Channel views by logged in/out: channel/views_by_logged_in_out/logged_out/day

• Fans online by hour: channel/fans_online_by_hour/total/day

• Fans online by hour: channel/fans_online_by_hour/0/day

• Fans online by hour: channel/fans_online_by_hour/1/day

• Fans online by hour: channel/fans_online_by_hour/2/day

• Fans online by hour: channel/fans_online_by_hour/3/day

• Fans online by hour: channel/fans_online_by_hour/4/day

• Fans online by hour: channel/fans_online_by_hour/5/day

• Fans online by hour: channel/fans_online_by_hour/6/day

• Fans online by hour: channel/fans_online_by_hour/7/day

• Fans online by hour: channel/fans_online_by_hour/8/day

• Fans online by hour: channel/fans_online_by_hour/9/day

• Fans online by hour: channel/fans_online_by_hour/10/day

• Fans online by hour: channel/fans_online_by_hour/11/day

• Fans online by hour: channel/fans_online_by_hour/12/day

• Fans online by hour: channel/fans_online_by_hour/13/day

• Fans online by hour: channel/fans_online_by_hour/14/day

• Fans online by hour: channel/fans_online_by_hour/15/day

• Fans online by hour: channel/fans_online_by_hour/16/day

• Fans online by hour: channel/fans_online_by_hour/17/day

• Fans online by hour: channel/fans_online_by_hour/18/day

• Fans online by hour: channel/fans_online_by_hour/19/day

• Fans online by hour: channel/fans_online_by_hour/20/day

• Fans online by hour: channel/fans_online_by_hour/21/day

• Fans online by hour: channel/fans_online_by_hour/22/day

• Fans online by hour: channel/fans_online_by_hour/23/day

• Reach by gender: channel/reach_by_gender_age/day

• Reach by country: channel/reach_by_country/day

• Fans increase by like source: channel/fans_increase_by_like_source/total/day

• Fans increase by like source: channel/fans_increase_by_like_source/ads/day

• Fans increase by like source: channel/fans_increase_by_like_source/news_feed/day

• Fans increase by like source: channel/fans_increase_by_like_source/other/day

• Fans increase by like source: channel/fans_increase_by_like_source/page_suggestions/day

• Fans increase by like source: channel/fans_increase_by_like_source/restored_likes_from_reactivated_accounts/day

• Fans increase by like source: channel/fans_increase_by_like_source/search/day

• Fans increase by like source: channel/fans_increase_by_like_source/your_page/day

• Fans decrease by unlike source: channel/fans_decrease_by_unlike_source/total/day

• Fans decrease by unlike source: channel/fans_decrease_by_unlike_source/deactivated_or_memorialized_account_removals/day

• Fans decrease by unlike source: channel/fans_decrease_by_unlike_source/other/day

• Fans decrease by unlike source: channel/fans_decrease_by_unlike_source/suspicious_account_removals/day

• Fans decrease by unlike source: channel/fans_decrease_by_unlike_source/unlikes_from_page_posts_or_news_feed/day

• Fans decrease by unlike source: channel/fans_decrease_by_unlike_source/unlikes_from_search/day

• Frequency (distribution): channel/frequency_distribution/day

• Engaged users: content/engaged_users/lifetime

• Engaged users rate: content/engaged_users_rate/lifetime

• Engaged fans: content/engaged_fans/lifetime

• Negative feedback: content/negative_feedback/lifetime

• Negative users: content/negative_users/lifetime

• Report as spam: content/report_spam_clicks/lifetime

• Unlike page: content/unlike_clicks/lifetime

The deprecated metrics will still be available in the API. They will only be used for historical purposes.

Benchmark API Update:

• Added support for YouTube network

• Added Reach, Impressions, Engagement Rate properties for content on Facebook, Instagram and X(Twitter)

• Fixed a few endpoint HTTP methods and misspelled variables in the payload

  • /channel/feed
  • /channel/metrics
  • /channel/metrics/followers
  • /channel/metrics/posts
  • /channel/metrics/engagement

• URL: /benchmark/v1

Added support for copying a stock in the Content Pool API. This allows for the creation of drafts from a stock.

• URL: POST /publish/content-pool/stocks/{stockId}/copy

• BODY: { channelUuids: string[] }

Adding support for LinkedIn in the following content metrics:

• Video views: content/video_views/lifetime

• Video viewers: content/video_viewers/lifetime

• Video frequency: content/video_frequency/lifetime

• Watch time(min): content/video_view_time/lifetime

• Video view rate: content/video_view_rate/lifetime

New content metric for LinkedIn video posts:

• Watch time for video views: content/post_watch_time_video_views/lifetime

Data for these metrics will be available for LinkedIn video posts published from 2023-05-28

Benchmark API V1 Released

After Facebook deprecated some of their channel level metrics:Changelog - Facebook Pages API - Documentation - Meta for Developers, Measure will no longer be able to update the metrics with new data when fetching insights for Facebook channels. The affected metrics are the following:

• Engaged users: channel/engaged_users/day

• Comments: channel/comments/day

• Shares: channel/shares/day

• Clicks: channel/clicks/day

• Engagements: channel/engagements/day

• Interactions: channel/interactions/day

• Engagement rate: channel/engagement_rate/day

• Engagement rate (Reach): channel/engagement_rate_reach/day

• Interaction rate: channel/interaction_rate/day

• Interaction rate (Reach): channel/interaction_rate_reach/day

• Positive actions by type: channel/positive_actions_by_type/total/day

• Positive actions by type: Answer - channel/positive_actions_by_type/answer/day

• Positive actions by type: Claim - channel/positive_actions_by_type/claim/day

• Positive actions by type: Comment - channel/positive_actions_by_type/comment/day

• Positive actions by type: Like - channel/positive_actions_by_type/like/day

• Positive actions by type: Other - channel/positive_actions_by_type/other/day

• Positive actions by type: RSVP - channel/positive_actions_by_type/rsvp/day

• Positive actions by type: Share - channel/positive_actions_by_type/share/day

• Fans increase by like source - channel/fans_increase_by_like_source/total/day

• Fans increase by like source: Ads - channel/fans_increase_by_like_source/ads/day

• Fans increase by like source: News feed - channel/fans_increase_by_like_source/news_feed/day

• Fans increase by like source: Page suggestions - channel/fans_increase_by_like_source/page_suggestions/day

• Fans increase by like source: Restored likes from reactivated accounts - channel/fans_increase_by_like_source/restored_likes_from_reactivated_accounts/day

• Fans increase by like source: Search - channel/fans_increase_by_like_source/search/day

• Fans increase by like source: Other - channel/fans_increase_by_like_source/other/day

• Fans decrease by unlike source - channel/fans_decrease_by_unlike_source/total/day

• Fans decrease by unlike source: Deactivated or memorialized account removals - channel/fans_decrease_by_unlike_source/deactivated_or_memorialized_account_removals/day

• Fans decrease by unlike source: Suspicious account removals - channel/fans_decrease_by_unlike_source/suspicious_account_removals/day

• Fans decrease by unlike source: Unlikes from page, posts, or news feed - channel/fans_decrease_by_unlike_source/unlikes_from_page_posts_or_news_feed/day

• Fans decrease by unlike source: Unlikes from search - channel/fans_decrease_by_unlike_source/unlikes_from_search/day

• Fans decrease by unlike source: Other - channel/fans_decrease_by_unlike_source/other/day

• Engagement stories by type - channel/engagement_stories_by_type/total/day

• Engagement stories by type: Checkins - channel/engagement_stories_by_type/checkins/day

• Engagement stories by type: Fan posts - channel/engagement_stories_by_type/fan_posts/day

• Engagement stories by type: Offer claims - channel/engagement_stories_by_type/offer_claims/day

• Engagement stories by type: Page likes - channel/engagement_stories_by_type/page_likes/day

• Engagement stories by type: Page mentions - channel/engagement_stories_by_type/page_mentions/day

• Engagement stories by type: Page posts - channel/engagement_stories_by_type/page_posts/day

• Engagement stories by type: Question answers - channel/engagement_stories_by_type/question_answers/day

• Engagement stories by type: RSVP - channel/engagement_stories_by_type/rsvp/day

• Engagement stories by type: Other - channel/engagement_stories_by_type/other/day

• Frequency (distribution) - channel/frequency_distribution/day

• Channel views by logged in/out: channel/views_by_logged_in_out/total/day

• Channel views by logged in/out: Logged in - channel/views_by_logged_in_out/logged_in/day

• Channel views by logged in/out: Logged out - channel/views_by_logged_in_out/logged_out/day

• Storytellers by country - channel/storytellers_by_country/day

• Fans by Gender and Age - channel/fans_by_gender_age/day

• Storytellers by Gender and Ager - channel/storytellers_by_gender_age/day

The deprecated metrics will still be available in the API. They will only be used for historical purposes.

New content metrics for Instagram:

• Plays - content/plays_total/lifetime - Available for Reels.

  • content/plays/lifetime has been renamed to “Initial plays”.

• Replays - content/replays/lifetime - Available for Reels.

• Profile activity - content/profile_activity/lifetime - Available for Reels, Images and Videos.

Adding Instagram support to the following content metrics:

• Watch time (min) - content/video_view_time/lifetime - Adding support for Reels.

• Average watch time - content/video_avg_time_watched/lifetime - Adding support for Reels.

• User follows - content/user_follows/lifetime - Adding support for Reels, Images and Videos.

• User profile clicks - content/user_profile_clicks/lifetime - Adding support for Reels, Images and Videos.

Adding support for more Instagram content types:

• Shares - content/shares/lifetime - Adding support for Carousels, Images and Videos in addition to the already supported Reels.

• Engagements - content/engagements/lifetime- Adding Shares to the metric for Carousels, Images and Videos in addition to the already supported Reels.

• Engagement Rate - content/engagement_rate/lifetime - Adding Shares to the formula for Carousels, Images and Video in addition to the already supported Reels.

• Engagement Rate (Reach) - content/engagement_rate_reach/lifetime - Adding Shares to the formula for Carousels, Images and Videos in addition to the already supported Reels.

• Weighted engagements - content/engagements_weighted/lifetime - Adding Shares with weight 3 to the formula for Carousels, Images and Videos in addition to the already supported Reels.

• Weighted engagement rate - content/engagement_rate_weighted/lifetime - Adding Shares with weight 3 to the formula for Carousels, Images and Videos in addition to the already supported Reels.

New content metric for Facebook, Instagram, LinkedIn and TikTok:

• Weighted engagement rate (reach) - content/engagement_rate_reach_weighted/lifetime

Instagram Images, Videos, Reels and Carousels published after 2021-12-31 are affected by the changes.

Benchmark API V1 Pre-Release

Adding support for Instagram in the following channel metrics:

• Fans decrease: channel/fans_decrease/day

• Engaged users: channel/engaged_users/day

• Reactions: channel/reactions/day

• Likes: channel/likes/day

• Comments: channel/comments/day

• Shares: channel/shares/day

• Engagements: channel/engagements/day

• Engagement rate: channel/engagement_rate/day

New Instagram channel metrics with their corresponding breakdowns:

• Saves - channel/saves/day

• Engaged users rate - channel/engaged_users_rate/day

• Reach by media type - channel/reach_by_media_type/total/day

  • Reel reach - channel/reach_reel/day
  • Story reach - channel/reach_story/day
  • Paid reach - channel/reach_ad/day
  • Photo or video reach - channel/reach_post/day
  • IGTV reach - channel/reach_igtv/day
  • Carousel reach - channel/reach_carousel/day
  • Profile pic reach - channel/reach_profile_pic/day

• Reach by follow type - channel/reach_by_follow_type/total/day

  • Follower reach - channel/reach_follower/day
  • Non follower reach - channel/reach_non_follower/day

• Engagements by media type - channel/engagements_by_media_type/total/day

  • Reel engagements - channel/engagements_reel/day
  • Story engagements - channel/engagements_story/day
  • Photo or video engagements - channel/engagements_post/day
  • Paid engagements - channel/engagements_ad/day
  • IGTV Engagements - channel/engagements_igtv/day
  • Live engagements - channel/engagements_live/day

• Likes by media type - channel/likes_by_media_type/total/day

  • Reel likes - channel/likes_reel/day
  • Story likes - channel/likes_story/day
  • Photo or video likes - channel/likes_post/day
  • Carousel likes - channel/likes_carousel/day
  • Paid likes - channel/likes_ad/day
  • IGTV likes - channel/likes_igtv/day

• Comments by media type - channel/comments_by_media_type/total/day

  • Reel comments - channel/comments_reel/day
  • Story comments - channel/comments_story/day
  • Photo or video comments - channel/comments_post/day
  • Paid comments - channel/comments_ad/day
  • Live comments - channel/comments_live/day
  • IGTV comments - channel/comments_igtv/day

• Shares by media type - channel/shares_by_media_type/total/day

  • Reel shares - channel/shares_reel/day
  • Story shares - channel/shares_story/day
  • Photo or video shares - channel/shares_post/day
  • Carousel shares - channel/shares_carousel/day
  • Paid shares - channel/shares_ad/day
  • IGTV shares - channel/shares_igtv/day

• Saves by media type - channel/saves_by_media_type/total/day

  • Reel saves - channel/saves_reel/day
  • Photo or video saves - channel/saves_post/day
  • Paid saves - channel/saves_ad/day
  • IGTV saves - channel/saves_igtv/day

• Profile activity by type - channel/profile_activity_by_type/total/day

  • Book now - channel/profile_links_taps_book_now/day
  • Call - channel/profile_links_taps_call/day
  • Direction - channel/profile_links_taps_direction/day
  • Email - channel/profile_links_taps_email/day
  • Instant experience - channel/profile_links_taps_instant_experience/day
  • Text - channel/profile_links_taps_text/day
  • Website clicks - channel/website_clicks/day (Already existing metric)

• Engagement rate (reach) by media type - channel/engagement_rate_reach_by_media_type/total/day

  • Reel engagement rate (reach) - channel/engagement_rate_reach_reel/day
  • Story engagement rate (reach) - channel/engagement_rate_reach_story/day
  • Photo or video engagement rate (reach) - channel/engagement_rate_reach_post/day
  • Paid engagement rate (reach) - channel/engagement_rate_reach_ad/day
  • IGTV engagement rate (reach) - channel/engagement_rate_reach_igtv/day

New channel metric for Facebook, Instagram and LinkedIn:

• Engagement rate (reach) - channel/engagement_rate_reach/day

The list of all supported metrics has been updated with the new changes, including the description for each metric. The list can be accessed from the following link: https://app.falcon.io/measure/public-api/v2/metrics/export/csv?level=channel

New metrics in Measure API v2

Content metrics - Twitter

• Organic Likes: content/likes_organic/lifetime

• Paid Likes: content/likes_paid/lifetime

• Organic Comments: content/comments_organic/lifetime

• Paid Comments: content/comments_paid/lifetime

• Organic Shares: content/shares_organic/lifetime

• Paid Shares: content/shares_paid/lifetime

• Organic Engagements: content/engagements_organic/lifetime

• Paid Engagements: content/engagements_paid/lifetime

• Organic Engagement Rate: content/engagement_rate_organic/lifetime

• Paid Engagement Rate: content/engagement_rate_paid/lifetime

• Organic Link clicks: content/link_clicks_organic/lifetime

• Paid Link clicks : content/link_clicks_paid/lifetime

• Organic User profile clicks: content/user_profile_clicks_organic/lifetime

• Paid User profile clicks: content/user_profile_clicks_paid/lifetime

• Organic Interactions: content/interactions_organic/lifetime

• Paid Interactions content/interactions_paid/lifetime

• Organic Interaction Rate: content/interaction_rate_organic/lifetime

• Paid Interaction Rate: content/interaction_rate_paid/lifetime

• Organic Link CTR: content/ctr_link_organic/lifetime

• Paid Link CTR: content/ctr_link_paid/lifetime

• Organic Video starts: content/video_starts_organic/lifetime

• Paid Video starts: content/video_starts_paid/lifetime

• Organic Video views (25%): content/video_views_25_organic/lifetime

• Paid Video views (25%): content/video_views_25_paid/lifetime

• Organic Video views (50%): content/video_views_50_organic/lifetime

• Paid Video views (50%): content/video_views_50_paid/lifetime

• Organic Video views (75%): content/video_views_75_organic/lifetime

• Paid Video views (75%): content/video_views_75_paid/lifetime

• Organic Video views (100%): content/video_views_100_organic/lifetime

• Paid Video views (100%): content/video_views_100_paid/lifetime

• Video completion rate: content/video_completion_rate_100/lifetime

• Organic Video completion rate: content/video_completion_rate_100_organic/lifetime

• Paid Video completion rate: content/video_completion_rate_100_paid/lifetime

Please note that these new metrics can be accessed from 20th of May 2023 for organic tweets and 20th of July 2023 for promoted tweets.

Added Link In Bio API. This api allows getting, adding, and deleting links from a link in bio page.

Corrected documentation on the Short URL API.

As of August 1st, Twitter has deprecated the InsightsTrack API. Consequently, Measure API v2 will cease to provide support for the following "Content metrics" for Twitter:

• content/reach/lifetime

• content/engaged_users/lifetime

• content/detail_expands/lifetime

• content/unfavorites/lifetime

• content/unreplies/lifetime

• content/unretweets/lifetime

• content/user_follows/lifetime

• content/user_unfollows/lifetime

• content/email_clicks/lifetime

• content/unquote_retweets/lifetime

• content/hashtag_clicks/lifetime

• content/photo_view_clicks/lifetime

• content/permalink_clicks/lifetime

• content/video_views_95/lifetime

• content/app_open_clicks/lifetime

• content/app_install_clicks/lifetime

• content/engagement_rate_reach/lifetime

• content/interaction_rate_reach/lifetime

• content/frequency/lifetime

• content/engaged_users_rate/lifetime

• content/engagement_rate_link/lifetime (using reach, Measure will add it using impressions)

• content/photo_view_rate/lifetime

• content/other_clicks/lifetime

Please note that these metrics will remain accessible through the API until March 2024, with data available until August 1st, 2023

• Added "audioName" to Instagram content.

• Retry-After response header is not supported.

• "v2" has been added to the URLs for the Engage Export API. Please note that the earlier endpoints are now deprecated. We will ensure to provide adequate notice prior to their removal.

• It is now possible to create Short URL with a dedicated endpoint

• Support for thumbnail offset in TikTok drafts video has been added

New metrics in Measure API v2

Channel metrics - Facebook and LinkedIn

• Interaction rate: channel/interaction_rate/day

• Interaction rate (reach): channel/interaction_rate_reach/day

Content metrics - Facebook

• Non fans reach: content/reach_non_fan/lifetime

• Non fans impressions: content/impressions_non_fan/lifetime

• Video views (complete): content/video_views_complete/lifetime

• Video viewers (complete): content/video_viewers_complete/lifetime

• Video views (30s): content/video_views_30s/lifetime

• Measure API V1 is deprecated. These are all endpoints containing "measure/api/v1" in their path.

• The documentation for Measure API V1 is removed.

• Fixed a link to the help center in Engage Export API.

• Update Publishing API to contain Placement field for all network types.

• Announcing change in field requirements, starting from 2023-03-01 Placement will be a required field for all content types.

• Added Measure API V2

• Announce 3 months deprecation period for Measure API V1. The following endpoints will be decommissioned on 2023-02-01: Get Facebook and Instagram Page insights metrics; Get content metrics by channel ids; Get content metrics by content ids; Get Instagram Content

• Updated documentation on CarouselMedia of Instagram drafts.

• Updated documentation on targeting for LinkedIn drafts.

• Made publisher optional for Instagram posts. Many of the formats can be published directly, without falling back to the mobile app.

2022-08-02

• Support for Instagram Reels has been added

• Support for placement are added

• Content can be filtered by placements

See Instagram drafts and Channel Content for more details.

• Support for TikTok drafts has been added

2022-08-01

• LinkedIn draft updated to include multi image posts.

• The API documentation for Classic Listen has been removed.

• Twitter as a network has been re-introduced in Engage Export API. To be able to use the network, the calling organization must be pre-approved to do so.

• Documentation relative to the deprecated Content Pool API has been deleted.

• Documentation relative to the deprecated Approval flow endpoints and payload has been deleted.

• To remain compliant with Section 3.1.F of the LI Marketing Developer Terms, all LinkedIn data is removed from Engage Export and LinkedIn is not available anymore as network parameter.

• The Approval object from all the Publishing endpoints payloads has been ´deprecated´ and will stop being accepted in 60 days.

• The "Send for approval" endpoint has been deprecated. It will be removed in 60 days and for the time being it won't be replaced.

• The "Schedule draft" endpoint has been deprecated and is replaced by this new endpoint. It will be removed in 60 days.

• New Content Pool API added. Check here.

• Old Content Pool API marked as deprecated

Falcon is working on delivering an improved Measure API V2 endpoints during 2022. For this reason, from July 2021 onwards, the following endpoints are deprecated and no new customers will be able to receive data from them:

• Get Facebook and Instagram Page insights metrics

• Get content metrics by channel ids

• Get content metrics by content ids

• Added Twitter engagements stats to metrics API in Listen. Here: Get Topic metrics

• Expose new payload to return appended SRT files for video templates.

• Expose new payload to append SRT files to Templates.

• Twitter network is removed from Engage Export API.

• The link on the description of the fields in Engage Export API was added.

• uuid field is added to the response of Get channels endpoint.

Engage Export API was added. The API provides an opportunity to retrieve Engage Export that is available on the web version of Engage through REST. The API contains two endpoints that allow to request the export and check its status.

These changes all apply to Channel Content API and Get copies API:

• Remove documentation for twitter-only fields: retweetProperties

• Group facebook-only properties under a new field facebook. We also added a new field to this object hideLastCard

• Field publishingId renamed to originPublishing.

• Field tags renamed to labels.

• Field link replaced by links to support Carousels posts.

• Fields channel and channels are both replaced by externalChannels.

• Map missing fields

These changes all apply to Templates API:

• Remove documentation for twitter-only fields: retweetProperties

• Group facebook-only properties under a new field facebook. We also added a new field to this object hideLastCard

• Field publishingId renamed to originPublishing.

• Field tags renamed to labels.

• Field link replaced by links to support Carousels posts.

• Fields channel and channels are both replaced by externalChannels.

• Map missing fields

It is now possible to define an embargoDate and expirationDate fields when creating or updating Publish Templates. It is also possible to retrieve these two fields when getting a Template by ID or a list of templates.

Add video field to content of LinkedIn Draft.

Get Channel Content now returns information on where content was copied from. Potential origins are: stock template, existing publication or scheduled publishing.

• Added new endpoint to search for Facebook locations.

• Added new endpoint to search for Instagram locations.

• Added new endpoint to search for Twitter locations.

• Fix place object of Instagram options: Instagram Draft.

• Fix place object of Twitter options: Twitter Draft.

• Deprecated fields removed in Facebook picture payload: picture.fileName, picture.url, picture.originalPicture.

Add place field to Instagram options Instagram Draft.

Add locales field to Facebook Feed Targeting in Facebook Draft and Get Channel Content sections.

Mark single-picture fields in Facebook Draft as deprecated.

Introducing APIs for Content Labeling and Draft Label Handling.

Listen Get Topic Metrics now return the top phrases and their count.

The content metrics facebook/post_video_view_time_by_age_bucket_and_gender/lifetime and facebook/post_video_view_time_by_region_id/lifetime are deprecated as they return totals and not the breakdowns. Please use facebook/post_video_view_time/lifetime instead to get the totals.

We're happy to inform that we have raised the RollingWindowQuota to 900 calls / 15 minutes to better cater to customer needs.

Due to the deprecation of Twitter Insights metrics in Falcon.io API and Google’s announcement that Google+ API’s will be deprecated in 90 days, we have retired the Get Channel insight metrics endpoint. You can still get insights metrics for Facebook and Instagram channels via the endpoints Get Facebook and Instagram Page insights metrics, Get content metrics by channel ids and Get content metrics by content ids

Please note that due to Twitter API policy we are as of 10th of December 2018, unable to provide full data regarding Twitter accounts and published Twitter content. Therefore, only Twitter account IDs and post IDs will be returned along with some internal Falcon.io workflow data for each channel and post. You will also no longer be able to retrieve insights for your Twitter accounts via our API. If you wish to retrieve all this Twitter data and use it in your own application, then we recommend registering your application with Twitter and retrieving it using Twitter API directly.

Get content metrics by content ids endpoint accepts post ids which come from the specified network (facebook or instagram). These post ids are also called "externalIds".

The content metric facebook/post_fan_reach/lifetime has been deprecated in Facebook Graph Api 3.0 Changelog. Please use facebook/post_impressions_fan_unique/lifetime instead.

Provide documentation for Publish get copied content API

Removal of YouTube metrics from the Channel insight metrics API due to YouTube compliance.

Removal of deprecated User and Team performance metrics APIs.

Rename channel and content level metrics according to changes in Facebook Graph Api 3.1 insights

Facebook changed definition of the organic impression both on channel and content level. Facebook Graph Api 2.12 Changelog

Prior to that point, organic did not include viral impressions. This means that the total was: organic + viral + paid.

After this point the viral impressions are also counted in organic impressions. This means that the total now is: organic + paid.

Introduction of object - shorteningUrls types in the body of individual networks Publishing draft APIs.

Functionality for handling labels for published content.

A Publishing is a draft that has been created in Brandwatch but not yet published to the intended social network. Once a draft has been published by the network it becomes a Publication.

Functionality for scheduling, copying and in other ways handling drafts.

Functionality for handling labels for drafts.

Resources for operations on a specific Facebook draft.

Note on Facebook Link Editing When creating or editing Facebook Links, the caption, description & picture fields found under content link in the message body are optional and in fact should be left empty if the URL specified in the link field does not belong to a domain that is claimed by the Facebook page. Publishing Facebook posts with custom link metadata when the link is not claimed by the Facebook page will result in post failure. Learn more here.