# Instagram on Onekey

> 42 endpoints for Instagram (1 stable, 41 beta), 1 to 6 credits each. Category: Social networks. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.
Access: 42 of 42 endpoints are marked "needs a pack" or "may need a pack": free-grant credits reach only the open fetch path; a verified email and a purchased pack unlock the rest.

Page: https://onekey.dev/platforms/instagram
Reference (Markdown): https://onekey.dev/docs/api/instagram.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 42 mapped Instagram endpoints return each:

- `author.username` (string): 31
- `content.text` (string): 22
- `content.id` (string): 20
- `engagement.comments` (integer): 18
- `engagement.likes` (integer): 18
- `media.thumbnailUrl` (URL): 18
- `content.createdAt` (ISO 8601 date): 17
- `engagement.views` (integer): 15
- `author.avatarUrl` (URL): 13
- `author.id` (string): 13
- `author.displayName` (string): 12
- `content.title` (string): 12
- `engagement.shares` (integer): 12
- `author.verified` (boolean): 11
- `content.url` (URL): 11
- `author.followers` (integer): 6
- `entity.id` (string): 6
- `entity.name` (string): 6
- `author.contentCount` (integer): 3
- `author.following` (integer): 3
- `author.url` (URL): 3
- `media.durationSeconds` (number): 3
- `author.bio` (string): 2
- `content.language` (string): 2
- `entity.url` (URL): 2
- `media.audioUrl` (URL): 2
- `place.lat` (number): 2
- `place.lon` (number): 2
- `author.country` (string): 1
- `author.createdAt` (ISO 8601 date): 1
- `author.website` (URL): 1
- `engagement.bookmarks` (integer): 1
- `entity.category` (string): 1
- `entity.stats.itemCount` (integer): 1
- `place.address` (string): 1
- `place.city` (string): 1
- plus 14 platform-specific fields under `ext.`

## Endpoints

### instagram.audio_reels

List Instagram reels using an audio track.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/audio_reels?audio_id=1234567890` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `audio_id` (string, required): Audio id
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/audio_reels.md

### instagram.basic_profile

Basic Instagram profile by user id.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/basic_profile?user_id=1234567890` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `user_id` (string, required): User id
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.bio`, `author.followers`, `author.following`, `author.contentCount`, `author.verified`, `author.avatarUrl`, `author.url`
- Reference: https://onekey.dev/docs/api/instagram/basic_profile.md

### instagram.comment

Look up one Instagram comment by post URL.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/comment?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC1a2B3c4D5e%2F` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `url` (string, required): Url (URL)
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `author.username`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/comment.md

### instagram.comment_likers

List accounts that liked an Instagram comment.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/comment_likers?comment_id=17858893269000001` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `comment_id` (string, required): Numeric Instagram comment id
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.verified`, `author.avatarUrl`, `ext.isPrivate`
- Reference: https://onekey.dev/docs/api/instagram/comment_likers.md

### instagram.comments

Comments on an Instagram post (needs the numeric media id).
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/comments?media_id=2673763756536958061` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `media_id` (string, required): Instagram numeric media id
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `author.id`, `author.username`, `author.avatarUrl`, `engagement.likes`, `engagement.comments`
- Reference: https://onekey.dev/docs/api/instagram/comments.md

### instagram.engagement

Get Instagram engagement statistics.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/engagement?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Handle
- Fields returned: `author.username`, `ext.avgLikes`, `ext.avgComments`, `ext.avgViews`, `ext.engagementRate`
- Reference: https://onekey.dev/docs/api/instagram/engagement.md

### instagram.followers

Followers of an Instagram user (login-gated: needs a session cookie).
- Price: 6 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/followers?user_id=25025320` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `user_id` (string, required): Instagram numeric user id
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.verified`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/followers.md

### instagram.following

Accounts an Instagram user follows (login-gated: needs a session cookie).
- Price: 6 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/following?user_id=25025320` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `user_id` (string, required): Instagram numeric user id
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.verified`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/following.md

### instagram.hashtag

Instagram hashtag info: post count.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/hashtag?tag=nasa` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `tag` (string, required): Hashtag without #
- Fields returned: `entity.id`, `entity.name`, `ext.posts`
- Reference: https://onekey.dev/docs/api/instagram/hashtag.md

### instagram.highlight_detail

