Cision Mentions API
The mentions API from Cision — 1 operation(s) for mentions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cision-mentions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: CisionOne Mentions API
description: API
version: '2'
x-apievangelist-note: info.title and info.version are absent from the spec Cision publishes at https://developers.cision.one/docs/api/v2; supplied here by API Evangelist from the provider docs. See overlays/cision-cisionone-overlay.yaml.
servers:
- url: https://api.cision.one
description: 'Production. Base host stated in Cision''s own help docs ("All CisionOne API calls are made under https://api.cision.one"); absent from the published spec. Verified: GET https://api.cision.one/public/api/v2/streams returns 401.'
tags:
- name: mentions
paths:
/public/api/v2/mentions/{streamId}:
get:
tags:
- mentions
summary: Returns a list of mentions for a stream
operationId: getMentions
parameters:
- name: X-Auth-Token
in: header
description: The API Token
required: true
schema:
type: string
- name: streamId
in: path
description: The stream to search on
required: true
schema:
type: integer
- name: filter[range][after]
in: query
description: The beginning of the date range to search. The requested date range (before - after) must not exceed 366 days.
required: true
schema:
type: string
format: date-time
- name: filter[range][before]
in: query
description: The end of the date range to search. The requested date range (before - after) must not exceed 366 days.
required: true
schema:
type: string
format: date-time
- name: pagination[page]
in: query
description: The page of the results to return
required: true
schema:
type: integer
default: 1
- name: pagination[page_size]
in: query
description: The number of results to return per page. The combined value of page and page_size cannot exceed the maximum results of 5000 mentions
required: true
schema:
type: integer
default: 10
maximum: 5000
- name: sort[field]
in: query
description: The field to sort by
schema:
type: string
enum:
- advertisement_rate
- audience
- domain_authority
- impact_score
- sentiment
- source.name
- timestamp
- word_count
- name: sort[order]
in: query
description: The order to sort by
schema:
type: string
enum:
- asc
- desc
- name: format
in: query
description: JSON or CSV
required: true
schema:
type: string
enum:
- json
- csv
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Mention'
example:
- id: 1233
type: onlineArticle
timestamp: 1722470400194
createdAt: '2024-08-02T02:08:26.000Z'
publishedAt: '2024-08-02T02:08:26.000Z'
medium: Online
title: A particularly interesting article title
author: Article Author
url: https://example.com/articles/foo.html
internalLink: https://items.cision.one/ASDASDASDASD
source: Sydney Morning Herald
timeZone: Australia/Sydney
locationCountry: Australia
locationState: New South Wales
locationCity: Sydney
languageCode: en-AU
sentiment: -0.1
keywords:
- foo
- bar
wordCount: 2493
audience: 250000
advertisingValue: 100
impactScore:
- score: 223.92
grade: Medium
domainAuthority: 75
social:
x: 50
facebook: 10
reddit: 3
pinterest: 0
excerpt: This is the excerpt of the article.
- id: 104
type: radioClip
timestamp: 1718418776104
createdAt: '2025-11-27T21:16:50.000Z'
publishedAt: '2024-06-15T12:32:56.000+10:00'
medium: Radio
author: Test
url: http://radio_clip_url6
internalLink: https://items.cision.one/RA00000104
source: RadioStation19
timeZone: Australia/Sydney
locationCountry: Australia
locationState: New South Wales
locationCity: Sydney
languageCode: en-AU
sentiment: -0.1
keywords:
- foo
- bar
wordCount: 2493
audience: 250000
advertisingValue: 100
impactScore:
- score: 223.92
grade: Medium
domainAuthority: 75
localViewershipAudience: 50000
nationalViewershipAudience: 100000
localViewershipAdValue: 250.51
nationalViewershipAdValue: 500.751
transcript: This is the transcript of the clip.
archivedLink: https://example.com/archived-broadcast-link
text/csv:
schema:
type: array
items:
$ref: '#/components/schemas/Mention'
'400':
description: Invalid request parameters (for example, requested results exceed 5000 mentions or requested date range exceeds 366 days)
'401':
description: Unauthorized User or Invalid Token
'403':
description: Token does not have access to the API
'404':
description: Invalid streamId
'429':
description: Too Many Requests
security:
- api_key:
- read:api
components:
schemas:
Mention:
type: object
properties:
id:
type: integer
format: int64
timestamp:
type: integer
format: int64
createdAt:
type: string
format: date-time
publishedAt:
type: string
format: date-time
medium:
type: string
title_summary:
type: string
author:
type: string
removed:
type: boolean
url:
type: string
description: Public URL for the mention when available. Not present for tweet mentions.
internalLink:
type: string
source:
type: string
timeZone:
type: string
locationCountry:
type: string
locationState:
type: string
locationCity:
type: string
languageCode:
type: string
wordCount:
type: integer
format: int64
sentiment:
type: number
keywordCounts:
type: array
items:
type: object
properties:
keyword:
type: string
count:
type: integer
format: int64
audience:
type: integer
format: int64
advertisingValue:
type: number
impactScore:
type: number
localViewershipAudience:
type: number
description: Local viewership audience
nationalViewershipAudience:
type: number
description: National viewership audience
localViewershipAdValue:
type: number
description: Local viewership advertising value
nationalViewershipAdValue:
type: number
description: National viewership advertising value
transcript:
type: string
description: Transcript of the clip
archivedLink:
type:
- string
- 'null'
description: 'Shareable private link to the archived broadcast. Only present for tveyes-broadcast content.
'
excerpt:
type:
- string
- 'null'
description: 'Excerpt/summary of the mention. Present for Online, Print, and Magazine content when the relevant feature flag (report_online_summary for online, report_print_summary for print/magazine) is enabled for the organisation. Null when the feature is disabled or the content type does not support it.
'
xml:
name: Order
securitySchemes:
api_key:
type: apiKey
name: X-Auth-Token
in: header