Osadzanie postów z Instagrama na stronie za pomocą oEmbed
Endpoint oEmbed Instagrama Meta, GET /instagram_oembed?url=<POST_URL>, zwraca kod HTML, który osadza publiczny post lub Reela na stronie internetowej, wraz z polami version, provider_name, provider_url, type i width. Od 15 maja 2026 można go wywołać bez tokenu dostępu, a kod HTML wczytuje embed.js Instagrama, by wyświetlić post.
easyCoexistence zwraca permalink każdego połączonego posta na Instagramie przez list_social_posts, gotowy do przekazania do oEmbed, i pozwala Claude, ChatGPT lub Twojemu kodowi publikować, planować oraz odpowiadać na komentarze i wiadomości prywatne na koncie przez oficjalne API Meta.
Od tej daty endpoint oEmbed Instagrama Meta można wywołać bez tokenu dostępu, we wszystkich wersjach API.
Liczba żądań na godzinę dozwolona w przewodniku Meta po oEmbed.
Zakres, który przyjmuje maxwidth; maxheight nie jest obsługiwane.
Od kiedy odpowiedzi oEmbed Instagrama we wszystkich wersjach API nie zawierają pól author_name, author_url i miniatur.
Endpoint oEmbed nie obsługuje postów z kont prywatnych, nieaktywnych ani z ograniczeniem wiekowym.
Jak działa endpoint oEmbed Instagrama?
Wysyłasz adres URL publicznego posta i otrzymujesz kod HTML, który go wyświetla. Endpoint działa na głównym hoście Graph API Meta, z którego korzystają wywołania Facebook Login, a nie na graph.instagram.com. Odpowiedzią jest mały obiekt JSON, którego pole html wstawiasz na stronę bez zmian.
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/
{
"version": "1.0",
"provider_name": "Instagram",
"provider_url": "https://www.instagram.com/",
"type": "rich",
"width": 658,
"html": "<EMBED_HTML>"
}Jakie adresy URL są akceptowane?
Trzy formaty, wymienione w przewodniku Meta dla parametru url. Mogą być przesłane zwykłe lub zakodowane w URL; dwa przykładowe żądania z przewodnika pokazują po jednym z nich:
- Posty z pojedynczym obrazem i karuzele: https://www.instagram.com/p/{media-shortcode}/
- Filmy i Reele: https://www.instagram.com/reel/{media-shortcode}/
- Profile: https://www.instagram.com/{username}
Czy potrzebny jest token dostępu?
Nie od 15 maja 2026, kiedy w dzienniku zmian Meta napisano, że API oEmbed Instagrama można wywoływać bez tokenu. Wcześniej aplikacje potrzebowały funkcji Meta oEmbed Read przyznanej w App Review oraz tokenu przy każdym wywołaniu; dostęp oparty na tokenie nadal działa. Przewodnik Meta po oEmbed pozwala na do 1,000 żądań na godzinę, a ogłoszenie Meta o dostępie bez tokenu mówi, że aplikacje z tokenem mogą mieć wyższe limity.
Jakie parametry przyjmuje?
Cztery oprócz url, z przewodnika Meta i jego dokumentacji:
- maxwidth: od 320 do 658; osadzenie jest poza tym responsywne, a maxheight nie jest obsługiwane.
- hidecaption: true ukrywa podpis posta; domyślnie jest false.
- omitscript: true pomija skrypt w kodzie HTML, na stronach, które same wczytują embed.js raz i wywołują instgrm.Embeds.process().
- fields: ogranicza odpowiedź do wskazanych pól.
Co zawiera odpowiedź?
Sześć pól domyślnych: html, czyli kod do wyświetlenia; version, zawsze 1.0; provider_name i provider_url, wskazujące Instagrama; type, czyli typ zasobu oEmbed; oraz width, w pikselach. Meta usunęła author_name, author_url, thumbnail_url, thumbnail_width i thumbnail_height z odpowiedzi dla postów Instagrama we wszystkich wersjach API 3 listopada 2025. Dla postów na Twoim koncie krawędź media nadal zwraca username, permalink i thumbnail_url.
Czego nie da się osadzić?
Przewodnik Meta wymienia, czego endpoint nie obejmuje, oraz jedną zasadę dotyczącą użycia:
- Posty z kont prywatnych, nieaktywnych i z ograniczeniem wiekowym.
- Konta, które wyłączyły osadzanie.
- Relacje oraz strony renderujące osadzenie wewnątrz Shadow DOM.
- Każde użycie wykraczające poza widok na froncie: Meta zdecydowanie zabrania wykorzystywania metadanych lub treści endpointu do innych celów.
Jak osadzić posty ze swojego konta?
Weź stały link (permalink) każdego posta i przekaż go jako url. Przez easyCoexistence narzędzie list_social_posts zwraca ostatnie posty połączonego konta wraz z permalinkami, a Claude, ChatGPT lub Twój własny kod mogą z niego korzystać. Ponieważ wywołanie oEmbed nie wymaga tokenu, Twoja strona może wykonać je bezpośrednio.
Typowe błędy
- Wysłanie linku do relacji. Endpoint oEmbed Meta nie obsługuje relacji, więc osadź post lub Reela.
- Odczytywanie thumbnail_url z odpowiedzi. Meta usunęła je razem z author_name i pozostałymi polami miniatur 3 listopada 2025.
- Ustawienie maxwidth poniżej 320 lub powyżej 658. Meta akceptuje wartości tylko z tego zakresu, a maxheight w ogóle nie.
- Wczytywanie embed.js przy każdym osadzeniu. Gdy omitscript ma wartość true, wczytaj skrypt raz i wywołaj instgrm.Embeds.process().
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, im więcej połączeń, tym taniej, a pierwsze 3 dni są w bezpłatnym okresie próbnym.
Najczęściej zadawane pytania
Czy mogę osadzić Reela na Instagramie?
Tak. Przekaż jego adres https://www.instagram.com/reel/{media-shortcode}/, a endpoint zwróci kod HTML osadzenia.
Czy osadzenie z Instagrama jest responsywne?
Tak. Przewodnik Meta mówi, że osadzenie jest responsywne, a maxwidth ustawia jego maksymalną szerokość.
Czy mogę osadzić profil na Instagramie?
Tak. Przewodnik Meta wymienia adresy profili, https://www.instagram.com/{username}, wśród formatów akceptowanych przez parametr url.
Czy mogę użyć danych oEmbed do analityki?
Nie. Meta zezwala na endpoint wyłącznie do pokazywania posta na stronie lub w aplikacji, a zabrania innych zastosowań metadanych i treści.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w