Social Media Monitoring API - Mentions, Sentiment, Talkwalker

Export the mentions, sentiment, reach and trend data your Talkwalker projects collect into a dataset, a spreadsheet or a warehouse, with one row per mention, histogram bin or influencer. Uses your own Talkwalker API token, never changes anything in your account, and charges only for rows that carry data.

What it collects

• Mentions (documents) from any project, over its full history, or from the 30 day global index: URL, title, content and snippet, publication date, source type (online news, blogs, forums, X, YouTube and more), language, sentiment score, reach, engagement, author name, gender and profile, source site, country, region and city, matched topics, custom tags, hashtags, images and per network engagement counts.
• Real Talkwalker query syntax: boolean operators, lang:, sourcetype:, published:> and the other modifiers, plus the time range (7d, 3M), timezone, sort field and order, highlighting, and the project topics, filters, channels, source panels and Customer Intelligence datasets.
• Histograms: mention volume over time by hour, day or week, optionally broken down by sentiment, source type, country, topic or channel, a nested metric such as engagement, and distributions by language, country, region, city, gender, age, themes, trending themes, hashtags, mentioned accounts, emoji, interests and occupations. Forecasts on projects that have them.
• Top influencers: the top 100 authors or sources of a project, ranked by mentions, sentiment, reach or engagement, with their network and matched topics.
• Project setup: topics and filters with their included and excluded queries, resource IDs (topics, filters, pages, events, panels) and custom tags.
• Export results: the status and progress of your export tasks, your streams and collectors, and the documents an export task has queued in a collector, with the resume offset for the next run.
• Credit balance: monthly and one-time credits used and remaining, the next billing date and six months of history.
• Read only, pay per result, bring your own token.

Input

Field	What it does
What to read	Projects (default, needs nothing else), search results, histogram, top influencers, topics and filters, project resources, custom tags, streams and collectors, export tasks, collector results or credit balance.
Project ID	Needed by top influencers, topics, resources and tags. Search results and histogram read the global index when it is empty.
Query	Talkwalker query syntax, such as tesla AND "electric car" AND lang:en. Required for the global index.
Topic, filter, channel, panel and dataset IDs	Narrow a project read to what is configured in it. The topics and resources modes list the IDs.
Time range, timezone	Search results. 30d, 12h, 2w, 3M.
Sort results by / Sort order	Engagement, published, reach, network metrics, cluster size, comment count, search_indexed or trending score.
Highlight matches	Bold the matched keywords in the snippets.
Histogram type, start, end, interval, breakdown, nested metric, top N, forecast days	Histogram mode.
Influencer type / Rank influencers by	Top influencers mode.
Resource type	Project resources mode.
Export task ID	Export tasks mode: one task, or all recent tasks when empty.
Collector ID / Resume offset	Collector results mode.
Maximum results	Row cap for the run.
Requests per minute	Pacing.
Access token	Your own Talkwalker API access token, as a secret input.

Run the projects mode first, then topics with a project ID, then search results or histogram with the project ID and any topic IDs.

Credits and limits on the Talkwalker side

Talkwalker meters its API in credits, separately from this actor's price:

• Search API: 1 credit per result returned, and at least 10 credits per call. This actor pages with up to 500 results per call so the minimum rarely applies.
• Histogram API: 10 credits per call, whatever the number of bins.
• Streaming and export: 1 credit per document pushed into a collector.
• Credits reset monthly on the subscription day. The credit balance mode costs nothing but is limited to 10 calls a minute.
• Rate limits: 60 search calls and 30 histogram calls a minute inside a project, 240 and 60 outside one.
• A project query returns at most 10,000 results (offset plus page size); the global index returns at most 500 and only the last 30 days.

FAQ

What is a social media monitoring API used for?

Moving monitored conversation out of the Talkwalker dashboard and into your own tools. A brand team exports every negative mention from the last week with reach and author into a support queue. An agency pulls daily mention volume by sentiment for competitor topics into a client report. An analyst feeds Talkwalker documents into a warehouse to join with sales or campaign data. A comms team tracks top influencers and trending themes around a launch.

Which data source does this actor read?

