# Get Influencer report

Influencer contact details are not enabled by default. Contact us to unlock this data for free.  				Every successful request costs 1 credit.

Endpoint: GET /tiktok/profile/{userId}/report
Security: accessToken

## Path parameters:

  - `userId` (string, required)
    User's TikTok handle or user ID from TikTok

## Query parameters:

  - `calculationMethod` (string)
    If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc.
    Enum: "median", "average"

## Response 200 fields (application/json):

  - `error` (boolean)
    If there is an error

  - `profile` (object, required)

  - `profile.userId` (string, required)
    User Id
    Example: "173560420"

  - `profile.profile` (object)
    Influencer Profile

  - `profile.profile.userId` (string)
    User id of the influencer
    Example: "173560420"

  - `profile.profile.fullname` (string)
    Full name of Influencer
    Example: "Instagram"

  - `profile.profile.username` (string, required)
    Username of Influencer
    Example: "instagram"

  - `profile.profile.url` (string, required)
    Profile URL
    Example: "https://www.instagram.com/instagram/"

  - `profile.profile.picture` (string, required)
    Profile Picture
    Example: "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"

  - `profile.profile.followers` (number, required)
    Follower count
    Example: 313560626

  - `profile.profile.engagements` (number, required)
    Engagements
    Example: 857994

  - `profile.profile.engagementRate` (number, required)
    Engagement rate
    Example: 0.0027362938100525414

  - `profile.profile.averageViews` (number, required)
    Example: 98124

  - `profile.audience` (object)
    Audience data

  - `profile.audience.notable` (number, required)
    Example: 0.07

  - `profile.audience.genders` (array, required)

  - `profile.audience.genders.code` (string, required)

  - `profile.audience.genders.weight` (number, required)
    Example: 0.07

  - `profile.audience.geoCountries` (array, required)

  - `profile.audience.geoCountries.name` (string, required)

  - `profile.audience.ages` (array, required)

  - `profile.audience.gendersPerAge` (array, required)

  - `profile.audience.gendersPerAge.male` (number, required)
    Example: 0.07

  - `profile.audience.gendersPerAge.female` (number, required)
    Example: 0.07

  - `profile.audience.languages` (array, required)

  - `profile.audience.notableUsers` (array, required)

  - `profile.audience.audienceLookalikes` (array, required)

  - `profile.audience.audienceReachability` (array)
    Percentage of the audience based on the number of accounts they follow, categorized into specific ranges. For instance, percentage of followers following no more than 500 accounts, or following between 500 and 1000 accounts.
    Example: [{"code":"-500","weight":0.379536},{"code":"500-1000","weight":0.161691},{"code":"1000-1500","weight":0.097547},{"code":"1500-","weight":0.361225}]

  - `profile.audience.audienceReachability.code` (string, required)
    Range of the number of accounts followed
    Enum: "-500", "500-1000", "1000-1500", "1500-"

  - `profile.audience.audienceReachability.weight` (number, required)
    Percentage of the audience
    Example: 0.1

  - `profile.secUid` (string, required)

  - `profile.statsByContentType` (object)
    User stats separated by content type

  - `profile.statsByContentType.all` (object)
    All content type stats
    Example: {}

  - `profile.statsByContentType.all.engagements` (number)

  - `profile.statsByContentType.all.engagementRate` (number)

  - `profile.statsByContentType.all.avgLikes` (number)

  - `profile.statsByContentType.all.avgComments` (number)

  - `profile.statsByContentType.all.statHistory` (array)

  - `profile.statsByContentType.all.statHistory.month` (string)
    Example: "2025-01"

  - `profile.statsByContentType.all.statHistory.avgEngagements` (number)

  - `profile.statsByContentType.all.statHistory.avgViews` (number)

  - `profile.statsByContentType.all.statHistory.avgShares` (number)

  - `profile.statsByContentType.all.statHistory.avgSaves` (number)

  - `profile.statsByContentType.all.avgPosts4weeks` (number)

  - `profile.recentPosts` (array)
    Recent Posts

  - `profile.recentPosts.id` (string, required)

  - `profile.recentPosts.text` (string, required)

  - `profile.recentPosts.url` (string, required)

  - `profile.recentPosts.created` (string, required)

  - `profile.recentPosts.likes` (number)

  - `profile.recentPosts.comments` (number)

  - `profile.recentPosts.views` (number)

  - `profile.recentPosts.video` (string)

  - `profile.recentPosts.thumbnail` (string, required)
    Thumbnail images are sent as TikTok URLs that expire in a few hours and are not accessible in most cases. This field will be removed with the next API version.
    Example: "https://p16-amd-va.tiktokcdn.com/obj/tos-useast5-p-0068-tx/ogyxG5KtISdEAzSCEzZL4BA7BIij8pf5dwwBli"

  - `profile.popularPosts` (array)
    Popular Posts

  - `profile.city` (string)
    Example: "New york"

  - `profile.state` (string)
    Example: "California"

  - `profile.gender` (string)
    Enum: "MALE", "FEMALE"

  - `profile.contacts` (array)

  - `profile.contacts.type` (string, required)
    Enum: "bbm", "email", "facebook", "instagram", "itunes", "kakao", "kik", "lineid", "linktree", "phone", "pinterest", "sarahah", "sayat", "skype", "snapchat", "telegram", "threads", "tiktok", "tumblr", "twitchtv", "twitter", "viber", "vk", "wechat", "weibo", "whatsapp", "youtube"

  - `profile.contacts.value` (string, required)
    Example: "influenceremail@example.com"

  - `profile.country` (string)
    Example: "US"

  - `profile.ageGroup` (string)
    Enum: "18-24", "25-34", "35-44", "45-64", "65-"

  - `profile.isPrivate` (boolean, required)
    Example: true

  - `profile.isVerified` (boolean, required)
    Example: true

  - `profile.postsCount` (number, required)
    Example: 37

  - `profile.totalLikes` (number, required)
    Example: 182211

  - `profile.bio` (string, required)
    Example: "CEO of #RockTok"

  - `profile.interests` (array, required)

  - `profile.lookalikes` (array, required)

  - `profile.audienceExtra` (object)

  - `profile.audienceExtra.followersRange` (object, required)
    All histograms shown here are based on influencers whose number of followers fall within the range specified in this field

  - `profile.audienceExtra.followersRange.leftNumber` (number)
    Example: 100000

  - `profile.audienceExtra.followersRange.rightNumber` (number)
    Example: 500000

  - `profile.audienceExtra.engagementRateDistribution` (array, required)
    Distribution of influencers by their followers' engagement rate. This histogram displays how influencers from the same follower group are distributed based on the engagement rate of their followers. Ranges are automatically chosen for a clearer view of the entire histogram

  - `profile.audienceExtra.engagementRateDistribution.min` (number)
    The lower bound of the range
    Example: 0.4546

  - `profile.audienceExtra.engagementRateDistribution.max` (number)
    The upper bound of the range
    Example: 0.6482

  - `profile.audienceExtra.engagementRateDistribution.total` (number, required)
    The total count of data points within this range
    Example: 5551

  - `profile.audienceExtra.engagementRateDistribution.median` (boolean)
    Indicates if this bin represents the median range of the data. Only one range has this value set to
    Example: true

  - `profile.sponsoredPosts` (array, required)

  - `profile.sponsoredPosts.thumbnail` (string, required)

  - `profile.sponsoredPosts.title` (string, required)

  - `profile.sponsoredPosts.sponsors` (array)

  - `profile.sponsoredPosts.sponsors.domain` (string)

  - `profile.sponsoredPosts.sponsors.logo_url` (string)

  - `profile.paidPostPerformance` (number)
    Example: 0.5

  - `profile.paidPostPerformanceViews` (number, required)
    Example: 37

  - `profile.sponsoredPostsMedianViews` (number, required)
    Example: 3127

  - `profile.sponsoredPostsMedianLikes` (number, required)
    Example: 3743

  - `profile.nonSponsoredPostsMedianViews` (number, required)
    Example: 267

  - `profile.nonSponsoredPostsMedianLikes` (number, required)
    Example: 367