Social Listening API - Brand24 Mentions, Sentiment, Topics

Pull the social listening and media monitoring data of your own Brand24 projects into a spreadsheet, warehouse or dashboard: every mention with its sentiment and source, daily volume, reach and engagement, AI topics, detected spikes, AI summaries, influencers, top domains, hashtags and audience demographics.

What it collects

• Mentions: one row per mention with date, time, title, content (up to 250 characters), URL, host, source category, sentiment and your tags. Filter by date range, sentiment (positive, negative, neutral) and source category (news, blogs, web, podcasts, videos, TikTok, X, Facebook, Instagram, other social networks). Paged through with the provider's cursor, 500 at a time.
• Daily mention volume, sentiment and reach: one row per day with mention count, positive, negative and neutral counts, and social and non-social reach.
• Daily metrics: one row per day with mentions, reach, sentiment split and reach by sentiment, likes, comments, shares and advertising value equivalent (AVE), optionally for one source and with a per-source breakdown.
• AI analysis: AI-detected topics with reach, sentiment and share of voice; detected events (spikes) with peak mentions, peak reach and an AI description; the AI summary; AI insights.
• Sources and people: influential authors by followers or mentions with an influencer score filter, popular domains with visits and influence score, most active sites, trending links, trending hashtags, hot hours and audience demographics.
• Setup: project keywords, the projects of an account, and the account's projected mention usage for the billing period.
• Read only, pay per result, bring your own key.

Input

Field	What it does
What to read	Mentions (default), daily volume, daily metrics, AI topics, events, AI summary, AI insights, influential authors, popular domains, most active sites, trending links, trending hashtags, hot hours, demographics, project keywords, projects of an account, or projected usage.
Project ids	One Brand24 project id per line.
Account id	Projects only: the account whose projects to list.
Start date, End date	Date range as YYYY-MM-DD. Mentions and daily volume default to the last 30 days. Daily volume, daily metrics, AI summary and AI insights allow at most 31 days.
Sentiment	Mentions only: positive, negative and or neutral.
Source categories	Mentions only: news, blogs, web, podcasts, videos, TikTok, X, Facebook, Instagram, other social networks.
Metrics source, Per-source breakdown	Daily metrics only.
Event order	Detected events only: newest or oldest first.
Author order, Minimum influencer score	Influential authors only.
Maximum results	Row cap for the run.
Requests per minute	Pacing for calls to the provider.
API key	Your own Brand24 API Data key, as a secret input.

Example output

A mention:

{
  "service": "mentions",
  "serviceLabel": "Mentions",
  "requested": "123456789",
  "found": true,
  "projectId": "123456789",
  "dateFrom": "2026-09-01",
  "dateTo": "2026-09-30",
  "date": "2026-09-27",
  "time": "14:32",
  "title": "Acme launches its new trail running shoe",
  "content": "Acme today announced a lighter trail running shoe aimed at ultra runners, with a recycled upper and...",
  "url": "https://news.example.com/acme-trail-shoe",
  "tweetId": null,
  "host": "news.example.com",
  "category": "news",
  "sentiment": "positive",
  "sentimentScore": 1,
  "tags": ["launch"],
  "retrievedAt": "2026-10-01T09:14:52.118Z",
  "note": null
}

A day of daily metrics:

{
  "service": "dailyMetrics",
  "projectId": "123456789",
  "date": "2026-09-27",
  "mentionsCount": 320,
  "reach": 540000,
  "positiveMentions": 112,
  "negativeMentions": 64,
  "neutralMentions": 144,
  "likes": 2100,
  "comments": 340,
  "shares": 95,
  "ave": 12345.6,
  "sentimentShare": { "positive": 0.35, "neutral": 0.45, "negative": 0.2 }
}

Values are illustrative.

FAQ

What is this social listening API used for?

Moving brand monitoring data out of Brand24 and into the tools a team already uses. A PR team exports every negative news and blog mention of the week into Google Sheets for triage. A marketing analyst loads daily mentions, reach, engagement and AVE into BigQuery or Looker Studio to report share of voice. A brand manager tracks spikes, AI topics and the most influential authors after a product launch. An agency pulls the AI summary of each client project into a monthly report.

Which data source does this actor read?

The Brand24 API Data service at api-data.brand24.com, through the read routes of its public OpenAPI documentation at api-data.brand24.com/api-data-docs/documentation: projects list, mentions, mention count, sentiment and reach, daily metrics, project events, topics, AI summary, AI insights, domains, trending links, trending hashtags, demographics, most active sites, hot hours, most followers, keywords and mentions usage estimation. The one documented write, create project, is not used.

Do I need a Brand24 account and API key?

Yes. This actor is bring-your-own-key and never ships one. It reads projects that already exist in your Brand24 account, with the API Data key shown at app.brand24.com/account/integrations-api-data. Paste it into the input, or set it once as the DATA_API_KEY environment secret. It is sent only in the X-Api-Key header to the API host. A missing or refused key ends the run cleanly with a message saying which it was.

Can it monitor a keyword or brand that is not set up in Brand24?

No. The provider's API reads the projects you have set up in the Brand24 web app, with their keywords. To monitor a new brand or keyword, create a project in Brand24 first, then read it here.

Why are some Facebook, Instagram and X mentions missing their text?

The provider blanks them under those platforms' terms. Facebook and Instagram mentions come without title, content and URL; X mentions come with the tweet id in tweetId. Date, host, category, sentiment and tags are always present.

How do I find my project ids?

Pick the projects service and enter your account id: it returns every project id and name in the account. Then put the project ids, one per line, into the project ids input.

What happens when a project has no data?

It becomes its own row with found: false and a note: no mentions in the range, topic analysis not enabled, or a project id the key cannot see. Those rows are never charged.

How is it priced?

Pay per result. Each mention is one price; each analytics record (a day of metrics, a topic, event, insight, author, domain, link, hashtag, hot hour, demographics profile, keyword set, project or usage forecast) is another. Rows for project ids that produced nothing are free. Your Brand24 subscription applies separately.

Pricing

Event	Price
Mention returned	$0.005 per mention
Analytics record returned	$0.01 per record

Keyword map

social listening API, media monitoring API, brand monitoring API, brand mentions export, mention tracking, sentiment analysis data, share of voice, online reputation monitoring, influencer discovery, hashtag tracking, news monitoring, PR monitoring, Brand24 API, Brand24 mentions export, Brand24 API Data.