Get public content information for a profile or single content item (beta, subject to change)

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

POST

/v1/social/creators/contents/fetch

Retrieve the information of a profile's content or information of a single content item with the supplied content url.

Request

Security: Basic Auth

Body

application/json

CreatorContentFetchRequest - Profile

(one of)

profile_url

string<uri> or

content_url

required

URL of the profile you want to get content data for. It fetches all content data at a channel or page level.

work_platform_id

string

required

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

content_type

string (Not needed when using content URL)

Only for Instagram - to be used along with profile_url to fetch specific content types.

Allowed values:

REELSIGTV

offset

integer(Not needed when using content URL)

Increase sequentially from 0 to fetch analytics of profile posts.

Example:

Responses

200

Returns detailed analytics of the profile's content or the single content item.

Headers

request-id

string<uuid>

required

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

Body

application/json

responses

200

data

array[CreatorContentData]

Represents the Content object. It contains data of media (images, videos, audio) present in a connected account.

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

engagement

object

like_count

integer

Total likes.

Example:

42134

comment_count

integer

Total comments.

Example:

4234

view_count

integer

Total views.

Example:

42343

share_count

integer or null

Total shares.

Example:

42343

platform_content_id

string

Unique content ID on the platform.

Example:

12ccaf87

title

string

Title of the content item.

Example:

USA Tours

format

string

Media type of the content item.

Allowed values:

VIDEOIMAGEAUDIOTEXTOTHER

Example:

VIDEO

type

string

Platform specific content type.

Allowed values:

REELSIGTV

Example:

REELS

url

string<uri>

Platform content URL.

Example:

https://youtu.be/jzWweY4xPe8

media_url

string<uri> or null

Direct media URL of the content item, which can be used to download the media item. This is usually a signed URL and may have certain expiry limits so we recommend using it for downloads as soon as possible (such as when a webhook is received), if you are looking to cache media files with you.

Example:

https://video.cdninstagram.com/v/t50.16885-16/273384537_472655704353078_8308247021721136693_n.mp4?_nc_cat=100&vs=661086908417570_1261186177&_nc_vs=HBksFQAYJEdGbUVTeEEyNlZ1NzRLMEJBRFd1NHJPbDBreHpidlZCQUFBRhUAAsgBABUAGCRHSnU0U3hEM2kwQ0VQVk1EQUM3S29OeTlueUJzYnZWQkFBQUYVAgLIAQAoABgAGwGIB3VzZV9vaWwBMRUAACbG3%2FGq0JXjPxUCKAJDMywXQCOhysCDEm8YEmRhc2hfYmFzZWxpbmVfMV92MREAdewHAA%3D%3D&ccb=1-5&_nc_sid=59939d&efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLjQ4MC5pZ3R2In0%3D&_nc_ohc=qcTIWWC39rQAX9xprW6&_nc_ht=video.cdninstagram.com&edm=AM6HXa8EAAAA&oh=00_AT85xcdCSq921RH5KCSfIukPMfk0QCajZEP5Ym4fY3p1Pw&oe=621D1EA5&_nc_rid=5d42feb0d5

thumbnail_url

string<uri>

Thumbnail URL of the content item, which can be used to download the media thumbnail. This is usually a signed URL and may have certain expiry limits so we recommend using it for downloads as soon as possible (such as when a webhook is received), if you are looking to cache thumbnails with you.

Example:

https://youtu.be/jzWweY4xPe8.png

duration

number or null

Video duration in seconds (only available for YouTube).

Example:

523

description

string

Description of the content item.

Example:

US tours video.

published_at

string<date-time>

Publishing timestamp of the content item.

Example:

2021-05-26T00:00:00.000000

audio_track_info

AudioTrackInfo

Audio track details of the video/reel.