These docs are for v1.0. Click to read the latest docs for v2.0.

Data Restrictions

There are contractual obligations which may affect the metadata of the Mentions returned through the API.

Data Pack restrictions

Particular Data Packs that you have added to your account may have restrictions on the Mention data that you can retrieve through the Brandwatch API. This can cause discrepancies between the data seen in the UI of the Analytics application and the data retrieved via the API. For specific information on the data packs that you have, please contact your account manager.

Twitter Data

We are unable to provide the full metadata of Mentions from Twitter. Any Mention that is a Tweet will have the full text and some other metadata stripped out. If you wish to include the full metadata in your own application, then we recommend registering your application with Twitter, parsing the Twitter ID from the url field, and then using the Twitter API to retrieve it.

The metadata that will be missing are as follows:

  • author
  • avatarUrl
  • date
  • displayUrls
  • expandedUrls
  • fullText
  • influence
  • insightsHashtag
  • outreach
  • reach
  • replyTo
  • retweetsOf
  • shortUrls
  • snippet
  • threadAuthor
  • threadEntryType
  • twitterAuthorId
  • twitterFollowers
  • twitterFollowing
  • twitterPostCount
  • twitterReplyCount
  • twitterRetweets
  • twitterRole
  • twitterVerified