# Instagram Embed API. Send a post, video or profile link, or an ID. Embed code for a post, reel or profile. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dinstagram.embed) ## Instagram Embed API at a glance Returns Instagram's own embed code for a public post, reel or profile, from its link. You get the HTML snippet, with or without the caption and the embed.js tag, at the width you choose, plus the iframe link it loads, the caption or profile title, the author and the thumbnail with its size. GET `/v1/instagram/embed` [Read the API reference](https://socialtap.dev/docs/reference/instagram/embed/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **13 typed fields** null when unknown - **`url`** is all it needs, e.g. `https://www.instagram.com/p/DeuOR-CjKE9/` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 13 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `url = https://www.instagram.com/p/DeuOR-CjKE9/` [Open in playground](https://socialtap.dev/playground/?endpoint=instagram.embed) cURL: ```shell curl -G 'https://socialtap.dev/v1/instagram/embed' \ --data-urlencode 'url=https://www.instagram.com/p/DeuOR-CjKE9/' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.instagram.embed.get({ url: "https://www.instagram.com/p/DeuOR-CjKE9/" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ url: "https://www.instagram.com/p/DeuOR-CjKE9/", }); const res = await fetch(`https://socialtap.dev/v1/instagram/embed?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/instagram/embed", params={"url": "https://www.instagram.com/p/DeuOR-CjKE9/"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("url", "https://www.instagram.com/p/DeuOR-CjKE9/") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/instagram/embed?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "author": { "avatar_url": null, "display_name": "National Geographic", "id": "787132", "is_verified": null, "url": "https://www.instagram.com/natgeo/", "username": "natgeo" }, "embed_url": "https://www.instagram.com/p/DeuOR-CjKE9/embed/captioned/", "height": null, "html": "
/p/…, share links, m.instagram.com, instagr.am, instagram.com/\/) or a post's raw shortcode. - ### What comes back Platforms' own embed code for public posts, videos, playlists and profiles: the HTML to paste, its iframe URL and size, and the title, author and thumbnail it shows. - **`platform`string**: Platform ID (instagram, youtube, tiktok, …). - **`type`string**: What is embedded, named by its resource: post (any post: photo, carousel, video, reel), profile (an account), or playlist. New values may be added; treat unknown values as other. - **`id`string**: The ID the platform's embed is addressed by (as in embed_url): a post's ID (equals post.id), a playlist's ID, and for a profile the account's username on platforms whose profile embeds are addressed by it (Instagram, TikTok); the account's numeric ID, when known, is author.id. - **`url`string**: Canonical public URL of what is embedded (post.url, profile.url): the link the embed opens. - **`html`string**: The platform's embed code, ready to paste into an HTML page: its markup and, unless asked to leave it out, the script tag that turns it into the embedded post or profile. It loads the platform's script and content in the visitor's browser. - **`embed_url`string**: The platform's embed page alone, for an iframe's src (what html's script loads); null when the platform has none. - **`width`integer**: Width in pixels the embed is laid out for (its maximum when it is responsive); null when the platform does not say. - **`height`integer**: Height in pixels; null when the embed sizes itself to its content (Instagram's always do). Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Instagram Embed API. - ### Embed posts and profiles in a CMS - ### Show customer posts on product pages - ### Build link previews with Instagram's own thumbnail - ### Check a post is embeddable before publishing ## Good to know before you build. - html is Instagram's own markup, drawn in the visitor's browser by embed.js, so a post deleted or made private later stops showing. - Deleted posts and unknown usernames return not_found. Private, age-restricted and region-gated accounts and posts, and those whose account turned off embedding, return private_or_unavailable. - A profile embed's id is the username. author.id, the numeric account ID, is null unless Instagram's oEmbed API failed and the profile's embed page answered. - thumbnail_url is a CDN link that expires. - Send a profile link, not a bare username: a bare string is read as a post's shortcode. ## 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/instagram/embed/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Instagram Embed API. More in the [API reference](https://socialtap.dev/docs/reference/instagram/embed/index.md). **Is this the same code as Instagram's Embed button?** Yes. It's the blockquote and embed.js script Instagram's oEmbed returns. When that API fails, we rebuild it from the post or profile page in Instagram's exact template, so the snippet is the same. **Can I embed several posts on one page?** Yes. Send omit_script=true for each and load Instagram's embed.js once. Call window.instgrm.Embeds.process() after you insert markup later. **Does it work for profiles?** Yes. A profile link returns the profile embed (picture, name and recent posts), with the profile picture as the thumbnail. **How much does the Instagram Embed API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. More Instagram ## Instagram API. 28 endpoints, one key. - [Instagram Post API](https://socialtap.dev/apis/instagram/post/index.md) (1 credit · `GET /v1/instagram/post`) - [Instagram Story API](https://socialtap.dev/apis/instagram/story/index.md) (1 credit · `GET /v1/instagram/story`) - [Instagram Posts API](https://socialtap.dev/apis/instagram/posts/index.md) (1 credit / page · `GET /v1/instagram/posts`) - [Instagram Reels API](https://socialtap.dev/apis/instagram/reels/index.md) (1 credit / page · `GET /v1/instagram/reels`) - [Instagram Search API](https://socialtap.dev/apis/instagram/search_posts/index.md) (1 credit / page · `GET /v1/instagram/search_posts`) - [Instagram Audio Reels API](https://socialtap.dev/apis/instagram/sound_posts/index.md) (1 credit / page · `GET /v1/instagram/sound_posts`) - [Instagram Hashtag Posts API](https://socialtap.dev/apis/instagram/hashtag_posts/index.md) (1 credit / page · `GET /v1/instagram/hashtag_posts`) - [Instagram Location Posts API](https://socialtap.dev/apis/instagram/place_posts/index.md) (1 credit / page · `GET /v1/instagram/place_posts`) - [Instagram Trending Reels API](https://socialtap.dev/apis/instagram/trending_posts/index.md) (1 credit / page · `GET /v1/instagram/trending_posts`) - [Instagram Highlight Stories API](https://socialtap.dev/apis/instagram/playlist_stories/index.md) (1 credit / page · `GET /v1/instagram/playlist_stories`) - [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`) - [Instagram Similar Accounts API](https://socialtap.dev/apis/instagram/similar_profiles/index.md) (1 credit / page · `GET /v1/instagram/similar_profiles`) - [Instagram Comment API](https://socialtap.dev/apis/instagram/comment/index.md) (1 credit · `GET /v1/instagram/comment`) - [Instagram Comments API](https://socialtap.dev/apis/instagram/comments/index.md) (1 credit / page · `GET /v1/instagram/comments`) - [Instagram Reels Transcript API](https://socialtap.dev/apis/instagram/transcript/index.md) (From 1 credit · `GET /v1/instagram/transcript`) - [Instagram Hashtag API](https://socialtap.dev/apis/instagram/hashtag/index.md) (1 credit · `GET /v1/instagram/hashtag`) - [Instagram Hashtag Search API](https://socialtap.dev/apis/instagram/search_hashtags/index.md) (1 credit / page · `GET /v1/instagram/search_hashtags`) - [Instagram User Search API](https://socialtap.dev/apis/instagram/search_profiles/index.md) (From 1 credit / page · `GET /v1/instagram/search_profiles`) - [Instagram Audio Search API](https://socialtap.dev/apis/instagram/search_sounds/index.md) (From 1 credit / page · `GET /v1/instagram/search_sounds`) - [Instagram Location Search API](https://socialtap.dev/apis/instagram/search_places/index.md) (From 1 credit / page · `GET /v1/instagram/search_places`) - [Instagram Highlights API](https://socialtap.dev/apis/instagram/highlights/index.md) (1 credit / page · `GET /v1/instagram/highlights`) - [Instagram Engagement API](https://socialtap.dev/apis/instagram/engagement/index.md) (1 credit · `GET /v1/instagram/engagement`) - [Instagram Search Suggestions API](https://socialtap.dev/apis/instagram/search_suggestions/index.md) (1 credit / page · `GET /v1/instagram/search_suggestions`) - [Instagram Location API](https://socialtap.dev/apis/instagram/place/index.md) (1 credit · `GET /v1/instagram/place`) - [Instagram Audio API](https://socialtap.dev/apis/instagram/sound/index.md) (1 credit · `GET /v1/instagram/sound`) - [Instagram Topic API](https://socialtap.dev/apis/instagram/topic/index.md) (1 credit · `GET /v1/instagram/topic`) - [Instagram Username Availability API](https://socialtap.dev/apis/instagram/username/index.md) (1 credit · `GET /v1/instagram/username`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/instagram/embed/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)