Skip to main content

FAQs: Social Media Management APIs

APIs (Application Programming Interfaces) allow you to connect Social Media Management (SMM) with other tools and systems. You can use APIs to automate tasks such as exporting data, managing channels, or retrieving performance metrics without logging into the platform.

In this article, you’ll find answers to common questions about SMM APIs, including how they work, how to access them, and what limitations apply.

Note: Please be aware that we do not provide technical support for setting up APIs or integrating our data into third‑party tools or systems. You will need an in-house developer or technical resource in your organization to review our API documentation and set up and maintain the integration within your own systems.


General API FAQs

What is an API?

An API (Application Programming Interface) allows different systems to share data with each other automatically.

You can use Brandwatch APIs to:

  • Export data from Social Media Management

  • Connect the platform to other tools or workflows

  • Automate repetitive tasks using code

Instead of manually working in the platform, APIs allow you to perform these actions more quickly and at a larger scale using code.

What APIs don't do:

APIs are not tools with a visual interface.

Unlike the SMM platform:

  • APIs do not include dashboards or reports

  • APIs cannot be used without setup

  • APIs require developer knowledge to build and maintain

What does REST API mean?

Brandwatch APIs use a REST API (Representational State Transfer), which is a standard way systems communicate over the web.

The REST API offers flexibility, including:

  • Common API web requests (such as GET and POST)

  • They can be used with most programming languages

  • They can connect to many third‑party tools


SMM API FAQs

Can Brandwatch build an API integration for my organization?

Brandwatch does not currently offer services to build API integrations for your organization.

To use APIs successfully, you should:

  • Have access to a developer or technical team

  • Plan for ongoing maintenance of your integration

Is the data from APIs different from the data in the platform?

The data provided through Social Media Management APIs is the same as the data available in the platform.

APIs retrieve data directly from the platform’s database, so there is no difference in data quality or coverage.

Note: Please be aware that due to API limitations and many factors, there may always be data discrepancies when comparing what displays on the native networks to what displays in the platform or our APIs.

What is an API key?

An API key is a unique identifier that allows your application to access the API.

When you use an API key:

  • The system can identify who is making requests

  • Access can be controlled and secured

Warning: Always keep your API key private. If it is shared, others could use it to access your data.

How can I access Social Media Management APIs and create API keys?

To access Social Media Management APIs:

  • API access must be enabled by your Customer Success Manager (CSM) or Account Manager (AM)

  • Once enabled, you can create up to five API keys in Settings > Integrations & APIs

Note: The Benchmark API requires additional enablement. Contact your Customer Success Manager (CSM) or Account Manager (AM) if you want access.

Why do I have multiple API keys?

Each API key is typically used for a different use case. For example, one API key could be used to publish content while another API key could be used for benchmarking, etc.

If you have five API keys:

  • You can connect up to five separate applications

Using multiple keys helps you:

  • Separate different integrations

  • Manage access more securely

  • Monitor usage more easily

Can I get more API keys or increase rate limits?

It is not currently possible to increase the number of API keys or rate limits by default.

If you need changes, contact your Customer Success Manager (CSM) or Account Manager (AM) and they can advise on available options.

Is my API connection secure?

Brandwatch follows strict security and privacy practices to protect your data.

To keep your API connection secure:

  • Do not share your API key outside your team

  • Store your API key safely

  • Rotate your API keys if needed

Are there limits on API calls?

API usage is limited to ensure fair use and platform stability.

Each API key includes:

  • Up to 43,200 API calls per month

With five API keys, you can make up to:

  • 216,000 API calls per month

What happens if I reach my API call limit?

If you reach your monthly API call limit:

  • You will not be able to make additional requests

  • Your limit will reset at the start of the next month

For more details, see our technical documentation on rate limits.

Can I use one API key for multiple APIs?

You can use one API key to access multiple Social Media Management APIs.

However, it is best practice to use separate API keys for different use cases (for example, one key for publishing and another for reporting).

Using separate keys helps you:

  • Track usage more easily

  • Avoid hitting limits across all integrations

  • Improve security by isolating access

Can I access Listen or Influence data using SMM APIs?

Social Media Management APIs do not provide access to Listen or Influence data.

To access this data:

  • You need to use the Consumer Research API

Engage API FAQs

Can I export Engage data into Consumer Research?

You can export Engage data and upload it into Consumer Research using the Data Upload API.

To do this:

  • Export Engage data using the API

  • Transform the data into the required format

  • Upload it into Consumer Research

This process requires a custom script and developer support.

Measure API FAQs

What are the data limits for the Measure API?

The Measure API can return up to two years of historical data.

However:

  • Data must be requested in three‑month increments

For example:

  • To retrieve two years of data, you must make eight separate requests (one per three months)

How can I avoid exceeding API limits when using the Measure API?

To avoid exceeding API limits:

  • Break large requests into smaller time ranges

  • Only request the data you need

  • Follow best practices in the Measure API guides

For more information, see:

Why am I not seeing metrics for images in Facebook carousel posts?

If you are not seeing metrics for images in Facebook carousel posts, this is expected behavior.

The Measure API:

  • Provides metrics at the post level

  • Does not provide metrics for individual images within a post

Benchmark API FAQs

Do I need to connect channels in the platform to use the Benchmark API?

You do not need to manually connect channels in the platform.

  • The API allows you to add and remove channels programmatically.

  • However, you must have available channel slots to add new channels.

Can I retrieve social handle data from different platforms?

You can retrieve social handle data from:

  • X (Twitter)

  • Facebook

  • Instagram

  • YouTube

Note: For X (Twitter), only links are available instead of post text due to X (Twitter)’s data sharing restrictions.

Can I use the Benchmark API to analyze competitors?

You can use the Benchmark API to compare your performance against competitors.

To do this:

  • Add competitor channels to monitor

  • Use the API to retrieve performance metrics

For more information, see:

Did this answer your question?