# Instagram API

> Retrieve public Instagram profiles, posts, reels, stories, highlights, comments, likes, locations, music, and hashtags.

Page: https://docs.toolzerhub.com/reference/instagram

## Location

Retrieve public Instagram profiles, posts, reels, stories, highlights, comments, likes, locations, music, and hashtags.

- [Get Instagram location details](https://docs.toolzerhub.com/reference/instagram/location/get-location-info.md): `GET /v1/instagram/location/info`. Returns public details for an Instagram location from required location_id: name, coordinates, category, and media count. Optional slug and show_nearby refine the response.
- [List Instagram location media (retired)](https://docs.toolzerhub.com/reference/instagram/location/get-location-media.md): `GET /v1/instagram/location/media`. Retired: always returns 410 and is not charged. Use /v1/instagram/location/posts instead.

## Post

Retrieve public Instagram profiles, posts, reels, stories, highlights, comments, likes, locations, music, and hashtags.

- [Get Instagram oEmbed data](https://docs.toolzerhub.com/reference/instagram/post/get-o-embed.md): `GET /v1/instagram/post/oembed`. Returns oEmbed data, including embed HTML and a thumbnail, for a public Instagram post or reel url. Optional maxwidth and maxheight (pixels) constrain the embed size.
- [Get Instagram post](https://docs.toolzerhub.com/reference/instagram/post/get-post.md): `GET /v1/instagram/post`. Returns public media details and the first page of comments for one Instagram post. Provide the shortcode as code or the numeric media_id; one of the two is required.
- [Get Instagram post by media ID](https://docs.toolzerhub.com/reference/instagram/post/get-post-by-id.md): `GET /v1/instagram/post/by-id`. Returns public media details and the first page of comments for one Instagram post. Requires the numeric media_id.
- [List Instagram post comments](https://docs.toolzerhub.com/reference/instagram/post/get-post-comments.md): `GET /v1/instagram/post/comments`. Lists comments on a public Instagram post, identified by its shortcode in code. count sets the page size; pass page_info.end_cursor from the previous response as cursor to get the next page.

## Search

Retrieve public Instagram profiles, posts, reels, stories, highlights, comments, likes, locations, music, and hashtags.

- [Search Instagram top media by keyword](https://docs.toolzerhub.com/reference/instagram/search/get-popular-search.md): `GET /v1/instagram/search/top`. Searches public Instagram media for required keyword and returns top posts plus related keywords. media_count and related_keywords_count set result sizes; cursor pages.

## User

Retrieve public Instagram profiles, posts, reels, stories, highlights, comments, likes, locations, music, and hashtags.

- [Get Instagram profile summary by ID](https://docs.toolzerhub.com/reference/instagram/user/get-user-summary.md): `GET /v1/instagram/user/summary`. Returns identity, biography, links, and follower and following counts for a public Instagram account. Requires the numeric user_id, which Get User ID returns.
- [Get Instagram user ID by username](https://docs.toolzerhub.com/reference/instagram/user/get-user-id.md): `GET /v1/instagram/user/id`. Returns the numeric user ID and basic identity fields for a public Instagram account, from required username_or_url. Use the ID with the endpoints that take user_id.
- [Get Instagram user profile](https://docs.toolzerhub.com/reference/instagram/user/get-user-info.md): `GET /v1/instagram/user/info`. Returns profile data for a public Instagram account from username_or_url. detail=summary returns identity, bio, links, and counts; detail=full adds post previews and business fields. Check is_partial on the response.
- [List Instagram stories and highlights](https://docs.toolzerhub.com/reference/instagram/user/get-highlights.md): `GET /v1/instagram/user/highlights`. Returns story availability, live status, and highlight metadata for a public Instagram account. Requires user_id; the include_ flags turn extra response sections on or off.
- [List Instagram user posts](https://docs.toolzerhub.com/reference/instagram/user/get-user-posts.md): `GET /v1/instagram/user/posts`. Lists media from a public Instagram account. Provide username_or_url or user_id. count sets the page size; pass the previous response's next_max_id as cursor to get the next page.
- [List Instagram user posts by ID](https://docs.toolzerhub.com/reference/instagram/user/get-user-posts-by-id.md): `GET /v1/instagram/user/posts/by-id`. Lists media from a public Instagram account by numeric user_id. count sets the page size; pass the previous response's next_max_id as next_max_id to get the next page.
- [List Instagram user reels](https://docs.toolzerhub.com/reference/instagram/user/get-user-reels.md): `GET /v1/instagram/user/reels`. Lists reels from a public Instagram account by numeric user_id. count sets the page size; pass the previous response's paging_info.max_id as cursor to get the next page.