Media Monitoring API - Mentions, Sentiment, Reach, Determ

Export the mentions your Determ (formerly Mediatoolkit) keywords collect across web, news, social media, forums, print, TV and radio into a dataset, a spreadsheet or a warehouse, with sentiment, reach, virality, interactions and influence score on every row. Uses your own Determ API token, never changes anything in your account, and charges only for rows that carry data.

What it collects

• Mentions of any keyword (monitoring query) or whole group you can open: mention ID, source type (web, Facebook, X (Twitter), forums, comments, YouTube, Instagram, Reddit, TikTok, print, radio, TV, Bluesky), title, text snippet, URL, author, influencer, estimated reach, virality score, total interactions, influence score, automatic sentiment, detected languages and locations, matched keywords, image URL and the time it was ingested.
• Documented filters: a preset time range (today, yesterday, last 24 hours, last 7, 30 or 90 days, this or last week, this or last month) or a custom start and end, on the published time or the time the mention entered your feed, plus source types and sentiments to include or exclude.
• Sorting by published time, feed time, reach, virality, interactions, influence or engagement, ascending or descending.
• Mention counts: the total mentions of a keyword or group for the same time range and filters, broken down per source type with each type's share.
• Organizations, groups, keywords and tags: every organization the token reaches, its time zone, state and monthly mention allowance, each group with its keywords, each keyword with its groups, active flag and dates, and the tags, ready to use as IDs in the other modes.
• Account: the user behind the token and their organization roles, never the token itself.
• Read only, pay per result, bring your own token.

Input

Field	What it does
What to read	Organizations (default, needs nothing else), mentions, mention counts or account.
Organization ID	Optional. Picked automatically when the token reaches one organization.
Keyword ID or Group ID	Mentions and mention counts read one keyword, or one group with all its keywords.
Time range, Time range applies to	A preset period or Custom, on the published time or the feed time.
Date start, Date end	Custom range, as YYYY-MM-DD or ISO 8601. The end is exclusive; a plain date includes that day.
Source types, Exclude source types	Any of the 13 documented source types.
Sentiments, Exclude sentiments	Positive, neutral, negative, undefined.
Sort mentions by, Sort direction	Mentions mode.
Maximum results	Row cap for the run.
Requests per minute	Pacing, up to the provider's 100 mention calls a minute.
API token	Your Determ API token, as a secret input, or the DATA_API_KEY secret.

Run the organizations mode first to get keyword and group IDs, then mentions or mention counts with one of them.

Access and limits on the Determ side

• API access is part of selected Determ plans. Each user on such a plan has a static API token under Settings > Account Settings in the Determ app; if the field is not there, the plan does not include the API.
• Mentions are read up to 1,000 per page and paged with a scroll token, so long exports keep going until the time range is exhausted or your maximum is reached.
• The provider allows 100 mention scroll or count calls a minute per user, shared between the keyword and group routes. The actor paces itself and waits the time the provider asks for when it is rate limited.

FAQ

What is a media monitoring API used for?

Getting the mentions a monitoring platform collects out of its dashboard and into your own tools. A PR team pulls every negative mention of the brand from the last day with reach and URL into a response queue. An analyst exports a quarter of print, TV and radio mentions for a coverage report. A data team loads daily mentions per source type into a BI dashboard to track share of voice against competitor keywords.

Which data source does this actor read?

The Determ API at api.mediatoolkit.com, the public API of Determ (formerly Mediatoolkit), documented at developers.determ.com. It calls the user, organization, mention scroll and mention count routes. The documentation and the live host were checked on 2026-10-04.

Do I need a Determ account?

Yes. This actor is bring-your-own-token and never ships one. Your Determ plan must include API access; copy the API token from Settings > Account Settings. A missing or refused token ends the run cleanly with a message saying which it was.

How do I export new mentions incrementally?

Use the mentions mode with "Time range applies to" set to the feed time, sort by feed time ascending, and set the date start to the time of your previous run. Mentions that arrive late in your feed are then never missed.

Can I get mention volume per channel?

Yes. The mention counts mode returns the total mentions of a keyword or group for the chosen time range and filters, plus one row per source type (web, print, TV, radio, each social network) with its count and share of the total.

Can this actor change anything in my Determ account?

No. It reads only. The scroll and count calls are POST requests because Determ takes the query as a JSON body, but they change nothing. The keyword create and delete routes, which would add a query or permanently remove one and its mentions, are not used. The token is never logged and is stripped from any error text.

How is it priced?

Pay per result: one price per mention, a lower price per count row, and the lowest per organization, group, keyword, tag or account row. Requests that find nothing are free. Your Determ subscription applies separately.

Example output

{
  "mode": "mentions",
  "modeLabel": "Mentions",
  "recordType": "mention",
  "organizationId": "100",
  "keywordId": "5001",
  "groupId": null,
  "found": true,
  "id": 987654321,
  "name": "TechNews",
  "date": "2024-01-15T10:00:00.000Z",
  "sourceType": "WEB",
  "sentiment": "POSITIVE",
  "author": "TechNews",
  "title": "Example Brand announces new factory",
  "snippet": "Example Brand has announced plans to build a new factory...",
  "url": "https://example.com/article/new-factory",
  "reach": 50000,
  "interactions": 1200,
  "influenceScore": 78,
  "virality": 0.85,
  "type": "WEB",
  "mention": "Example Brand has announced plans to build a new factory...",
  "interaction": 1200,
  "autoSentiment": "POSITIVE",
  "languages": ["en"],
  "locations": ["US"],
  "keywords": ["Example Brand"],
  "insertTime": 1705312800000,
  "insertedAt": "2024-01-15T10:00:00.000Z",
  "language": "en",
  "location": "US",
  "value": null,
  "totalCount": null,
  "retrievedAt": "2026-10-04T09:14:52.118Z",
  "note": null
}

Values are illustrative; every field is one the provider documents. Count rows carry sourceType, value (the count), totalCount and share; keyword rows carry groupIds, groupNames, active and editedAt.

Keyword map

media monitoring API, media mentions API, news monitoring API, social media monitoring API, broadcast monitoring, print TV radio monitoring, brand mentions export, sentiment analysis data, reach and virality, share of voice, PR monitoring data, Determ API, Mediatoolkit API, Determ mentions export.