README

OEmbed is a PHP library to assist you retrieving data from providers that supports OEmbed.
It was built to be a successor of ricardofiorani/php-video-url-parser.

Installation

Install the latest version with

$ composer require ricardofiorani/oembed

Requirements

PHP 8.2, 8.3, 8.4, or 8.5
A PSR-18 implementation
A PSR-17 implementation of RequestFactory and UriFactory

Basic Usage

<?php declare(strict_types=1);

use Your\PSR7Implementation\Uri;
use RicardoFiorani\OEmbed\OEmbed;

require __DIR__ . '/vendor/autoload.php';

$service = new OEmbed();

$uri = new Uri('https://www.dailymotion.com/video/x804zfb?playlist=x6ymns');

$result = $service->get(
    $uri,
    480,
    300,
    ['omitscript' => true]
);

echo (string)$result; //will render the HTML (in case of "video" or "rich") or URL (in case of "photo")

Services tested and passing

Apple Podcasts
Balsamiq Cloud
Bluesky Social
Canva
CodeSandbox
Dailymotion
Datawrapper
DeviantArt
Figma
Giphy
iHeartRadio
Loom
Miro
MixCloud
Pinterest
Prezi Video
Reddit
Replit
Scribd
Soundcloud
Spotify
TED
TikTok
Tumblr
Twitter
Vimeo
Youtube

Services tested but skipped

CodePen — Cloudflare blocks automated requests
ElevenLabs — Claims oEmbed support but no URL works
Facebook* — Requires authentication, blocks open access
Framer — No working URL found
Hulu — oEmbed support deprecated by provider
IFTTT — Service no longer works
Instagram* — Requires authentication, blocks open access
Kickstarter — Server blocks automated requests (custom headers needed)
Microsoft Stream — Requires authentication
Observable — oEmbed implementation appears broken
Rumble — Waiting for oembed.com provider list update

*Facebook and Instagram requires authentication
Please see https://developers.facebook.com/docs/instagram/oembed
Also please see the example at the bottom of this doc

Services supported but not tested

These services from the former "tested" section have no integration test file:

Brightcove
Gfycat
Livestream
Me.me
Sketch
SlideShare
Twitch
Wistia
Wolfram Cloud
WordPress.com
23HQ
Abraia
Adways
Alpha App Net
Altru
amCharts Live Editor
Animatron
Animoto
Apester
ArcGIS StoryMaps
Archivos
Audioboom
AudioClip
Audiomack
AudioSnaps
Avocode
AxiomNinja
Backtracks
Beautiful.AI
Blackfire.io
Blogcast
Box Office Buz
BrioVR
Buttondown
Byzart Project
Cacoo
Carbon Health
CatBoat
Ceros
ChartBlocks
chirbit.com
CircuitLab
Clipland
Clyp
CoCo Corp
CodeHS
Codepen
Codepoints
CollegeHumor
Commaful
Coub
Crowd Ranking
Cyrano Systems
Daily Mile
Deseret News
Didacte
Digiteka
Dipity
DocDroid
Dotsub
DTube
edocr
eduMedia
EgliseInfo
Embed Articles
Embedery
Embedly
Ethfiddle
Eyrie
Fader
Faithlife TV
Firework
FITE
Flat
Flickr
Flourish
Fontself
FOX SPORTS Australia
FrameBuzz
FunnyOrDie
Geograph Britain and Ireland
Geograph Channel Islands
Geograph Germany
Getty Images
Gifnote
GloriaTV
GT Channel
Gyazo
hearthis.at
hihaho
Homey
HuffDuffer
iFixit
Indaco
Infogram
Infoveave
Injurymap
Inoreader
inphood
iSnare Articles
Issuu
ivlismusic
Jovian
KakaoTv
Kidoju
Kirim.Email
Kit
Kitchenbowl
Knacki
Knowledge Pad
LearningApps.org
Lille.Pod
Ludus
MathEmbed
Matterport
MediaLab
Medienarchiv der Künste - Zürcher Hochschule der Künste
Mermaid Ink
Microlink
Moby Picture
Modelo
MorphCast
Music Box Maniacs
myBeweeg
Namchey
nanoo.tv
Nasjonalbiblioteket
Natural Atlas
nfb.ca
Odds.com.au
Odesli (formerly Songlink)
Official FM
Omniscope
On Aol
Ora TV
Orbitvu
Oumy
Outplayed.tv
Overflow
OZ
Padlet
Pastery
PingVP
Pinpoll
Pixdor
Podbean
Polaris Share
Poll Daddy
Port
Portfolium
posiXion
Qualifio
Quiz.biz
Quizz.biz
RadioPublic
RapidEngage
ReleaseWire
RepubHub
ReverbNation
RiffReporter
Roomshare
RoosterTeeth
Runkit
Sapo Videos
Screen9
Screencast.com
Screenr
ScribbleMaps
SendtoNews
ShortNote
Shoudio
Show the Way, actionable location info
Simplecast
Sizzle
Sketchfab
SmashNotes
SmugMug
SocialExplorer
Soundsgood
SpeakerDeck
Spotful
Spreaker
Stanford Digital Repository
Streamable
StreamOneCloud
Sutori
Sway
The New York Times
They Said So
TickCounter
Toornament
Topy
Tuxx
tvcf
TypeCast
Typlog
Ubideo
University of Cambridge Map
UnivParis1.Pod
UOL
Ustream
uStudio, Inc.
Utposts
Uttles
VeeR VR
Verse
VEVO
VideoJug
Vidlit
Vidmizer
Vidyard
Viously
Viziosphere
Vizydrop
Vlipsy
VLIVE
Vlurb
VoxSnap
Wave.video
wecandeo
Wiredrive
wizer.me
Wokwi
Wootled
Xpression
Yes, I Know IT!
YFrog
Zeplin
ZingSoft
ZnipeTV
Zoomable
Plus all not mentioned available on https://oembed.com/providers.json

Currently Supported PHP Versions

PHP 8.2 || 8.3 || 8.4 || 8.5

Facebook and Instagram requiring authentication

Yeah I know, it sucks having to create an FB app and generate a token.

Anyway, there is two ways (maybe more but I can only think of two now) of making this lib work with FB and IG.

Method 1

You make a custom HTTP client (implementing \Psr\Http\Client\ClientInterface) and instructs it to retrieve the token following Facebook guidelines.

Method 2

Easier way, you just send your Application ID and Secret as an extra parameter to the endpoint and that's it.

$service = new OEmbed();

$uri = new Uri('https://www.facebook.com/FacebookDeutschland/videos/2403439749688130/');

$result = $service->get(
    $uri,
    480,
    300,
    ['access_token' => `{$appId}|{$appSecret}`]
);

ricardofiorani / oembed

Maintainers

Package info

Statistics

Security