Authentication Type: API Key
Description: Access Instagram user profiles, posts, and engagement data with comprehensive media and interaction analytics.
Profile Data
Retrieve Instagram user profile information including follower counts and verification status.
Get User Profile
Get detailed Instagram user profile including follower count, following count, media count, and profile information.
Operation Type: Query (Read)
Parameters:
- username
string
(required): Instagram username to retrieve profile for (without @ symbol)
Returns:
- followerCount
number
(nullable): Number of followers - followingCount
number
(nullable): Number of accounts following - mediaCount
number
(nullable): Number of media posts - pk
string
: Instagram user primary key ID - fullName
string
(nullable): Full display name - username
string
: Instagram username/handle - isVerified
boolean
(nullable): Whether account is verified - profilePicUrl
string
(nullable): Profile picture URL - hdProfilePicUrlInfo
object
(nullable): HD profile picture information- url
string
: HD profile picture URL
- url
- isUnpublished
boolean
(nullable): Whether account is unpublished - isPrivate
boolean
(nullable): Whether account is private - friendshipStatus
object
(nullable): Friendship status information- following
boolean
(nullable): Whether currently following - blocking
boolean
(nullable): Whether blocking user - isFeedFavorite
boolean
(nullable): Whether user is feed favorite - outgoingRequest
boolean
(nullable): Whether has outgoing follow request - followedBy
boolean
(nullable): Whether followed by user - incomingRequest
boolean
(nullable): Whether has incoming follow request - isRestricted
boolean
(nullable): Whether user is restricted - isBestie
boolean
(nullable): Whether user is bestie
- following
- textPostAppBadgeLabel
string
(nullable): Text post app badge label - showTextPostAppBadge
boolean
(nullable): Whether to show text post app badge - textPostNewPostCount
number
(nullable): New text post count - liveBroadcastVisibility
string
(nullable): Live broadcast visibility - liveBroadcastId
string
(nullable): Live broadcast ID - fbidV2
string
(nullable): Facebook ID v2 - id
string
: Instagram user ID
Example Usage:
{
"username": "instagram"
}
Posts Data
Retrieve Instagram posts and detailed post information.
Get User Posts
Retrieve recent posts from an Instagram user including media URLs and engagement metrics.
Operation Type: Query (Read)
Parameters:
- username
string
(required): Instagram username to retrieve posts for
Returns:
- userPosts
array of objects
: Array of user posts- node
object
: Post node data- code
string
: Post shortcode - id
string
(nullable): Post ID - caption
string
(nullable): Post caption text - takenAt
number
(nullable): Post timestamp - likeCount
number
(nullable): Number of likes - commentCount
number
(nullable): Number of comments - mediaType
number
(nullable): Media type (1=photo, 2=video, 8=carousel) - imageVersions2
object
(nullable): Image versions- candidates
array of objects
: Image candidates with different sizes- url
string
: Image URL - width
number
(nullable): Image width - height
number
(nullable): Image height
- url
- candidates
- code
- node
Example Usage:
{
"username": "instagram"
}
Get Post Details
Get detailed information about a specific Instagram post including comments, media, and engagement data.
Operation Type: Query (Read)
Parameters:
- postUrl
string
(required): Instagram post URL to retrieve detailed information for
Returns:
- id
string
: Post ID - thumbnailSrc
string
(nullable): Post thumbnail URL - dimensions
object
(nullable): Post dimensions- height
number
: Post height - width
number
: Post width
- height
- displayUrl
string
(nullable): Post display URL - mediaPreview
string
(nullable): Media preview URL - caption
string
(nullable): Post caption - shortcode
string
: Post shortcode - takenAtTimestamp
number
(nullable): Post timestamp - likeCount
number
(nullable): Number of likes - commentCount
number
(nullable): Number of comments - comments
array of objects
(nullable): Post comments- id
string
: Comment ID - text
string
: Comment text - createdAt
number
: Comment timestamp - owner
object
: Comment owner information- id
string
: Comment owner ID - username
string
: Comment owner username - profilePicUrl
string
(nullable): Comment owner profile pic
- id
- likeCount
number
(nullable): Comment like count
- id
Example Usage:
{
"postUrl": "https://www.instagram.com/p/ABC123/"
}
Get Post Comments
Get detailed comments for a specific Instagram post including user information and engagement metrics.
Operation Type: Query (Read)
Parameters:
- postUrl
string
(required): Instagram post URL to retrieve comments for
Returns:
- comments
array of objects
: Post comments- id
string
: Comment ID - text
string
: Comment text - createdAt
number
: Comment timestamp - owner
object
: Comment owner information- id
string
: Comment owner ID - username
string
: Comment owner username - profilePicUrl
string
(nullable): Comment owner profile pic - isVerified
boolean
: Whether comment owner is verified
- id
- likeCount
number
: Comment like count
- id
- totalCount
number
: Total number of comments
Example Usage:
{
"postUrl": "https://www.instagram.com/p/ABC123/"
}
Common Use Cases
Profile Analytics:
- Track follower growth and engagement metrics
- Analyze profile completeness and verification status
- Monitor account privacy settings and relationship status
Content Performance:
- Analyze post engagement rates and media performance
- Track content types that perform best (photos, videos, carousels)
- Monitor posting frequency and optimal timing
Community Engagement:
- Analyze comment sentiment and user interactions
- Track comment engagement and response rates
- Monitor brand mentions and user-generated content