Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

15 May 2026

Od tej daty endpoint oEmbed Instagrama Meta można wywołać bez tokenu dostępu, we wszystkich wersjach API.

1,000/hour

Liczba żądań na godzinę dozwolona w przewodniku Meta po oEmbed.

320 to 658

Zakres, który przyjmuje maxwidth; maxheight nie jest obsługiwane.

3 Nov 2025

Od kiedy odpowiedzi oEmbed Instagrama we wszystkich wersjach API nie zawierają pól author_name, author_url i miniatur.

Stories

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.

A request and its response
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().
Z EasyCoexistence zrobisz to

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