# Instagram data for AI agents

> ToolSocket gives Claude, ChatGPT, Cursor, Codex and any MCP or REST client live access to Instagram — profiles, posts, reels, comments, hashtags and locations — through 80 ready-made tools. No Instagram account, scraper or API key of your own is needed: connect https://toolsocket.top/mcp once and pay per call (most calls $0.003).

ToolSocket 让 Claude、ChatGPT、Cursor、Codex 等任何支持 MCP 或 REST 的 AI 智能体，直接读取Instagram的实时数据：主页、帖子、Reels、评论、话题和地点数据，共 80 个工具。不用注册Instagram账号、不用写爬虫，接入一个地址即可，按次计费（大多 $0.003/次）。

## Connect

- MCP (Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Codex): `https://toolsocket.top/mcp` — OAuth sign-in or `Authorization: Bearer ts_live_…`
- Claude Code: `claude mcp add --transport http toolsocket https://toolsocket.top/mcp`
- Any agent that reads skills: `set up https://toolsocket.top/SKILL.md`
- Setup for every client: https://toolsocket.top/docs.md

## Example

Ask your agent: "Compare the last 20 posts of these two Instagram brands." / 「对比这两个 Instagram 品牌账号最近 20 条帖子的表现。」

```bash
curl -s -X POST https://toolsocket.top/v1/run -H "Authorization: Bearer $TOOLSOCKET_API_KEY" \
  -H "content-type: application/json" -d '{"tool":"instagram#v2/search_users","input":{"keyword":"instagram"},"wait":30}'
```

## Tools (80)

| Tool | ID | Price | What it does |
|---|---|---|---|
| Instagram · Convert shortcode to media ID (v1) · Instagram · Shortcode转Media ID（v1） | `instagram#v1/shortcode_to_media_id` | $0.0015 / call | Convert Instagram post shortcode to media ID |
| Instagram · Convert media ID to shortcode (v1) · Instagram · Media ID转Shortcode（v1） | `instagram#v1/media_id_to_shortcode` | $0.0015 / call | Convert Instagram post media ID to shortcode |
| Instagram · Get user data by username (v1) · Instagram · 根据用户名获取用户数据（v1） | `instagram#v1/fetch_user_info_by_username` | $0.0015 / call | Get user data by Instagram username |
| Instagram · Get user data by username V2 (v1) · Instagram · 根据用户名获取用户数据V2（v1） | `instagram#v1/fetch_user_info_by_username_v2` | $0.0015 / call | Get user data by Instagram username |
| Instagram · Get user data by username V3 (v1) · Instagram · 根据用户名获取用户数据V3（v1） | `instagram#v1/fetch_user_info_by_username_v3` | $0.0015 / call | Get user data by Instagram username with more details |
| Instagram · Get user data by user ID (v1) · Instagram · 根据用户ID获取用户数据（v1） | `instagram#v1/fetch_user_info_by_id` | $0.0015 / call | Get user data by Instagram user ID |
| Instagram · Get user data by user ID V2 (v1) · Instagram · 根据用户ID获取用户数据V2（v1） | `instagram#v1/fetch_user_info_by_id_v2` | $0.0015 / call | Get user data by Instagram user ID with more details |
| Instagram · Get user posts list (v1) · Instagram · 获取用户帖子列表（v1） | `instagram#v1/fetch_user_posts` | $0.0015 / call | Get user posts list with pagination support |
| Instagram · Get user posts list V2 (v1) · Instagram · 获取用户帖子列表V2（v1） | `instagram#v1/fetch_user_posts_v2` | $0.0015 / call | Get user posts list with pagination |
| Instagram · Get user Reels list (v1) · Instagram · 获取用户Reels列表（v1） | `instagram#v1/fetch_user_reels` | $0.0015 / call | Get user Reels list with pagination |
| Instagram · Get user reposts list (v1) · Instagram · 获取用户转发列表（v1） | `instagram#v1/fetch_user_reposts` | $0.0015 / call | Get user reposts/shares list with pagination |
| Instagram · Get user tagged posts (v1) · Instagram · 获取用户被标记的帖子（v1） | `instagram#v1/fetch_user_tagged_posts` | $0.0015 / call | Get posts where this user is tagged by others |
| Instagram · Get related profiles (v1) · Instagram · 获取相关用户推荐（v1） | `instagram#v1/fetch_related_profiles` | $0.0015 / call | Get related/similar user recommendations |
| Instagram · Get post by URL (v1) · Instagram · 通过URL获取帖子详情（v1） | `instagram#v1/fetch_post_by_url` | $0.0015 / call | Get single post details by URL |
| Instagram · Get post by URL V2 (v1) · Instagram · 通过URL获取帖子详情 V2（v1） | `instagram#v1/fetch_post_by_url_v2` | $0.0015 / call | Get single post details by URL V2 - Data is not as complete as V1, but faster. Recommended for downloading large number of posts. |
| Instagram · Get post by ID (v1) · Instagram · 通过ID获取帖子详情（v1） | `instagram#v1/fetch_post_by_id` | $0.0015 / call | Get single post details by ID |
| Instagram · Get posts using specific music (v1) · Instagram · 获取使用特定音乐的帖子（v1） | `instagram#v1/fetch_music_posts` | $0.0015 / call | Get Reels and posts using specific music/audio |
| Instagram · Get posts by hashtag (v1) · Instagram · 获取话题标签下的帖子（v1） | `instagram#v1/fetch_hashtag_posts` | $0.0015 / call | Get posts under specific hashtag |
| Instagram · Get posts by location (v1) · Instagram · 获取地点下的帖子（v1） | `instagram#v1/fetch_location_posts` | $0.0015 / call | Get posts tagged at specified location |
| Instagram · Get cities by country (v1) · Instagram · 获取国家城市列表（v1） | `instagram#v1/fetch_cities` | $0.0015 / call | Get cities/regions list of specified country |
| Instagram · Get locations by city (v1) · Instagram · 获取城市地点列表（v1） | `instagram#v1/fetch_locations` | $0.0015 / call | Get Instagram locations list of specified city |
| Instagram · Get explore page sections (v1) · Instagram · 获取探索页面分类（v1） | `instagram#v1/fetch_explore_sections` | $0.0015 / call | Get all sections and subsections of Instagram explore page |
| Instagram · Get posts by section (v1) · Instagram · 获取分类下的帖子（v1） | `instagram#v1/fetch_section_posts` | $0.0015 / call | Get posts under specific explore section |
| Instagram · Convert shortcode to media ID (v2) · Instagram · Shortcode转Media ID（v2） | `instagram#v2/shortcode_to_media_id` | $0.003 / call | Convert Instagram post shortcode to media ID |
| Instagram · Convert media ID to shortcode (v2) · Instagram · Media ID转Shortcode（v2） | `instagram#v2/media_id_to_shortcode` | $0.003 / call | Convert Instagram post media ID to shortcode |
| Instagram · Get user info (v2) · Instagram · 获取用户信息（v2） | `instagram#v2/fetch_user_info` | $0.003 / call | Get detailed Instagram user information |
| Instagram · Get user posts (v2) · Instagram · 获取用户帖子（v2） | `instagram#v2/fetch_user_posts` | $0.003 / call | Get list of posts published by Instagram user |
| Instagram · Get user reels (v2) · Instagram · 获取用户Reels（v2） | `instagram#v2/fetch_user_reels` | $0.003 / call | Get list of Reels published by Instagram user |
| Instagram · Get user followers (v2) · Instagram · 获取用户粉丝（v2） | `instagram#v2/fetch_user_followers` | $0.003 / call | Get list of followers of Instagram user |
| Instagram · Get user following (v2) · Instagram · 获取用户关注（v2） | `instagram#v2/fetch_user_following` | $0.003 / call | Get list of users that Instagram user is following |
| Instagram · Get user stories (v2) · Instagram · 获取用户故事（v2） | `instagram#v2/fetch_user_stories` | $0.003 / call | Get current stories published by Instagram user |
| Instagram · Get user highlights (v2) · Instagram · 获取用户精选（v2） | `instagram#v2/fetch_user_highlights` | $0.003 / call | Get Instagram user's highlights list |
| Instagram · Get highlight stories (v2) · Instagram · 获取精选故事详情（v2） | `instagram#v2/fetch_highlight_stories` | $0.003 / call | Get all stories in a specific highlight |
| Instagram · Get user tagged posts (v2) · Instagram · 获取用户被标记的帖子（v2） | `instagram#v2/fetch_user_tagged_posts` | $0.003 / call | Get posts where the user is tagged by others |
| Instagram · Get similar users (v2) · Instagram · 获取相似用户（v2） | `instagram#v2/fetch_similar_users` | $0.003 / call | Get recommended similar users |
| Instagram · Search users (v2) · Instagram · 搜索用户（v2） | `instagram#v2/search_users` | $0.003 / call | Search Instagram users by keyword |
| Instagram · General search (v2) · Instagram · 综合搜索（v2） | `instagram#v2/general_search` | $0.003 / call | Perform general search on Instagram by keyword |
| Instagram · Search reels (v2) · Instagram · 搜索Reels（v2） | `instagram#v2/search_reels` | $0.003 / call | Search Instagram Reels by keyword |
| Instagram · Search music (v2) · Instagram · 搜索音乐（v2） | `instagram#v2/search_music` | $0.003 / call | Search available music on Instagram by keyword |
| Instagram · Search hashtags (v2) · Instagram · 搜索话题标签（v2） | `instagram#v2/search_hashtags` | $0.003 / call | Search Instagram hashtags by keyword |
| Instagram · Search locations (v2) · Instagram · 搜索地点（v2） | `instagram#v2/search_locations` | $0.003 / call | Search Instagram locations by keyword |
| Instagram · Search locations by coordinates (v2) · Instagram · 根据坐标搜索地点（v2） | `instagram#v2/search_by_coordinates` | $0.003 / call | Search nearby Instagram locations by GPS coordinates |
| Instagram · Get post info (v2) · Instagram · 获取帖子详情（v2） | `instagram#v2/fetch_post_info` | $0.003 / call | Get detailed information of Instagram post |
| Instagram · Get post likes (v2) · Instagram · 获取帖子点赞列表（v2） | `instagram#v2/fetch_post_likes` | $0.003 / call | Get list of users who liked the post |
| Instagram · Get post comments (v2) · Instagram · 获取帖子评论（v2） | `instagram#v2/fetch_post_comments` | $0.003 / call | Get list of comments on the post |
| Instagram · Get comment replies (v2) · Instagram · 获取评论回复（v2） | `instagram#v2/fetch_comment_replies` | $0.003 / call | Get list of replies to a comment |
| Instagram · Get music posts (v2) · Instagram · 获取音乐帖子（v2） | `instagram#v2/fetch_music_posts` | $0.003 / call | Get posts using specified music |
| Instagram · Get location posts (v2) · Instagram · 获取地点帖子（v2） | `instagram#v2/fetch_location_posts` | $0.003 / call | Get posts at specified location |
| Instagram · Get hashtag posts (v2) · Instagram · 获取话题帖子（v2） | `instagram#v2/fetch_hashtag_posts` | $0.003 / call | Get posts under specified hashtag |
| Instagram · Search users (v3) · Instagram · 搜索用户（v3） | `instagram#v3/search_users` | $0.012 / call | Instagram user search API |
| Instagram · Search hashtags (v3) · Instagram · 搜索话题标签（v3） | `instagram#v3/search_hashtags` | $0.012 / call | Instagram hashtag search API |
| Instagram · General search (with pagination) (v3) · Instagram · 综合搜索（支持分页）（v3） | `instagram#v3/general_search` | $0.012 / call | Instagram general search API (with pagination) |
| Instagram · Get user ID by username (v3) · Instagram · 通过用户名获取用户ID（v3） | `instagram#v3/get_user_id_by_username` | $0.012 / call | Get Instagram user ID by username |
| Instagram · Get user info by user ID (v3) · Instagram · 通过用户ID获取用户信息（v3） | `instagram#v3/user_id_to_username` | $0.012 / call | Get Instagram user info by user ID |
| Instagram · Get user profile (v3) · Instagram · 获取用户信息（v3） | `instagram#v3/get_user_profile` | $0.012 / call | Get complete Instagram user profile information |
| Instagram · Get user brief info (v3) · Instagram · 获取用户短详情（v3） | `instagram#v3/get_user_brief` | $0.012 / call | Get Instagram user brief/hover card info |
| Instagram · Get user posts (v3) · Instagram · 获取用户帖子列表（v3） | `instagram#v3/get_user_posts` | $0.012 / call | Get user's post list with forward/backward pagination |
| Instagram · Get user tagged posts (v3) · Instagram · 获取用户被标记的帖子（v3） | `instagram#v3/get_user_tagged_posts` | $0.012 / call | Get Instagram user's tagged posts list |
| Instagram · Get user reels (v3) · Instagram · 获取用户Reels列表（v3） | `instagram#v3/get_user_reels` | $0.012 / call | Get Instagram user's Reels list |
| Instagram · Get user highlights (v3) · Instagram · 获取用户精选Highlights列表（v3） | `instagram#v3/get_user_highlights` | $0.012 / call | Get Instagram user's Highlights list |
| Instagram · Get highlight stories (v3) · Instagram · 获取Highlight精选详情（v3） | `instagram#v3/get_highlight_stories` | $0.012 / call | Get Instagram Highlight's detailed story/post content |
| Instagram · Get user about info (v3) · Instagram · 获取用户账户简介（v3） | `instagram#v3/get_user_about` | $0.012 / call | Get Instagram user's About This Account information |
| Instagram · Get user stories (v3) · Instagram · 获取用户Stories（快拍）（v3） | `instagram#v3/get_user_stories` | $0.012 / call | Get Instagram user's Stories list |
| Instagram · Get recommended Reels feed (v3) · Instagram · 获取Reels推荐列表（v3） | `instagram#v3/get_recommended_reels` | $0.012 / call | Get Instagram Reels recommendation feed |
| Instagram · Get post info (media_id or URL) (v3) · Instagram · 获取帖子详情（v3） | `instagram#v3/get_post_info` | $0.012 / call | Get post details by media ID or post URL |
| Instagram · Get post info by shortcode (v3) · Instagram · 获取帖子详情(code)（v3） | `instagram#v3/get_post_info_by_code` | $0.012 / call | Get post details by shortcode |
| Instagram · Get post comments (v3) · Instagram · 获取帖子评论（v3） | `instagram#v3/get_post_comments` | $0.012 / call | Get Instagram post comment list |
| Instagram · Get comment replies (v3) · Instagram · 获取评论的子评论/回复（v3） | `instagram#v3/get_comment_replies` | $0.012 / call | Get Instagram comment's child comments (replies) list |
| Instagram · Bulk translate comments (v3) · Instagram · 批量翻译评论（v3） | `instagram#v3/bulk_translate_comments` | $0.012 / call | Bulk translate Instagram comments |
| Instagram · Get explore feed (v3) · Instagram · 获取探索页推荐帖子（v3） | `instagram#v3/get_explore` | $0.012 / call | Get Instagram Explore/Discover page recommended posts |
| Instagram · Get user following list (v3) · Instagram · 获取用户关注列表（v3） | `instagram#v3/get_user_following` | $0.012 / call | Get Instagram user's following list |
| Instagram · Get user followers list (v3) · Instagram · 获取用户粉丝列表（v3） | `instagram#v3/get_user_followers` | $0.012 / call | Get Instagram user's followers list |
| Instagram · Get location posts (v3) · Instagram · 获取地点相关帖子（v3） | `instagram#v3/get_location_posts` | $0.012 / call | Get Instagram location-related posts |
| Instagram · Convert shortcode to media ID (v3) · Instagram · 短码转媒体ID（v3） | `instagram#v3/shortcode_to_media_id` | $0.003 / call | Convert post shortcode to numeric media_id |
| Instagram · Convert media ID to shortcode (v3) · Instagram · 媒体ID转短码（v3） | `instagram#v3/media_id_to_shortcode` | $0.003 / call | Convert numeric media_id to post shortcode |
| Instagram · Extract shortcode from URL (v3) · Instagram · 从URL提取短码（v3） | `instagram#v3/extract_shortcode` | $0.003 / call | Extract shortcode from full Instagram post URL |
| Instagram · Get post likes (v3) · Instagram · 获取帖子点赞用户列表（v3） | `instagram#v3/get_post_likes` | $0.012 / call | Get list of users who liked an Instagram post |
| Instagram · Get similar users (v3) · Instagram · 获取相似账号推荐（v3） | `instagram#v3/get_similar_users` | $0.012 / call | Get recommended accounts similar to the given user |
| Instagram · Search locations by coordinates (v3) · Instagram · 按坐标搜索附近地点（v3） | `instagram#v3/search_by_coordinates` | $0.012 / call | Search nearby Instagram locations by GPS coordinates |
| Instagram · Get hashtag posts (v3) · Instagram · 获取话题标签帖子列表（v3） | `instagram#v3/get_hashtag_posts` | $0.012 / call | Get posts under a hashtag, with pagination |
