Embedly library for PHP
PHP Cucumber
Latest commit bd1bc19 Aug 22, 2016 @dokipen dokipen committed on GitHub Merge pull request #24 from TomasVotruba/patch-1
Readme: add missing composer autoload
Failed to load latest commit information.
examples Updates for batter api compat. Jan 13, 2012
features Merge branch 'extract' Apr 2, 2013
.gitignore Adds extract endpoint Apr 2, 2013
MIT-LICENSE init Feb 11, 2011
README.rst Readme: fix require `autoload.php` line and simplify composer install Aug 15, 2016
composer.json phpunit and behat should be placed in composer require-dev not require Jul 31, 2013
package.xml Bump version Mar 17, 2014



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. Install this package with comopser:

``php composer.phar require embedly/embedly-php``


require_once('Embedly/src/Embedly/Embedly.php');  // if using pear
// require_once('src/Embedly/Embedly.php');  // if using source
// require_once(__DIR__ . '/vendor/autoload.php'); // if using Composer

$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.