Skip to main content

How Do I Integrate the API With My Existing Tools or Dashboards?

Updated over 3 weeks ago

The BrandMentions API is built to plug directly into the tools you already use.
By connecting it to your dashboards, CRM, social tools, and collaboration platforms, you can:

  • Avoid manual exports and copy paste

  • Keep all teams aligned on the same data

  • Automate alerts, reports, and workflows

Core integration pattern

Almost every integration follows the same simple pattern:

  1. Fetch data from the API

    • Use endpoints such as GetProjectMentions, GetProjectInfluencers, GetMentionsCount, GetRemainingCredits.
      ​

  2. Transform the data

    • Clean, filter, and reshape it for your target tool

    • Example: group by date and sentiment before sending to a BI dashboard
      ​

  3. Load the data into another system

    • Insert or update data in your BI tool, CRM, social tool, or chat platform

    • Do this on a schedule or in response to events (callbacks or webhooks)

You can build this with custom scripts or with no code integration platforms.

Common integration scenarios

1. Custom dashboards (Power BI, Tableau, Looker Studio, etc.)

Goal: Show BrandMentions data alongside traffic, revenue, ads, and CRM metrics.


​How to do it:

  1. Write a script or small service that:

    • Calls the BrandMentions API

      • For example:

        • GetProjectMentions for mention lists

        • GetMentionsCount for volume metrics

        • GetProjectInfluencers for influencer rankings

    • Normalizes the JSON into tables (for example mentions, influencers, metrics)
      ​

  2. Load that data into your BI tool:

    • Save as CSV or push into a database that your BI tool reads

    • Or use a direct connector (for example Python connector, custom API connector)
      ​

  3. Schedule the process:

    • Run hourly or daily so charts and reports stay up to date

Result: a single source of truth dashboard where BrandMentions sits next to web analytics, ads, and sales.

2. CRM integration (Salesforce, HubSpot, Pipedrive, etc.)

Goal: Enrich contacts and leads with mentions and social context.
​

Example use cases:

  • Create a new lead when a high value mention appears

  • Attach mentions to existing accounts or contacts

  • Add influencer data to key accounts

How to do it:

  1. Detect new mentions:

    • Poll GetProjectMentions for recent mentions

    • Or use callbacks on project runs and then call GetProjectMentions
      ​

  2. Decide what is CRM worthy:

    • Filter by sentiment, reach, domain influence, or keywords

    • For example, only negative mentions with high reach
      ​

  3. Create or update records:

    • Use your CRM API or a tool like Zapier to:

      • Create a lead or contact

      • Add a note, activity, or custom object that includes the mention URL, text, and sentiment

This gives sales and success teams richer context around customer conversations and brand perception.

3. Social media management tools (Buffer, Hootsuite, Sprout, etc.)

Goal: Turn BrandMentions insights into actionable social tickets.
​

Example use cases:

  • Push negative or urgent mentions into your social engagement inbox

  • Flag influencer mentions for quick replies or outreach

  • Create queues for community managers based on mention type

How to do it:

  1. Fetch mentions from BrandMentions:

    • Use GetProjectMentions

    • Filter by sentiment, social_network, reach, or specific keywords
      ​

  2. Filter and map:

    • Keep only mentions that require human action (for example negative sentiment or questions)

    • Extract fields like URL, author handle, text, sentiment, and reach
      ​

  3. Send to your social tool:

    • Use the social platform’s API or an integration platform to:

      • Create tasks or tickets

      • Add items to a moderation queue

      • Tag content for specific team members

This creates a smooth flow from monitoring to response, without manual copying.

4. Team collaboration tools (Slack, Microsoft Teams, etc.)

Goal: Keep your team informed in real time about important mentions.

Example use cases:

  • Send alerts for crisis related mentions into a specific Slack channel

  • Notify product teams when mentions reference a feature or bug

  • Share influencer or press mentions in a PR channel

How to do it:

  1. Decide what should trigger an alert:

    • High reach mentions

    • Specific keywords (for example your brand plus “bug” or “issue”)

    • Negative sentiment
      ​

  2. Detect new mentions:

    • Use callbacks on searches or projects and then call GetMentions or GetProjectMentions

    • Or poll periodically for recent published dates
      ​

  3. Send a formatted message:

    • Use Slack or Teams webhook or API to post structured alerts:

      • Title, URL, sentiment, source, reach, short snippet

This turns BrandMentions into a real time signal that your teams can act on instantly.

Tools and approaches for integration

Custom scripts and services

Use a programming language you already know (for example Python, Node.js, PHP, Ruby, Java) to build small services that:

  • Call BrandMentions API endpoints

  • Transform the data

  • Call other APIs (CRM, BI, Slack, etc.)

Best for:

  • Complex logic

  • Custom scheduling

  • Tight control over performance and costs

Integration platforms (Zapier, Make, Workato, etc.)

Integration platforms give you a visual way to connect APIs without writing much code.

Typical pattern:

  • Trigger: BrandMentions step (new mentions, scheduled fetch)

  • Filters: conditions on sentiment, reach, keyword, project

  • Actions: create row in a sheet, send to Slack, create CRM lead, update ticket, etc.

Best for:

  • Fast prototypes

  • Simple but powerful workflows

  • Teams with limited developer resources

By integrating the BrandMentions API with your existing tools and dashboards, you can turn raw mentions and analytics into automated, connected workflows that support marketing, sales, product, and PR across your whole organization.

Did this answer your question?