Instagram Field Reference

Sample
https://connectors.windsor.ai/instagram?api_key=[your API key]&date_preset=last_7d&fields=date,user_name,account_id,website,followers_count,follows_count,media_count,media_id,media_type,media_url,media_comments_count,media_like_count,media_impressions,media_reach,media_engagement,carousel_album_engagement
&_renderer=csv
Fields
ID | Type | Name | Description | Report |
---|---|---|---|---|
account_id | TEXT | Account ID | Alias for Instagram user ID | user_info |
account_name | TEXT | Account Name | Instagram user name | user_info |
audience_age_name | TEXT | Age group name | age group name | user_insights_lifetime |
audience_age_size | NUMERIC | Number of followers of a age group | The lifetime number of an Instagram profile followers who belong to a age group | user_insights_lifetime |
audience_city_size | NUMERIC | Number of followers from a city | The lifetime number of an Instagram profile followers from a city | user_insights_lifetime |
audience_country_name | TEXT | Audience Country Name | Follower's country code | user_insights_lifetime |
audience_country_size | NUMERIC | Number of followers from a country | The lifetime number of an Instagram profile followers from a country | user_insights_lifetime |
audience_gender_age_name | TEXT | Gender/Age group name | Gender/age group name | user_insights_lifetime |
audience_gender_age_size | NUMERIC | Number of followers of a gender/age group | The lifetime number of an Instagram profile followers who belong to a gender/age group | user_insights_lifetime |
audience_gender_name | TEXT | Gender group name | Gender group name | user_insights_lifetime |
audience_gender_size | NUMERIC | Number of followers of a gender group | The lifetime number of an Instagram profile followers who belong to a gender group | user_insights_lifetime |
audience_locale_name | TEXT | Locale name | Follower's locale name (language code + country code) | user_insights_lifetime |
audience_locale_size | NUMERIC | Number of followers for a locale | The lifetime number of an Instagram profile followers with a locale | user_insights_lifetime |
biography | TEXT | Instagram profile (account) biography | Instagram profile (account) biography | user_info |
carousel_album_engagement | NUMERIC | Carousel album engagement | Total number of likes and comments on the carousel album | media_insights |
carousel_album_impressions | NUMERIC | Carousel album impressions | Total number of times the carousel album has been seen | media_insights |
carousel_album_reach | NUMERIC | Carousel album reach | Total number of unique Instagram accounts that have seen the carousel album | media_insights |
carousel_album_saved | NUMERIC | Carousel album saved | Total number of unique accounts that have saved the carousel album | media_insights |
carousel_album_video_views | NUMERIC | Carousel album video views | Total number of unique Instagram accounts that have viewed video within the carousel album. | media_insights |
city | TEXT | City | Follower's city | user_insights_lifetime |
clicks | NUMERIC | Total clicks | Total number of taps on directions, call, text message, website links in the Instagram user's profile within a day | |
date | DATE | Date | Date | |
email_contacts_1d | NUMERIC | Email contacts (1 day) | Total number of taps on the email link in the Instagram user's profile within a day | user_insights_day |
end_date | DATE | The current latest date of a lifetime period | The current latest date for lifetime metrics | |
follower_count_1d | NUMERIC | New followers (1 day) | Total number of new followers within a day. Not available on users with fewer than 100 followers. | user_insights_day |
followers_count | NUMERIC | Profile followers | Total number of unique accounts following this profile | user_info |
follows_count | NUMERIC | Profile follows | Total number of accounts this profile is following | user_info |
get_directions_clicks_1d | NUMERIC | Get directions clicks (1 day) | Total number of taps on the directions link in the Instagram user's profile within a day. | user_insights_day |
impressions | NUMERIC | Alias for Impressions (1 day) | Alias for Impressions (1 day) | user_insights_day |
impressions_1d | NUMERIC | Impressions (1 day) | Total number of times the Instagram user's Instagram Media have been viewed within a day. Does not include profile views. | user_insights_day |
legacy_user_id | TEXT | Legacy Instagram user ID | Legacy Instagram user ID | user_info |
media_caption | TEXT | Media caption | Caption of the post | media_info |
media_comments_count | NUMERIC | Comments count | Count of comments on the media. Excludes comments on album child media and the media's caption. Includes replies on comments. | media_info |
media_count | NUMERIC | Profile media count | Total number of media for this profile | user_info |
media_engagement | NUMERIC | Media engagement | Sum of like_count, comments_count and saved counts on the Instagram media object | media_insights |
media_id | TEXT | Media ID | Media object ID. | media_info |
media_impressions | NUMERIC | Media impressions | Total number of times the Instagram media object has been seen | media_insights |
media_is_comment_enabled | TEXT | Media comments enabled | Whether or not the comments are enabled | media_info |
media_like_count | NUMERIC | Media Like Count | Count of likes on the media. Excludes likes on album child media and likes on promoted posts created from the media. Includes replies on comments. | media_info |
media_permalink | TEXT | Media permalink | URL of the post on Instagram | media_info |
media_product_type | TEXT | Media product type | Surface where the media is published. Can be AD, FEED, IGTV, or STORY | media_info |
media_reach | NUMERIC | Media reach | Total number of unique Instagram accounts that have seen the Instagram media object. | media_insights |
media_saved | NUMERIC | Media saved | Total number of unique Instagram accounts that have saved the Instagram media object | media_insights |
media_shortcode | TEXT | Media shortcode | Shortcode of the post on Instagram | media_info |
media_thumbnail_url | TEXT | Video thumbnail URL | URL of the video thumbnail | media_info |
media_type | TEXT | Media type | Type of the media object (IMAGE, VIDEO, CAROUSEL_ALBUM, REEL) | media_info |
media_url | IMAGE_URL | Media URL | URL of the media object | media_info |
media_video_views | NUMERIC | Media video views | Total number of times the video Instagram Media has been seen. For album Instagram media, the number of times all videos within the album have been seen. | media_insights |
name | TEXT | Instagram profile (account) name | Instagram profile (account) name | user_info |
phone_call_clicks_1d | NUMERIC | Phone call clicks (1 day) | Total number of taps on the call link in Instagram user's profile within a day | user_insights_day |
profile_views_1d | NUMERIC | Profile views (1 day) | Total number of users who have viewed the Instagram user's profile within a day | user_insights_day |
reach | NUMERIC | Alias for Profile reach (1 day) | Alias for Profile reach (1 day) | user_insights_day |
reach_1d | NUMERIC | Profile reach (1 day) | Total number of unique users who have viewed at least one of the Instagram user's Instagram Media | user_insights_day |
story_exits | NUMERIC | Story exits | Number of times someone exited the story | story_insights |
story_id | TEXT | Story ID | Story ID | story_info |
story_impressions | NUMERIC | Story impressions | Total number of times the story has been seen | story_insights |
story_permalink | TEXT | Permanent URL to the media. | Total number of taps to see this story's previous photo or video | ig_media_info |
story_reach | NUMERIC | Story reach | Total number of unique accounts that have seen the story | story_insights |
story_replies | NUMERIC | Story replies | Total number of replies to the story | story_insights |
story_taps_back | NUMERIC | Story taps back | Total number of taps to see this story's previous photo or video | story_insights |
story_taps_forward | NUMERIC | Story taps forward | Total number of taps to see this story's next photo or video | story_insights |
text_message_clicks_1d | NUMERIC | Text message clicks (1 day) | Total number of taps on the text message link in the Instagram user's profile within a day | user_insights_day |
timestamp | TIMESTAMP | Media created | Date and time when media was added | media_info |
user_id | TEXT | Instagram user ID | Instagram user ID | user_info |
user_name | TEXT | Instagram user name (alias) | Alias for Instagram user name | user_info |
username | TEXT | Instagram user name | Instagram user name | user_info |
website | TEXT | Linked website | Link to your website that is displayed on your Instagram profile page | user_info |
website_clicks_1d | NUMERIC | Linked website clicks (1 day) | Total number of taps on the website link in the Instagram user's profile | user_insights_day |