# Brandwatch integration

> Brandwatch Consumer Research API for social listening, mentions, queries, topics and analytics charts

- Authentication: apiKey

## Tools (14)

- **Create Category**: Creates a hierarchical category (parent + at least one subcategory) for tagging mentions, with optional auto-apply rules.
- **Create Query**: Creates a new query (boolean keyword search) inside a project to start collecting matching mentions.
- **Create Tag**: Creates a tag in a project. Tags can be manual or driven by automatic keyword rules that match new mentions as they arrive.
- **Get Chart Data**: Retrieves aggregated chart data (volume, sentiment, reach, etc.) for a query broken down by one or two dimensions such as days, sentiment, pageType, countries, or queryGroups.
- **Get Current Client**: Retrieves details about the organization (Client) tied to the access token, including ID, name, contact, limits and rate limit configuration.
- **Get Project**: Retrieves a single project by ID, including its default settings and metadata.
- **Get Topics**: Returns trending and bursting topics extracted from a query's mentions over a date range, with sentiment, volume and daily breakdowns.
- **List Categories**: Lists all categories (and their subcategories) configured in a project.
- **List Projects**: Lists all Brandwatch projects visible to the authenticated user. Use this to discover projectId values needed for almost every other call.
- **List Queries**: Lists queries (saved searches) within a project, optionally filtered by query type such as monitor, twitter, instagram, publicfacebook.
- **List Query Groups**: Lists query groups in a project. Query groups bundle multiple queries together so analytics calls can use a single queryGroupId.
- **List Rules**: Lists automation rules in a project. Rules apply tags or categories to mentions automatically based on filters.
- **List Tags**: Lists all tags defined in a project. Tag IDs are used to filter mention queries.
- **Retrieve Mentions**: Retrieves mentions matched by a query (or query group) within a date range, with optional filters for sentiment, tags, categories, page type, and entity. Supports cursor pagination beyond 10,000 results.

## Related prompts

- [Weekly social listening to Linear research issues](https://www.generalinput.com/prompts/weekly-social-listening-to-linear-research-issues.md)
- [Weekly share-of-voice tracker in Google Sheets](https://www.generalinput.com/prompts/weekly-share-of-voice-tracker-in-google-sheets.md)
- [Turn negative social mentions into Zendesk tickets](https://www.generalinput.com/prompts/turn-negative-social-mentions-into-zendesk-tickets.md)
- [Weekly executive social listening brief](https://www.generalinput.com/prompts/weekly-executive-social-listening-brief.md)
- [Brandwatch crisis early-warning agent for Slack](https://www.generalinput.com/prompts/brandwatch-crisis-early-warning-agent-for-slack.md)

Connect Brandwatch in General Input: https://www.generalinput.com/apps/brandwatch