Get the items inside one Instagram story highlight.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/highlight_detail?id=1234567890` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `id` (string, required): Id
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/highlight_detail.md

### instagram.highlights

Story highlights tray of an Instagram user (login-gated).
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/highlights?user_id=25025320` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `user_id` (string, required): Instagram numeric user id
- Fields returned: `content.id`, `content.title`, `media.thumbnailUrl`, `ext.items`
- Reference: https://onekey.dev/docs/api/instagram/highlights.md

### instagram.location

Get an Instagram location's profile.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/location?location_id=104063639628876` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `location_id` (string, required): Numeric Instagram location id
- Fields returned: `entity.id`, `entity.name`, `entity.category`, `entity.stats.itemCount`, `place.lat`, `place.lon`
- Reference: https://onekey.dev/docs/api/instagram/location.md

### instagram.location_posts

List recent posts at an Instagram location.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/location_posts?location_id=1234567890` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `location_id` (string, required): Location id
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/location_posts.md

### instagram.media_screen_text

Get Instagram post on-screen text.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/media_screen_text?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC1a2B3c4D5e%2F` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `url` (string, required): Url (URL)
- Fields returned: `content.text`, `content.language`
- Reference: https://onekey.dev/docs/api/instagram/media_screen_text.md

### instagram.media_transcript

Get Instagram media transcript.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/media_transcript?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC1a2B3c4D5e%2F` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `url` (string, required): Url (URL)
- Fields returned: `content.text`, `content.language`, `media.durationSeconds`
- Reference: https://onekey.dev/docs/api/instagram/media_transcript.md

### instagram.music_trending

List trending Instagram music.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/music_trending` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `author.displayName`, `media.durationSeconds`, `media.thumbnailUrl`, `media.audioUrl`, `entity.url`, `ext.videoCount`
- Reference: https://onekey.dev/docs/api/instagram/music_trending.md

### instagram.post

A single Instagram post/reel by shortcode (graphql doc_id drifts, override via param).
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/post?shortcode=CUbHfhpswxt` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `shortcode` (string, required): Instagram shortcode
  - `doc_id` (string, optional, default 8845758582119845): GraphQL doc_id
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `author.id`, `author.username`, `engagement.likes`, `engagement.comments`, `engagement.views`, `media.thumbnailUrl`, `ext.shortcode`
- Reference: https://onekey.dev/docs/api/instagram/post.md

### instagram.post_comment_replies

List replies under an Instagram comment.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/post_comment_replies?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC1a2B3c4D5e%2F&comment_id=1234567890` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `url` (string, required): Url (URL)
  - `comment_id` (string, required): Comment id
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `author.username`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/post_comment_replies.md

### instagram.post_likers

List Instagram post likers.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/post_likers?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC1a2B3c4D5e%2F` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `url` (string, required): Url (URL)
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.followers`, `author.verified`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/post_likers.md

### instagram.post_oembed

Instagram post oEmbed: caption, author, thumbnail (public posts).
- Price: 1 credit per fresh call. Status: stable. Access: may need a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/post_oembed?shortcode=CUbHfhpswxt` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `shortcode` (string, required): Instagram post shortcode, e.g. CUbHfhpswxt
- Fields returned: `content.id`, `content.text`, `author.username`, `author.id`, `author.url`, `media.thumbnailUrl`
- Reference: https://onekey.dev/docs/api/instagram/post_oembed.md

### instagram.post_stats

Get Instagram post stats including the share count.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/post_stats?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC1a2B3c4D5e%2F` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `url` (string, required): Url (URL)
- Fields returned: `content.id`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/instagram/post_stats.md

### instagram.posts

Recent posts of an Instagram profile (public accounts).
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/posts?handle=instagram` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Instagram username without @
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `media.thumbnailUrl`, `engagement.likes`, `engagement.comments`, `engagement.views`, `author.username`, `ext.shortcode`
- Reference: https://onekey.dev/docs/api/instagram/posts.md

### instagram.profile

Instagram profile: bio, followers, following, post count, verification, avatar.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/profile?handle=instagram` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Instagram username without @
- Fields returned: `author.id`, `author.username`, `author.displayName`, `content.text`, `author.followers`, `author.following`, `author.verified`, `author.avatarUrl`, `author.contentCount`, `author.website`, `ext.authorCategory`
- Reference: https://onekey.dev/docs/api/instagram/profile.md

### instagram.profile_about

Get Instagram account transparency details.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/profile_about?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Handle
- Fields returned: `author.username`, `author.country`, `author.createdAt`, `author.verified`, `ext.formerUsernames`
- Reference: https://onekey.dev/docs/api/instagram/profile_about.md

### instagram.profile_full

