Ενσωμάτωση αναρτήσεων Instagram σε ιστότοπο με oEmbed
Το endpoint oEmbed του Instagram της Meta, GET /instagram_oembed?url=<POST_URL>, επιστρέφει το HTML που ενσωματώνει μια δημόσια ανάρτηση ή Reel του Instagram σε ιστοσελίδα, μαζί με τα version, provider_name, provider_url, type και width. Από τις 15 Μαΐου 2026 μπορεί να κληθεί χωρίς access token, και το HTML φορτώνει το embed.js του Instagram για να σχεδιάσει την ανάρτηση.
Το easyCoexistence επιστρέφει το permalink κάθε συνδεδεμένης ανάρτησης Instagram μέσω του list_social_posts, έτοιμο για να περαστεί στο oEmbed, και επιτρέπει στο Claude, στο ChatGPT ή στον δικό σας κώδικα να δημοσιεύει, να προγραμματίζει και να απαντά σε σχόλια και DMs του λογαριασμού μέσω του επίσημου API της Meta.
Από αυτή την ημερομηνία, το Instagram oEmbed API της Meta μπορεί να κληθεί χωρίς access token, σε όλες τις εκδόσεις.
Αιτήματα ανά ώρα που επιτρέπει ο οδηγός oEmbed της Meta.
Το εύρος τιμών που δέχεται το maxwidth, ενώ το maxheight δεν υποστηρίζεται.
Από την ημερομηνία που τα author_name, author_url και τα πεδία thumbnail αφαιρέθηκαν από τις απαντήσεις Instagram oEmbed σε όλες τις εκδόσεις του API.
Δεν υποστηρίζεται από το endpoint oEmbed, ούτε υποστηρίζονται αναρτήσεις από ιδιωτικούς, ανενεργούς ή με περιορισμό ηλικίας λογαριασμούς.
Πώς λειτουργεί το endpoint oEmbed του Instagram;
Στέλνετε το URL μιας δημόσιας ανάρτησης και παίρνετε πίσω το HTML που την εμφανίζει. Το endpoint βρίσκεται στον κύριο host του Graph API της Meta, αυτόν που χρησιμοποιούν οι κλήσεις του Facebook Login, και όχι στο graph.instagram.com. Η απόκριση είναι ένα μικρό αντικείμενο JSON, και το πεδίο html τοποθετείται στη σελίδα ως έχει.
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>"
}Ποια URL δέχεται το endpoint;
Τρεις μορφές, όπως τις αναφέρει ο οδηγός της Meta για την παράμετρο url. Μπορεί να σταλεί απλή ή κωδικοποιημένη σε URL, και τα δύο δείγματα αιτημάτων του οδηγού δείχνουν από μία:
- Μεμονωμένες εικόνες και carousel: https://www.instagram.com/p/{media-shortcode}/
- Βίντεο και Reels: https://www.instagram.com/reel/{media-shortcode}/
- Προφίλ: https://www.instagram.com/{username}
Χρειάζεται access token;
Όχι πια, από τις 15 Μαΐου 2026, όταν το changelog της Meta ανακοίνωσε ότι το Instagram oEmbed API μπορεί να κληθεί χωρίς αυτό. Πριν από τότε, οι εφαρμογές χρειάζονταν τη δυνατότητα Meta oEmbed Read μέσω του App Review και token σε κάθε κλήση, και η πρόσβαση με token εξακολουθεί να λειτουργεί. Ο οδηγός oEmbed της Meta επιτρέπει έως 1.000 αιτήματα την ώρα, και η ανακοίνωση της Meta για την πρόσβαση χωρίς token αναφέρει ότι οι εφαρμογές με token ενδέχεται να έχουν υψηλότερα όρια αιτημάτων.
Ποιες παραμέτρους δέχεται;
Τέσσερις εκτός από το url, από τον οδηγό της Meta και την τεκμηρίωσή της:
- maxwidth: από 320 έως 658. Κατά τα άλλα η ενσωμάτωση προσαρμόζεται στο μέγεθος της οθόνης, ενώ το maxheight δεν υποστηρίζεται.
- hidecaption: true κρύβει τη λεζάντα της ανάρτησης. Η προεπιλογή είναι false.
- omitscript: true αφαιρεί το script από το HTML, για σελίδες που φορτώνουν μόνες τους το embed.js μία φορά και καλούν το instgrm.Embeds.process().
- fields: περιορίζει την απόκριση στα πεδία που αναφέρονται.
Τι περιέχει η απόκριση;
Έξι προεπιλεγμένα πεδία: html, η σήμανση που εμφανίζετε· version, πάντα 1.0· provider_name και provider_url, που ονομάζουν το Instagram· type, ο τύπος πόρου oEmbed· και width, σε pixel. Στις 3 Νοεμβρίου 2025 η Meta αφαίρεσε τα author_name, author_url, thumbnail_url, thumbnail_width και thumbnail_height από τις απαντήσεις για αναρτήσεις Instagram, σε όλες τις εκδόσεις του API. Για αναρτήσεις του δικού σας λογαριασμού, το media edge εξακολουθεί να επιστρέφει τα username, permalink και thumbnail_url.
Τι δεν μπορεί να ενσωματωθεί;
Ο οδηγός της Meta αναφέρει τι αφήνει έξω το endpoint, και έναν κανόνα για τη χρήση του:
- Αναρτήσεις από ιδιωτικούς, ανενεργούς λογαριασμούς και λογαριασμούς με περιορισμό ηλικίας.
- Λογαριασμούς που έχουν απενεργοποιήσει τις ενσωματώσεις.
- Stories, και σελίδες που αποδίδουν την ενσωμάτωση μέσα σε Shadow DOM.
- Οποιαδήποτε χρήση πέρα από την προβολή σε front end: η Meta απαγορεύει αυστηρά τη χρήση των μεταδεδομένων ή του περιεχομένου του endpoint για άλλους σκοπούς.
Πώς ενσωματώνετε τις αναρτήσεις του δικού σας λογαριασμού;
Πάρτε το permalink κάθε ανάρτησης και περάστε το ως url. Μέσω του easyCoexistence, το list_social_posts επιστρέφει τις πρόσφατες αναρτήσεις του συνδεδεμένου λογαριασμού με τα permalinks τους, από το Claude, το ChatGPT ή τον δικό σας κώδικα. Επειδή η κλήση oEmbed δεν χρειάζεται token, ο ιστότοπός σας μπορεί να την κάνει απευθείας.
Συνηθισμένα λάθη
- Αποστολή συνδέσμου Story. Το endpoint oEmbed της Meta δεν υποστηρίζει Stories, οπότε ενσωματώστε μια ανάρτηση ή ένα Reel.
- Ανάγνωση του thumbnail_url από την απόκριση. Η Meta το αφαίρεσε, μαζί με το author_name και τα υπόλοιπα πεδία thumbnail, στις 3 Νοεμβρίου 2025.
- Ορισμός του maxwidth κάτω από 320 ή πάνω από 658. Η Meta δέχεται μόνο τιμές σε αυτό το εύρος και καθόλου maxheight.
- Φόρτωση του embed.js σε κάθε ενσωμάτωση. Με omitscript: true, φορτώστε το script μία φορά και καλέστε το instgrm.Embeds.process().
Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορώ να ενσωματώσω ένα Instagram Reel;
Ναι. Περάστε το URL https://www.instagram.com/reel/{media-shortcode}/ και το endpoint επιστρέφει το HTML ενσωμάτωσης.
Είναι responsive η ενσωμάτωση του Instagram;
Ναι. Ο οδηγός της Meta αναφέρει ότι η ενσωμάτωση προσαρμόζεται στο μέγεθος της οθόνης, και το maxwidth ορίζει το μέγιστο πλάτος της.
Μπορώ να ενσωματώσω ένα προφίλ Instagram;
Ναι. Ο οδηγός της Meta αναφέρει τα URL προφίλ, https://www.instagram.com/{username}, ανάμεσα στις μορφές που δέχεται η παράμετρος url.
Μπορώ να χρησιμοποιήσω δεδομένα oEmbed για αναλυτικά στοιχεία;
Όχι. Η Meta επιτρέπει το endpoint μόνο για την προβολή της ανάρτησης σε σελίδα ή εφαρμογή, και απαγορεύει κάθε άλλη χρήση των μεταδεδομένων και του περιεχομένου του.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις