superagnt/leverage / skills/core/social-data
social-data
VerifiedUnified data API for AI agents. One API key for LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook, plus web scraping, SEO data, and hosted webhook receiving. Structured JSON, no infra to run.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.0 KB |
| references/facebook/README.md | markdown | 29.2 KB |
| references/instagram/README.md | markdown | 16.2 KB |
| references/linkedin/README.md | markdown | 33.5 KB |
| references/reddit/README.md | markdown | 17.6 KB |
| references/seo/README.md | markdown | 26.2 KB |
| references/tiktok/README.md | markdown | 6.3 KB |
| references/web/README.md | markdown | 6.7 KB |
| references/x/README.md | markdown | 32.0 KB |
| references/youtube/README.md | markdown | 13.8 KB |
references/instagram/README.md
View on GitHub# Instagram API Reference
**App name:** `instagram`
**Base URL:** `https://api.superagnt.com/v1/data/instagram`
**Endpoints:** 22
Unified access to user profiles, reels, explore, locations, and hashtag media. Built for LLMs and automation — not one-off scraping.
## Authentication
All requests require the superagnt API key:
```
Authorization: Bearer $SUPERAGNT_API_KEY
```
---
## Available Endpoints
| Method | Path | Summary |
|--------|------|---------|
| `GET` | `/search` | Search users by keyword |
| `GET` | `/section` | Media by explore section ID |
| `GET` | `/sections` | Explore sections list |
| `GET` | `/cities` | Cities by country code |
| `GET` | `/location-feeds` | Media by location ID |
| `GET` | `/post-dl` | Download link by media ID or URL |
| `GET` | `/post` | Media info by URL |
| `GET` | `/related-profiles` | Related profiles by user ID |
| `GET` | `/reels` | Reels by user ID |
| `GET` | `/user-feeds2` | Media list (V2) by user ID |
| `GET` | `/user-feeds` | Media list by user ID |
| `GET` | `/profile2` | User info (V2) by username |
| `GET` | `/profile` | User info by user ID |
| `GET` | `/id-media` | Media shortcode from media ID |
| `GET` | `/id` | Username from user ID |
| `GET` | `/user-tags` | Tagged media by user ID |
| `GET` | `/user-reposts` | Reposts by user ID |
| `GET` | `/locations` | Locations by city ID |
| `GET` | `/location-info` | Location info by location ID |
| `GET` | `/web-profile` | Web profile info by username |
| `GET` | `/music` | Music info by music ID |
| `GET` | `/tag-feeds` | Media by hashtag |
## Tool Schemas
The following JSON defines all available tools with their parameters. Each tool maps to an API endpoint.
```json
[
{
"name": "superagnt_instagram_Search_users_by_keyword",
"description": "Search users by keyword",
"method": "GET",
"path": "/search",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"select": {
"type": "string",
"description": "select"
},
"query": {
"type": "string",
"description": "query"
}
},
"required": [
"select",
"query"
]
}
},
{
"name": "superagnt_instagram_Media_by_explore_section_ID",
"description": "Media by explore section ID",
"method": "GET",
"path": "/section",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"max_id": {
"type": "number",
"description": "max_id"
},
"count": {
"type": "number",
"description": "count"
},
"id": {
"type": "string",
"description": "id"
}
},
"required": [
"count",
"id"
]
}
},
{
"name": "superagnt_instagram_Explore_sections_list",
"description": "Explore sections list",
"method": "GET",
"path": "/sections",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
}
}
}
},
{
"name": "superagnt_instagram_Cities_by_country_code",
"description": "Cities by country code",
"method": "GET",
"path": "/cities",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"country_code": {
"type": "string",
"description": "country_code"
},
"page": {
"type": "number",
"description": "page"
}
},
"required": [
"country_code"
]
}
},
{
"name": "superagnt_instagram_Media_by_location_ID",
"description": "Media by location ID",
"method": "GET",
"path": "/location-feeds",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"tab": {
"type": "string",
"description": "tab"
},
"id": {
"type": "string",
"description": "id"
},
"end_cursor": {
"type": "string",
"description": "end_cursor"
}
},
"required": [
"tab",
"id"
]
}
},
{
"name": "superagnt_instagram_Download_link_by_media_ID_or_URL",
"description": "Download link by media ID or URL",
"method": "GET",
"path": "/post-dl",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"url": {
"type": "string",
"description": "url"
}
},
"required": [
"url"
]
}
},
{
"name": "superagnt_instagram_Media_info_by_URL",
"description": "Media info by URL",
"method": "GET",
"path": "/post",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"url": {
"type": "string",
"description": "url"
}
},
"required": [
"url"
]
}
},
{
"name": "superagnt_instagram_Related_profiles_by_user_ID",
"description": "Related profiles by user ID",
"method": "GET",
"path": "/related-profiles",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"id"
]
}
},
{
"name": "superagnt_instagram_Reels_by_user_ID",
"description": "Reels by user ID",
"method": "GET",
"path": "/reels",
"parameters": {
"type": "object",
"properties": {
"max_id": {
"type": "string",
"description": "max_id"
},
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"count": {
"type": "number",
"description": "count"
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"count",
"id"
]
}
},
{
"name": "superagnt_instagram_Media_list__V2__by_user_ID",
"description": "Media list (V2) by user ID",
"method": "GET",
"path": "/user-feeds2",
"parameters": {
"type": "object",
"properties": {
"end_cursor": {
"type": "string",
"description": "end_cursor"
},
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"count": {
"type": "number",
"description": "count"
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"count",
"id"
]
}
},
{
"name": "superagnt_instagram_Media_list_by_user_ID",
"description": "Media list by user ID",
"method": "GET",
"path": "/user-feeds",
"parameters": {
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "count"
},
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"max_id": {
"type": "string",
"description": "max_id"
},
"allow_restricted_media": {
"type": "boolean",
"description": "allow_restricted_media"
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"count",
"id"
]
}
},
{
"name": "superagnt_instagram_User_info__V2__by_username",
"description": "User info (V2) by username",
"method": "GET",
"path": "/profile2",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"username": {
"type": "string",
"description": "username"
}
},
"required": [
"username"
]
}
},
{
"name": "superagnt_instagram_User_info_by_user_ID",
"description": "User info by user ID",
"method": "GET",
"path": "/profile",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"id"
]
}
},
{
"name": "superagnt_instagram_Media_shortcode_from_media_ID",
"description": "Media shortcode from media ID",
"method": "GET",
"path": "/id-media",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"id": {
"type": "string",
"description": "id"
}
},
"required": [
"id"
]
}
},
{
"name": "superagnt_instagram_Username_from_user_ID",
"description": "Username from user ID",
"method": "GET",
"path": "/id",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"id"
]
}
},
{
"name": "superagnt_instagram_Tagged_media_by_user_ID",
"description": "Tagged media by user ID",
"method": "GET",
"path": "/user-tags",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"count": {
"type": "number",
"description": "count"
},
"end_cursor": {
"type": "string",
"description": "end_cursor"
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"count",
"id"
]
}
},
{
"name": "superagnt_instagram_Reposts_by_user_ID",
"description": "Reposts by user ID",
"method": "GET",
"path": "/user-reposts",
"parameters": {
"type": "object",
"properties": {
"max_id": {
"type": "string",
"description": "max_id"
},
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"id"
]
}
},
{
"name": "superagnt_instagram_Locations_by_city_ID",
"description": "Locations by city ID",
"method": "GET",
"path": "/locations",
"parameters": {
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "page"
},
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"city_id": {
"type": "string",
"description": "city_id"
}
},
"required": [
"city_id"
]
}
},
{
"name": "superagnt_instagram_Location_info_by_location_ID",
"description": "Location info by location ID",
"method": "GET",
"path": "/location-info",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"id"
]
}
},
{
"name": "superagnt_instagram_Web_profile_info_by_username",
"description": "Web profile info by username",
"method": "GET",
"path": "/web-profile",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"username": {
"type": "string",
"description": "username"
}
},
"required": [
"username"
]
}
},
{
"name": "superagnt_instagram_Music_info_by_music_ID",
"description": "Music info by music ID",
"method": "GET",
"path": "/music",
"parameters": {
"type": "object",
"properties": {
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"max_id": {
"type": "string",
"description": "max_id"
},
"id": {
"type": "number",
"description": "id"
}
},
"required": [
"id"
]
}
},
{
"name": "superagnt_instagram_Media_by_hashtag",
"description": "Media by hashtag",
"method": "GET",
"path": "/tag-feeds",
"parameters": {
"type": "object",
"properties": {
"end_cursor": {
"type": "string",
"description": "end_cursor"
},
"fields": {
"type": "string",
"description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
},
"query": {
"type": "string",
"description": "query"
}
},
"required": [
"query"
]
}
}
]
```
## Example
```bash
curl -X GET "https://api.superagnt.com/v1/data/instagram/search?param=value" \
-H "Authorization: Bearer $SUPERAGNT_API_KEY"
```
## Links
- [Documentation](https://superagnt.com/docs)
- [API Reference](https://superagnt.com/docs/apis/social/instagram)
- [superagnt app](https://app.superagnt.com/dashboard)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |