README

Video Platforms Parser is easy to use SDK with grabber for multiple platforms at once, like YouTube, Dailymotion, Facebook and more.

Requirements

PHP 7.0 or higher
Laravel 5.4 or higher (not tested on lower but should work on 5.*)

Supported platforms

Platform	With API	Without API
YouTube	YES (key required)	YES
Dailymotion	YES	YES
Facebook	(not ready)	YES
Twitter	YES (key required)	YES
LiveLeak	NO API	YES
CDA	NO API	YES
Vimeo	YES	YES
Streamable	YES	YES

With API - parser is using official API (default) - fast and reliable (but YouTube require api key)
Without API - parser will grab video page and parse required info (needed in platforms that do not provide API or as a backup) - can be slower and less reliable

Every parser that is using API also has parser without API as backup. To use it you need to disable API for selected platform in config (not recommended).

Installation with Composer

Simply require package with composer:

composer require chojnicki/video-platforms-parser

Installation without Composer or Laravel

Download zip of this repository and unpack in your PHP project. Require VideoPlatformsParser file:

require '/video-platforms-parser/src/VideoPlatformsParser.php';

Usage with Laravel

Require package with composer:

composer require chojnicki/video-platforms-parser

(for Laravel below 5.5) In /config/app.php add Service Provider:

Chojnicki\VideoPlatformsParser\ServiceProvider::class,

(for Laravel below 5.5) In /config/app.php add Facade:

'VideoPlatformsParser' => Chojnicki\VideoPlatformsParser\Facade::class,

Publish config:

php artisan vendor:publish --provider="Chojnicki\VideoPlatformsParser\ServiceProvider"

Now You can start grabbing info like this:

$info = VideoPlatformsParser::get('https://www.youtube.com/watch?v=jofNR_WkoCE');

Usage without Laravel but with Composer

Require Composer to project if it was not required before

require_once 'vendor/autoload.php';

Create new object:

$parser = new Chojnicki\VideoPlatformsParser\VideoPlatformsParser(); // put array config inside

Grab video info like this:

$info = $parser->get('https://www.youtube.com/watch?v=jofNR_WkoCE');

Usage without Laravel and without Composer

Require parser

require '/video-platforms-parser/src/VideoPlatformsParser.php';

Manually load parsers for every video platform that will be used

require '/video-platforms-parser/src/parsers/YouTube.php';

Create new object:

$parser = new Chojnicki\VideoPlatformsParser\VideoPlatformsParser(); // put array config inside

Grab video info like this:

$info = $parser->get('https://www.youtube.com/watch?v=jofNR_WkoCE');

Returned data

For every supported platform parser will return array with:

id: video ID
platform: site name
title: video title
description: video description
thumbnail: url for image with highest possible resolution
tags: array with keywords
duration: length in seconds (not supported in LiveLeak and Facebook yet [more info])
api: will be true if official platform API was used and false otherwise

Optional config

Config is located in video-platforms-parser.php or you can pass array with VideoPlatformsParser object:

Default config:

[
    'youtube_api_key' => '',
    'youtube_api_disabled' => false,
    'dailymotion_api_disabled' => false,
    'vimeo_api_disabled' => false,
    'streamable_api_disabled' => false,
    'twitter_api_bearer_token' => '',
    'twitter_api_disabled' => false
]

chojnicki / video-platforms-parser

Maintainers

Details