Instagram profile, recent posts, and computed analytics in one call.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/profile_full?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Handle
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.bio`, `author.followers`, `author.following`, `author.contentCount`, `author.verified`, `author.avatarUrl`, `author.url`, `ext.recentPosts`, `ext.analytics`
- Reference: https://onekey.dev/docs/api/instagram/profile_full.md

### instagram.profile_posts_full

Instagram posts with views, likes, comments, and per-post share counts where available, in one call.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/profile_posts_full?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, optional): Handle
  - `user_id` (string, optional): Numeric Instagram user id (alternative to handle)
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/profile_posts_full.md

### instagram.profile_reels_full

Instagram reels with views, likes, comments, and per-reel share counts where available, in one call.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/profile_reels_full?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, optional): Handle
  - `user_id` (string, optional): Numeric Instagram user id (alternative to handle)
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/profile_reels_full.md

### instagram.reels

Recent reels (video timeline) of an Instagram profile.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/reels?handle=instagram` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Instagram username without @
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `media.thumbnailUrl`, `engagement.likes`, `engagement.comments`, `engagement.views`, `author.username`, `ext.shortcode`
- Reference: https://onekey.dev/docs/api/instagram/reels.md

### instagram.reels_trending

Get trending Instagram reels.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/reels_trending` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/reels_trending.md

### instagram.search

Search Instagram accounts, hashtags and places.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/search?query=coffee` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `query` (string, required): Query
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.followers`, `author.verified`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/search.md

### instagram.search_hashtags

Search Instagram hashtags by keyword (topsearch).
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/search_hashtags?q=nasa` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search text
- Fields returned: `entity.id`, `entity.name`, `ext.posts`
- Reference: https://onekey.dev/docs/api/instagram/search_hashtags.md

### instagram.search_location

Search Instagram locations.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/search_location?query=coffee` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `query` (string, required): Query
- Fields returned: `entity.id`, `entity.name`, `place.address`, `place.city`, `place.lat`, `place.lon`
- Reference: https://onekey.dev/docs/api/instagram/search_location.md

### instagram.search_music

Search Instagram music.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/search_music?query=coffee` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `query` (string, required): Query
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `entity.id`, `entity.name`, `author.displayName`, `media.durationSeconds`, `media.thumbnailUrl`, `media.audioUrl`, `entity.url`, `ext.videoCount`
- Reference: https://onekey.dev/docs/api/instagram/search_music.md

### instagram.search_popular

Search popular Instagram posts.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/search_popular?query=coffee` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `query` (string, required): Query
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/search_popular.md

### instagram.search_reels

Search Instagram reels.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/search_reels?query=coffee` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `query` (string, required): Query
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/search_reels.md

### instagram.search_users

Search Instagram users by keyword (topsearch).
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/search_users?q=nasa` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search text
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.verified`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/search_users.md

### instagram.similar

List similar Instagram accounts.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/similar?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, optional): Handle
  - `user_id` (string, optional): Numeric Instagram user id (alternative to handle)
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.followers`, `author.verified`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/instagram/similar.md

### instagram.stories

List an Instagram user's active stories.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/stories?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, optional): Handle
  - `user_id` (string, optional): Numeric Instagram user id (alternative to handle)
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/stories.md

### instagram.story_download

Download a single Instagram story.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/story_download?user_id=1234567890&story_id=1234567890` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `user_id` (string, optional): User id
  - `story_id` (string, required): Story id
  - `handle` (string, optional): Instagram handle (alternative to user_id)
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/story_download.md

### instagram.tagged

List posts an Instagram user is tagged in.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/tagged?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, optional): Handle
  - `user_id` (string, optional): Numeric Instagram user id (alternative to handle)
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.url`, `content.title`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.views`, `media.thumbnailUrl`, `author.username`
- Reference: https://onekey.dev/docs/api/instagram/tagged.md

### instagram.user_embed

Get Instagram user embed HTML.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/instagram/user_embed?handle=natgeo` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Handle
- Fields returned: `author.username`, `ext.embedHtml`
- Reference: https://onekey.dev/docs/api/instagram/user_embed.md

### instagram.username_suggestions

Get Instagram username suggestions.
- Price: 3 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/instagram/username_suggestions?query=coffee` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `query` (string, required): Query
- Fields returned: `content.text`
- Reference: https://onekey.dev/docs/api/instagram/username_suggestions.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/instagram/post_oembed?shortcode=CUbHfhpswxt" \
  -H "x-api-key: YOUR_API_KEY"
```