OEmbed

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}`]
);