# Get Analytics Report

Retrieves an analytics report for a specific influencer. If a report doesn't exist yet, 
one will be generated using your account's report credits.

Credit Usage:
- If the influencer's report has been previously generated, no credits are used.
- If a new report is needed, 1 report credit is deducted from your account.

Endpoint: GET /v1/search/get_analytics_page
Version: 1.4.2
Security: ApiKeyAuth

## Query parameters:

  - `user_id` (string, required)
    The influencer's platform-specific user ID.
    Example: "12345678"

  - `platform` (string, required)
    The social media platform of the influencer.
    Enum: "instagram", "youtube", "tiktok"

  - `calculation_method` (string)
    The method used to calculate engagement metrics in the report.
    Enum: "median", "average"

## Response 200 fields (application/json):

  - `report_credits` (integer)
    Remaining report credits in your account.

  - `report_url` (string)
    URL path to view the report in the dashboard.

  - `credits_used` (boolean)
    Whether a report credit was used for this request.

  - `success` (boolean)
    Indicates if the request was successful.

  - `status` (integer)
    HTTP status code.

  - `report_data` (object)
    Full analytics report data.

  - `report_data.success` (boolean)
    Indicates if the report was successfully retrieved.

  - `report_data.version` (string)
    API version used for the report.
    Example: "2"

  - `report_data.report_info` (object)
    Metadata about the report.

  - `report_data.report_info.report_id` (string)
    Unique identifier for this report.
    Example: "66229c859d37c82e078ed328"

  - `report_data.report_info.created` (string)
    When the report was created.
    Example: "2024-04-19T16:32:05.360+00:00"

  - `report_data.report_info.profile_updated` (string)
    When the influencer's profile data was last updated.
    Example: "2024-04-14T21:19:07.615+00:00"

  - `report_data.user_profile` (object)
    Influencer profile information including stats, contacts, posts, and content analysis.

  - `report_data.user_profile.type` (string)
    Platform type.
    Enum: "instagram", "youtube", "tiktok"

  - `report_data.user_profile.user_id` (string)
    Platform-specific user ID.

  - `report_data.user_profile.username` (string)
    Influencer's username/handle.

  - `report_data.user_profile.url` (string)
    URL to the influencer's profile.

  - `report_data.user_profile.picture` (string)
    URL to the influencer's profile picture.

  - `report_data.user_profile.fullname` (string)
    Influencer's display name.

  - `report_data.user_profile.description` (string)
    Influencer's bio/description.

  - `report_data.user_profile.is_verified` (boolean)
    Whether the account is verified.

  - `report_data.user_profile.is_business` (boolean)
    Whether this is a business account.

  - `report_data.user_profile.is_hidden` (boolean)
    Whether the account is hidden/private.

  - `report_data.user_profile.account_type` (integer)
    Account type identifier.

  - `report_data.user_profile.gender` (string)
    Detected gender of the influencer.
    Enum: "MALE", "FEMALE"

  - `report_data.user_profile.language` (object)
    Primary language of the influencer's content.

  - `report_data.user_profile.language.code` (string)
    Example: "en"

  - `report_data.user_profile.language.name` (string)
    Example: "English"

  - `report_data.user_profile.followers` (integer)
    Total follower count.

  - `report_data.user_profile.posts_count` (integer)
    Total number of posts.

  - `report_data.user_profile.engagements` (integer)
    Average engagements per post.

  - `report_data.user_profile.engagement_rate` (number)
    Engagement rate as a decimal (e.g., 0.001311 = 0.13%).

  - `report_data.user_profile.avg_likes` (integer)
    Average likes per post.

  - `report_data.user_profile.avg_comments` (integer)
    Average comments per post.

  - `report_data.user_profile.avg_views` (integer)
    Average views per post.

  - `report_data.user_profile.avg_reels_plays` (integer)
    Average plays for reels/short videos.

  - `report_data.user_profile.stat_history` (array)
    Historical statistics by month.

  - `report_data.user_profile.stat_history.month` (string)
    Month in YYYY-MM format.
    Example: "2024-01"

  - `report_data.user_profile.stat_history.followers` (integer)

  - `report_data.user_profile.stat_history.following` (integer)

  - `report_data.user_profile.stat_history.avg_likes` (integer)

  - `report_data.user_profile.paid_post_performance` (number)
    Performance ratio of paid/sponsored posts compared to organic.

  - `report_data.user_profile.geo` (object)
    Geographic location of the influencer.

  - `report_data.user_profile.geo.city` (object)

  - `report_data.user_profile.geo.city.id` (integer)

  - `report_data.user_profile.geo.city.coords` (object)

  - `report_data.user_profile.geo.city.coords.lat` (number)

  - `report_data.user_profile.geo.city.coords.lon` (number)

  - `report_data.user_profile.geo.state` (object)

  - `report_data.user_profile.geo.country` (object)

  - `report_data.user_profile.geo.country.code` (string)
    ISO country code.

  - `report_data.user_profile.contacts` (array)
    Contact information and linked social accounts.

  - `report_data.user_profile.contacts.type` (string)
    Contact type (e.g., email, linktree, facebook, twitter, tiktok, youtube).

  - `report_data.user_profile.contacts.value` (string)
    Contact value or username.

  - `report_data.user_profile.contacts.formatted_value` (string)
    Full URL or formatted contact.

  - `report_data.user_profile.contacts.checked` (boolean)
    Whether this contact has been verified.

  - `report_data.user_profile.top_hashtags` (array)
    Most frequently used hashtags.

  - `report_data.user_profile.top_hashtags.tag` (string)

  - `report_data.user_profile.top_hashtags.weight` (number)
    Relative frequency weight.

  - `report_data.user_profile.top_mentions` (array)
    Most frequently mentioned accounts.

  - `report_data.user_profile.top_mentions.weight` (number)

  - `report_data.user_profile.brand_affinity` (array)
    Brands the influencer has affinity with.

  - `report_data.user_profile.brand_affinity.interest` (array)

  - `report_data.user_profile.interests` (array)
    Content interest categories.

  - `report_data.user_profile.relevant_tags` (array)
    Relevant hashtags based on content analysis.

  - `report_data.user_profile.relevant_tags.distance` (number)

  - `report_data.user_profile.relevant_tags.freq` (number)

  - `report_data.user_profile.similar_users` (array)
    Similar influencer profiles.

  - `report_data.user_profile.similar_users.user_id` (string)

  - `report_data.user_profile.similar_users.username` (string)

  - `report_data.user_profile.similar_users.picture` (string)

  - `report_data.user_profile.similar_users.fullname` (string)

  - `report_data.user_profile.similar_users.url` (string)

  - `report_data.user_profile.similar_users.is_verified` (boolean)

  - `report_data.user_profile.similar_users.engagements` (integer)

  - `report_data.user_profile.similar_users.score` (number)
    Similarity score.

  - `report_data.user_profile.similar_users.geo` (object)
    Location (if available).

  - `report_data.user_profile.top_posts` (array)
    Best performing posts.

  - `report_data.user_profile.top_posts.username` (string)
    Influencer's username.

  - `report_data.user_profile.top_posts.user_picture` (string)
    URL to influencer's profile picture.

  - `report_data.user_profile.top_posts.user_url` (string)
    URL to influencer's profile.

  - `report_data.user_profile.top_posts.type` (string)
    Type of post.
    Enum: "photo", "video", "carousel"

  - `report_data.user_profile.top_posts.post_id` (string)
    Unique post identifier.
    Example: "3298296905318428430_232192182"

  - `report_data.user_profile.top_posts.created` (string)
    When the post was created.

  - `report_data.user_profile.top_posts.text` (string)
    Post caption/text.

  - `report_data.user_profile.top_posts.image` (string)
    URL to the post image.

  - `report_data.user_profile.top_posts.thumbnail` (string)
    URL to the post thumbnail.

  - `report_data.user_profile.top_posts.link` (string)
    Direct URL to the post.
    Example: "https://www.instagram.com/p/C3F549tRm8O/"

  - `report_data.user_profile.top_posts.mentions` (array)
    Accounts mentioned in the post.

  - `report_data.user_profile.top_posts.hashtags` (array)
    Hashtags used in the post.

  - `report_data.user_profile.top_posts.stat` (object)
    Post engagement statistics.

  - `report_data.user_profile.top_posts.stat.likes_and_views_counts_enabled` (boolean)
    Whether like/view counts are visible.

  - `report_data.user_profile.top_posts.stat.likes_count_enabled` (boolean)

  - `report_data.user_profile.top_posts.stat.views_count_enabled` (boolean)

  - `report_data.user_profile.top_posts.stat.likes` (integer)
    Number of likes.

  - `report_data.user_profile.top_posts.stat.comments` (integer)
    Number of comments.

  - `report_data.user_profile.top_posts.stat.plays` (integer)
    Number of video plays (for video content).

  - `report_data.user_profile.commercial_posts` (array)
    Sponsored/commercial posts.

  - `report_data.user_profile.recent_posts` (array)
    Most recent posts.

  - `report_data.user_profile.top_reels` (array)
    Best performing reels/short videos.

  - `report_data.user_profile.recent_reels` (array)
    Most recent reels/short videos.

  - `report_data.user_profile.posts_with_hidden_likes_percentage` (number)
    Percentage of posts with hidden like counts.

  - `report_data.audience_followers` (object)
    Follower audience demographics. May return success=false with error="empty_audience" if insufficient data.

  - `report_data.audience_followers.success` (boolean)

  - `report_data.audience_followers.error` (string)
    Error message if data unavailable.

  - `report_data.audience_followers.data` (object)

  - `report_data.audience_followers.data.audience_credibility` (number)
    Credibility score (0-1). Higher is better.
    Example: 0.7497

  - `report_data.audience_followers.data.credibility_class` (string)
    Credibility classification.
    Enum: "bad", "average", "good", "excellent"

  - `report_data.audience_followers.data.audience_types` (array)
    Breakdown of follower types.

  - `report_data.audience_followers.data.audience_types.code` (string)
    Follower type.
    Enum: "real", "influencers", "mass_followers", "suspicious"

  - `report_data.audience_followers.data.audience_types.weight` (number)
    Percentage as decimal.

  - `report_data.audience_followers.data.audience_reachability` (array)
    How many accounts followers follow (affects content visibility).

  - `report_data.audience_followers.data.audience_reachability.code` (string)
    Following count range.
    Example: "-500"

  - `report_data.audience_followers.data.audience_genders` (array)
    Gender distribution of followers.

  - `report_data.audience_followers.data.audience_ages` (array)
    Age distribution of followers.

  - `report_data.audience_followers.data.audience_ages.code` (string)
    Age range.
    Example: "25-34"

  - `report_data.audience_followers.data.audience_genders_per_age` (array)
    Gender breakdown by age group.

  - `report_data.audience_followers.data.audience_genders_per_age.male` (number)

  - `report_data.audience_followers.data.audience_genders_per_age.female` (number)

  - `report_data.audience_followers.data.audience_ethnicities` (array)
    Ethnicity distribution (US-focused data).

  - `report_data.audience_followers.data.audience_languages` (array)
    Language distribution of followers.

  - `report_data.audience_followers.data.audience_languages.code` (string)
    ISO language code.

  - `report_data.audience_followers.data.audience_brand_affinity` (array)
    Brands the audience has affinity with.

  - `report_data.audience_followers.data.audience_brand_affinity.affinity` (number)

  - `report_data.audience_followers.data.audience_interests` (array)
    Interest categories of the audience.

  - `report_data.audience_followers.data.audience_geo` (object)
    Geographic distribution of followers.

  - `report_data.audience_followers.data.audience_geo.countries` (array)

  - `report_data.audience_followers.data.audience_geo.states` (array)

  - `report_data.audience_followers.data.audience_geo.cities` (array)

  - `report_data.audience_followers.data.audience_lookalikes` (array)
    Influencers with similar audiences.

  - `report_data.audience_followers.data.audience_lookalikes.score` (number)

  - `report_data.audience_likers` (object)
    Liker audience demographics (may not return if insufficient data).

  - `report_data.audience_likers.error` (string)

  - `report_data.audience_likers.data` (object)
    Same structure as audience_followers.data when available.

  - `report_data.audience_commenters` (object)
    Commenter audience demographics (may not return if insufficient data).

  - `report_data.extra` (object)
    Additional comparative metrics and histograms.

  - `report_data.extra.followers_range` (object)
    Follower range category for comparison.

  - `report_data.extra.followers_range.left_number` (integer)
    Lower bound of the follower range bucket.
    Example: 1000000

  - `report_data.extra.engagement_rate_histogram` (array)
    Engagement rate distribution for influencers in the same follower range. Use to compare this influencer's engagement rate against peers.

  - `report_data.extra.engagement_rate_histogram.min` (number)
    Minimum engagement rate for this bucket.

  - `report_data.extra.engagement_rate_histogram.max` (number)
    Maximum engagement rate for this bucket.

  - `report_data.extra.engagement_rate_histogram.total` (integer)
    Number of influencers in this bucket.

  - `report_data.extra.engagement_rate_histogram.median` (boolean)
    Whether this bucket contains the median.

  - `report_data.extra.audience_credibility_followers_histogram` (array)
    Audience credibility distribution for influencers in the same follower range.

  - `report_data.extra.audience_credibility_followers_histogram.min` (number)

  - `report_data.extra.audience_credibility_followers_histogram.max` (number)

  - `report_data.extra.audience_credibility_followers_histogram.total` (integer)

  - `report_data.extra.audience_credibility_followers_histogram.median` (boolean)


## Response 400 fields

## Response 402 fields

## Response 404 fields