The Talkwalker API at api.talkwalker.com, through the routes documented at developer.talkwalker.com and in its published OpenAPI file: the Search API (project and global results), the Histogram API (project, global and top influencers), the Resources and Topic APIs (topics, resources, custom tags), the Streaming API (stream info and collector reads) and the Export Task API (task status), plus the credit status endpoint. Talkwalker is part of Hootsuite; its API host and developer portal were checked live on 2026-10-02.

Do I need a Talkwalker access token?

Yes. This actor is bring-your-own-token and never ships one. Talkwalker issues API access with an API application on paid plans; your account manager or administrator can give you the access token. Paste it into the input, or set it once as the DATA_API_KEY environment secret. A missing, inactive or refused token, and an account out of credits, each end the run cleanly with a message saying which it was.

How many mentions can one run export?

Up to 100,000 rows per run across modes. One project query returns at most 10,000 results under Talkwalker's paging rule, and the global index at most 500 from the last 30 days. For larger historical exports, create an export task in Talkwalker into a collector, then read it with the collector results mode; it streams the whole queue and logs a resume offset so the next run continues where this one stopped.

Why are some X, Facebook, Instagram or news mentions missing text?

Talkwalker's export rules, not this actor. Facebook and Instagram content cannot be exported at all (only aggregated metrics through the histogram mode), X posts are limited to the post ID, author ID and sentiment unless your account has the X data add-on, online news content is truncated to a snippet with the matched keywords highlighted, and LinkedIn, raw Reddit and raw TikTok documents are not exportable. Histograms still count all of them.

How do I get mention volume by sentiment per day?

Choose the histogram mode, type published, interval day and breakdown sentiment, with your project ID and optionally topic IDs. Each row is one day and one of POSITIVE, NEUTRAL or NEGATIVE, with the count in value. Net sentiment is (positive minus negative) divided by (positive plus negative).

Can this actor change anything in my Talkwalker account?

No. Every call is a GET. The routes that create or delete topics, custom metrics, panels, streams, collectors and export tasks, and the document import and image upload routes, are not used. Talkwalker only accepts the token as a URL parameter; the actor never logs it, and strips it from any error text the provider echoes back.

How is it priced?

Pay per result: one price per mention, a lower price per analytics row (histogram bin or influencer) and per account record (project, topic, resource, tag, stream, task or credit balance). Requests that find nothing are free. Your Talkwalker subscription and credits apply separately.

Example output

{
  "mode": "search",
  "modeLabel": "Search results",
  "recordType": "document",
  "projectId": "a1ab1abc-a123-123a-123a-abcd12ab1a12",
  "found": true,
  "id": "https://www.example-news.com/2026/10/01/example-brand-recall",
  "name": "Jane Example",
  "date": "2026-10-01T08:14:30.000Z",
  "sentiment": -5,
  "sourceType": "ONLINENEWS, ONLINENEWS_OTHER",
  "country": "United States",
  "language": "en",
  "author": "Jane Example",
  "domain": "example-news.com",
  "url": "https://www.example-news.com/2026/10/01/example-brand-recall",
  "title": "Example Brand recalls its new charger",
  "snippet": "...the <b>Example Brand</b> recall affects chargers sold since June...",
  "reach": 7133333,
  "engagement": 2109,
  "matched_profile": ["kpnutesu_5imm9mo4lbsj"],
  "published": 1759306470000,
  "lang": "en",
  "source_type": ["ONLINENEWS", "ONLINENEWS_OTHER"],
  "tags_customer": ["Category / news"],
  "article_extended_attributes": { "facebook_shares": 220, "twitter_shares": 76 },
  "dimension1": null,
  "dimension2": null,
  "value": null,
  "totalHits": null,
  "retrievedAt": "2026-10-02T09:14:52.118Z",
  "note": null
}

Values are illustrative; every field is one the provider documents. Histogram rows carry dimension1 (the time bin or the key, such as a country code), dimension2 (the breakdown label) and value; influencer rows carry posts, reach, engagement and sentimentBreakdown.

Keyword map

social media monitoring API, social listening API, brand mentions API, mentions export, media monitoring data, sentiment analysis data, share of voice, mention volume histogram, top influencers, trending themes, hashtag analytics, consumer intelligence API, Talkwalker API, Talkwalker search API, Talkwalker histogram API, Talkwalker export, Hootsuite Talkwalker data.