Mention
Represents a single mention from social media, news, blogs, or other sources.
Unique identifier for the mention
Title or headline of the mention
Full description or content of the mention
Shortened description or excerpt
URL to the original source
Name of the source (e.g., “Twitter”, “New York Times”)
Type of source (e.g., “twitter”, “news”, “blog”)
Sentiment/tone of the mention: positive, negative, or neutral
Author information
Unique identifier for the author
Display name of the author
URL to the author’s profile
URL to the author’s avatar image
Number of accounts following
Calculated influence score (0.0 to 100.0)
List of tags associated with the mention
Unique identifier for the tag
Hex color code for the tag
Whether the mention is marked as favorite
Whether the mention has been read
Whether the mention is in the trash
ISO 8601 timestamp when the mention was published
Estimated reach of the mention
Engagement metrics (likes, shares, comments, etc.)
Language code of the mention (e.g., “en”)
Country code where the mention originated (e.g., “US”)
URL to an associated image
URL to an associated video
ISO 8601 timestamp when the mention was created in Mention
ISO 8601 timestamp when the mention was last updated
Tone Enum
Sentiment values for mentions:
positive - Positive sentimentnegative - Negative sentimentneutral - Neutral sentiment
Example
{
"id": "mention_1234567890",
"title": "Great product review",
"description": "I've been using this product for a month and it's amazing!",
"description_short": "Great product after a month of use",
"original_url": "https://twitter.com/user/status/123456",
"source_name": "Twitter",
"source_type": "twitter",
"tone": "positive",
"author": {
"id": "author_123",
"name": "Jane Smith",
"username": "janesmith",
"profile_url": "https://twitter.com/janesmith",
"avatar_url": "https://pbs.twimg.com/profile_images/123/avatar.jpg",
"followers_count": 5420,
"following_count": 890,
"influence_score": 72.5
},
"tags": [
{
"id": "tag_1",
"name": "Product Reviews",
"color": "#3B82F6"
}
],
"favorite": false,
"read": true,
"trashed": false,
"published_at": "2026-03-04T07:30:00Z",
"reach": 5420,
"engagement": {
"likes": 42,
"retweets": 8,
"replies": 3
},
"language": "en",
"country": "US",
"image_url": "https://example.com/image.jpg",
"video_url": null,
"created_at": "2026-03-04T07:35:00Z",
"updated_at": "2026-03-04T08:00:00Z"
}