Get public analytics of a profile

Created by Anoop, Modified on Thu, 14 Mar at 8:48 AM by Anoop

POST

/v1/social/creators/profiles/analytics

Get analytics for creator's profile using publicly available data based on their username or link.

Request

Security: Basic Auth

Body

application/json

identifier

string

required

URL/username/handle of the profile you want to generate a report for

work_platform_id

string

required

Work platform ID for the platform on which you want to search for the profile using the above identifier

Responses

200

Returns detailed analytics of the given profile

Headers

request-id

string<uuid>

required

Unique ID associated with this request. Please quote this request while requesting support.

Body

application/json

responses

200

string

required

Unique ID of the analytics report

work_platform

WorkPlatformAttribute

required

string<uuid>

required

Unique ID of the work platform.

Example:

fb83e3ca-eae7-4eaa-bf51-601ea4b3daeb

name

string

required

Name of the work platform.

Example:

Instagram

logo_url

string<uri>

required

Image URL of the work platform logo.

Example:

https://insightiq.ai/storage/instagram.png

profile

CreatorProfileBasicDetails

required

platform_username

string

required

Profile username on the platform

url

string<uri>

required

Profile URL from the platform

image_url

string<uri>

required

Profile image URL from the platform

follower_count

integer

required

Number of followers

subscriber_count

integer

required

Number of subscribers

is_verified

boolean

required

Whether the profile is verified by the platform

full_name

string

required

Profile full name on the platform

introduction

string

required

Description of the profile.Show all...

platform_account_type

string

required

Account type of the profile, such as PERSONAL, CREATOR, BUSINESS, etc.

gender

string

required

Gender of the profile

age_group

string

required

Age group of the profile

language

string

required

2 letter language code as per ISO 639-1, refer the "language" table on this Airtable base

average_likes

integer

required

Average number of likes on posts

average_comments

integer

required

Average number of comments on posts

average_views

integer

required

Average number of views on posts

average_reels_views

integer

required

Average number of views on reels

engagement_rate

number

required

Profile engagement rate, i.e., total likes of all posts divided by the number of followers

reputation_history

array[object]

required

Profile reputation metrics over

month

string

required

Month of the metrics being recorded (ISO 8601 format: "YYYY-MM")

follower_count

integer

required

Number of followers

subscriber_count

integer

required

Number of subscribers

following_count

integer

required

Number of accounts followed by this profile

average_likes

integer

required

Average number of likes on posts

location

object

required

Profile location details, refer the "locations" table on this Airtable base.

city

string

required

Profile location city

state

string

required

Profile location state

country

string

required

Profile location country

top_hashtags

array[object]

required

List of top hashtags used by the creator

name

string

required

Hashtag

top_mentions

array[object]

required

List of top ment used by the creator

name

string

required

Mention

top_interests

array[object]

required

List of top interests of the creator, refer the "interests and brands" table on this Airtable base.

name

string

required

Interest

top_contents

array[CreatorContentBasicDetails]

required

List of top contents posted on the profile

type

string

required

Platform specific content type.

Allowed values:

VIDEOPOSTSTORYTWEETBLOGIMAGETHREADPODCASTTRACKOTHERREELSSTREAMFEEDIGTV

Example:

VIDEO

url

string<uri>

required

Content URL from the platform

description

string

required

Text description / caption of the content

thumbnail_url

string<uri>

required

Content thumbnail URL from the platform

engagement

object

required

Content engagement stats

like_count

integer

required

Number of likes on the content

comment_count

integer

required

Number of comments on the content

published_at

string<date-time>

required

Timestamp when the content was published on the platform.

Example:

2020-03-27T12:56:34.534978

recent_contents

array[CreatorContentBasicDetails]

required

List of recent contents posted on the profile

type

string

required

Platform specific content type.

Allowed values:

VIDEOPOSTSTORYTWEETBLOGIMAGETHREADPODCASTTRACKOTHERREELSSTREAMFEEDIGTV

Example:

VIDEO

url

string<uri>

required

Content URL from the platform

description

string

required

Text description / caption of the content

thumbnail_url

string<uri>

required

Content thumbnail URL from the platform

engagement

object

required

Content engagement stats

like_count

integer

required

Number of likes on the content

comment_count

integer

required

Number of comments on the content

published_at

string<date-time>

required

Timestamp when the content was published on the platform.

Example:

2020-03-27T12:56:34.534978

lookalikes

array[CreatorProfileBasicDetails]

required

List of look alike profiles

platform_username

string

required

Profile username on the platform

url

string<uri>

required

Profile URL from the platform

image_url

string<uri>

required

Profile image URL from the platform

follower_count

integer

required

Number of followers

subscriber_count

integer

required

Number of subscribers

is_verified

boolean

required

Whether the profile is verified by the platform

audience

DemographicsAttributes

required

ethnicities

array[object]

required

Percentage breakdown of audience ethnicities

name

string

required

Name of the ethnicity

value

number

required

Percentage of the audience with this ethnicity

languages

array[object]

required

Percentage breakdown of audience languages, refer the "language" table on this Airtable base

code

string

required

2 letter language code as per ISO 639-1

value

number

required

Percentage of the audience with this language

brand_affinity

array[object]

required

Percentage breakdown of audience brand affinities, refer the "interests and brands" table on this Airtable base.

name

string

required

Name of the brand affinity

value

number

required

Percentage of the audience with this brand affinity

interests

array[object]

required

Percentage breakdown of audience interests, refer the "interests and brands" table on this Airtable base.

name

string

required

Name of the interest topic

value

number

required

Percentage of the audience with this interest

follower_types

array[object]

required

Percentage breakdown of follower categories (only available for Instagram)

name

string

required

Type of the follower category

Allowed values:

MASS_FOLLOWERSSUSPICIOUSINFLUENCERSREAL

value

number

required

Percentage of the type of followers

lookalikes

array[CreatorProfileBasicDetails]

required

List of profiles with lookalike audience

platform_username

string

required

Profile username on the platform

url

string<uri>

required

Profile URL from the platform

image_url

string<uri>

required

Profile image URL from the platform

follower_count

integer

required

Number of followers

subscriber_count

integer

required

Number of subscribers

is_verified

boolean

required

Whether the profile is verified by the platform

countries

array[object]

required

code

string

required

2 letter country code as per ISO 3166-1 alpha-2

Example:

value

number

required

Percentage value of demographics from the corresponding country

Example:

78.9

cities

array[object]

required

name

string

required

Name of the city

Example:

Boulder

value

number

required

Percentage value of demographics from the corresponding city

Example:

45.6

gender_age_distribution

array[object]

required

gender

string

required

Gender of the audience

Allowed values:

MALEFEMALEOTHERS

Example:

FEMALE

age_range

string

required

Age range of the audience

Example:

13-18

value

number

required

Percentage value of demographics from the corresponding gender in the corresponding age range

Example:

12.3