Change Log

All notable changes to this project will be documented in this file.

Only the 2 first figures are used to define the version you want to use in requests. Indeed, third figure indicates bug fixes and are automatically applied to their major.minor version.

1.21 - 06/09/2023

  • In the endpoints POST accounts/{account_id}/alerts and POST /accounts/{account_id}/dashboards, the group_id query string parameter is now always mandatory. Before, this parameter could be omitted when the caller had only 1 group.
  • The alert resource now exposes an empty stats field by default. To fetch basic statistics about an alert, pass the stats query string parameter with a comma-separated list of one or more of,,,,,,,, todo_tasks, done_tasks,

1.19 - 31/03/2020

  • Deprecation of Gender chart dimension for API starting version 19
  • Soft deprecation of Gender dimension for all prior versions.

1.18 - 19/12/2018

  • Internal changes

1.17 - 31/07/2018

  • Changed the format of the FacebookAccount resource:
    • Add business_management_permission attribute
  • Changed the format of the InstagramBusinessAccount resource:
    • Add business_management_permission attribute

1.16 - 24/05/2018

  • Changed the format of the Plan resource:
    • Remove the influencer_dashboard_access attribute
    • Add influence_access and influence_advanced attributes

1.15 - 05/07/2017

  • The color attribute is now defined at the Alert level, not the Alert Share.

1.14 - 14/03/2017

  • The source filter is now only available to plans with search acccess.

1.13 - 09/11/2016

  • Changed the format of the Twitter interactions:
    • Added the full_text attribute
    • Remove the text attribute

1.12 - 08/09/2016

  • Changed the format of the Account resource:
    • Added the permissions attribute
  • Changed the format of the TeamMember resource:
    • Removed the admin attribute and added the kind attribute (admin|user|restricted)
    • Added the permissions attribute

1.11 - 29/04/2016

  • Possibility to add multiple monitored facebook pages and twitter accounts instead of one.
  • Changed the format of the Alert resource:
    • Added the monitored_facebook_pages and monitored_twitter_accounts attributes
    • Remove the monitored_facebook_page and monitored_twitter_account attributes
    • monitored_facebook_pages and monitored_twitter_accounts must have a type attribute and other attributes described into PostAlert.

1.10 - 10/03/2016

  • unreleased

1.9 - 10/03/2016

  • The alerts endpoint is now paginated, and returns 20 alerts by default

1.8 - 22/01/2016

  • introduces concept of folders: inbox, archive, spam, trash.
  • Changed the format of the Alert resource:
    • Added the query attribute
    • Removed the primary_keyword attribute
    • Moved the included_keywords, required_keywords, excluded_keywords attribues in the query attribute when query.type is basic
  • Changed the format of the Mention resource:
    • Changed the format of the children attribute to make it paginatable
    • Removed the url attribute. Use clickable_url, displayable_url, or orignal_url instead
    • Added a folder attribute
    • Added a folder filter
  • Changes in the app/data endpoint:
    • alert_sources now have a hidden attribute


  • first version of mention.