Skip to main content

​
Author

Represents an author or influencer who creates mentions across various sources.
​
id
string
Unique identifier for the author
​
name
string
Display name of the author
​
username
string
Username or handle on the source platform
​
profile_url
string
URL to the author’s profile page
​
avatar_url
string
URL to the author’s avatar or profile image
​
followers_count
integer
Number of followers the author has
​
following_count
integer
Number of accounts the author follows
​
influence_score
number
Calculated influence score (0.0 to 100.0)
​
mentions_count
integer
Total number of mentions from this author
​
source
string
Primary source platform (e.g., “twitter”, “instagram”)
​
created_at
string
ISO 8601 timestamp when the author was first tracked
​
updated_at
string
ISO 8601 timestamp when the author data was last updated

​
Example

{
  "id": "author_1234567890",
  "name": "Jane Smith",
  "username": "janesmith",
  "profile_url": "https://twitter.com/janesmith",
  "avatar_url": "https://pbs.twimg.com/profile_images/123/avatar.jpg",
  "followers_count": 54200,
  "following_count": 890,
  "influence_score": 78.5,
  "mentions_count": 23,
  "source": "twitter",
  "created_at": "2025-06-15T10:00:00Z",
  "updated_at": "2026-03-04T08:00:00Z"
}

​
AuthorStats

Statistics for a specific author’s mentions.
​
author_id
string
required
ID of the author these stats belong to
​
mentions_count
integer
default:"0"
Total number of mentions from this author
​
reach
integer
default:"0"
Total reach across all mentions
​
engagement
integer
default:"0"
Total engagement (likes, shares, comments)
​
sentiment_positive
integer
default:"0"
Number of positive mentions
​
sentiment_negative
integer
default:"0"
Number of negative mentions
​
sentiment_neutral
integer
default:"0"
Number of neutral mentions

​
Example

{
  "author_id": "author_1234567890",
  "mentions_count": 23,
  "reach": 54200,
  "engagement": 1847,
  "sentiment_positive": 18,
  "sentiment_negative": 2,
  "sentiment_neutral": 3
}

​
Response Models

​
AuthorsResponse

Response containing a list of authors.
​
authors
array
required
List of Author objects
​
total
integer
Total number of authors available

​
AuthorStatsResponse

Response containing author information with statistics.
​
author
object
Author object with details
​
stats
object
AuthorStats object with aggregated metrics

​
Example

{
  "author": {
    "id": "author_1234567890",
    "name": "Jane Smith",
    "username": "janesmith",
    "profile_url": "https://twitter.com/janesmith",
    "followers_count": 54200,
    "influence_score": 78.5
  },
  "stats": {
    "author_id": "author_1234567890",
    "mentions_count": 23,
    "reach": 54200,
    "engagement": 1847,
    "sentiment_positive": 18,
    "sentiment_negative": 2,
    "sentiment_neutral": 3
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us