Embedly library for PHP

Installs: 54 546

Dependents: 8

Stars: 83

Watchers: 16

Forks: 25

Open Issues: 2

v0.5.4 2014-03-17 17:30 UTC


A PHP library for using the Embedly API. To find out what Embedly is all about, please visit http://embed.ly. To see our api documentation, visit http://api.embed.ly/docs.


You will need at least PHP version 5.3 with curl enabled. Behat and PHPUnit are required to run the test suite. Pear is recommended.


To install:

1. Download the composer.phar executable or use the installer.

curl -sS https://getcomposer.org/installer | php

2. Create a composer.json defining your dependencies. Note that this example is a short version for applications that are not meant to be published as a packages themselves.

  "require": [
  1. Run Composer: php composer.phar install


require_once('Embedly/src/Embedly/Embedly.php');  // if using pear
// require_once('src/Embedly/Embedly.php');  // if using source

$api = new Embedly\Embedly(array('user_agent' => 'Mozilla/5.0 (compatible; mytestapp/1.0)'));

// Single url
$objs = $api->oembed('http://www.youtube.com/watch?v=sPbJ4Z5D-n4&feature=topvideos');

// Multiple urls
$obj = $api->oembed(array(
    'urls' => array(

// Call with pro (you'll need a real key)
$pro = new Embedly\Embedly(array(
    'key' => 'xxxxxxxxxxxxxxxx',
    'user_agent' => 'Mozilla/5.0 (compatible; mytestapp/1.0)'
$objs = $pro->extract(array(
    'urls' => array(


git clone git://github.com/embedly/embedly-php.git
curl -sS https://getcomposer.org/installer | php
php composer.phar install
export EMBEDLY_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


Copyright (c) 2011 Embed.ly, Inc. See MIT-LICENSE for details.