Instagram response objects

Every object the Instagram endpoints return, field by field, named after Instagram's Graph API. Every key is there on every call: a field the platform does not show is null, and a list is empty.

`instagram_profile`

An Instagram account. Returned by instagram/profile.

Fields
Field	What it is
`id` string	Instagram's numeric id for the account.
`username` string	Without the @.
`name` string · or null	The display name.
`biography` string · or null	The bio.
`website` URL · or null	The link in the bio.
`bio_links` array of objects	Every link in the bio.
`bio_links[].title` string · or null	The link's label, where it has one.
`bio_links[].url` URL	Where the link leads.
`profile_picture_url` URL · or null	The profile picture. On Instagram's CDN. Instagram signs the link, and it stops working within a few days, so fetch the file soon. We do not rehost media.
`followers_count` integer · or null	`null` when the source does not give it.
`follows_count` integer · or null	`null` when the source does not give it.
`media_count` integer · or null	Posts on the grid.
`is_verified` boolean	Whether the account has the verified badge.
`is_private` boolean	A private account shows its counts and nothing else.
`is_business_account` boolean · or null	A business or creator account.
`category` string · or null	The label under the name, e.g. "Bakery" or "Public figure".
`business_email` string · or null	Behind the Email button, where a business account shows one.
`business_phone_number` string · or null	Behind the Call button.
`highlight_reel_count` integer · or null	Story highlights on the profile.

`instagram_search_result`

An Instagram account that a search found. Call `instagram/profile` with its username for the whole account. Returned by instagram/search.

Fields
Field	What it is
`username` string	Without the @.
`name` string · or null	The display name, as the search index has it.
`url` URL	The account's page.

`instagram_post`

An Instagram post or Reel. Returned by instagram/posts, instagram/post, instagram/hashtag.

Fields
Field	What it is
`id` string	Instagram's numeric id for the post.
`shortcode` string	The code in the URL, e.g. `C1a2B3c4D5e`.
`permalink` URL	The post.
`media_type` string, one of	As the Graph API names them. IMAGE · VIDEO · CAROUSEL_ALBUM
`media_product_type` string, one of	A grid post or a Reel. FEED · REELS
`caption` string · or null	The caption.
`timestamp` time, ISO 8601 UTC · or null	When it was posted. `null` when the source does not say.
`username` string	Who posted it.
`media_url` URL	The image, or the video file. A carousel's first item. On Instagram's CDN. Instagram signs the link, and it stops working within a few days, so fetch the file soon. We do not rehost media.
`thumbnail_url` URL · or null	The cover of a video. On Instagram's CDN. Instagram signs the link, and it stops working within a few days, so fetch the file soon. We do not rehost media.
`children` array of objects	A carousel's items, in order. Empty for a single image or video.
`children[].media_type` string, one of	An image or a video. IMAGE · VIDEO
`children[].media_url` URL	The image, or the video file. On Instagram's CDN. Instagram signs the link, and it stops working within a few days, so fetch the file soon. We do not rehost media.
`video_duration` number · or null	Seconds.
`like_count` integer · or null	`null` when the owner has hidden it.
`comments_count` integer · or null	`null` when the source does not give it.
`view_count` integer · or null	Views, for videos and Reels.
`hashtags` array of strings	The caption's hashtags, without the #.
`mentions` array of strings	The usernames the caption mentions, without the @.
`location` object · or null	The location tag.
`location.id` string	Instagram's id for the location.
`location.name` string	The place's name, as the tag shows it.
`is_paid_partnership` boolean · or null	Whether it carries the "Paid partnership" label. `null` where that is not known.

`instagram_comment`

A comment on an Instagram post. Returned by instagram/comments.

Fields
Field	What it is
`id` string	Instagram's id for the comment.
`media_id` string	The post it is on.
`parent_id` string · or null	The comment it replies to. `null` for a top-level comment.
`username` string	Who wrote it, without the @.
`text` string · or null	`null` for a comment with no words, such as a GIF.
`timestamp` time, ISO 8601 UTC · or null	`null` when the source does not say.
`like_count` integer · or null	`null` when the source does not give it.
`reply_count` integer · or null	`null` when the source does not give it.