Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chojnicki/video-platforms-parser
Easy to use grabber for video info, screens and more from YouTube and other platforms.
https://github.com/chojnicki/video-platforms-parser
Last synced: 10 days ago
JSON representation
Easy to use grabber for video info, screens and more from YouTube and other platforms.
- Host: GitHub
- URL: https://github.com/chojnicki/video-platforms-parser
- Owner: chojnicki
- Created: 2019-04-14T19:21:25.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-11T14:43:12.000Z (about 1 month ago)
- Last Synced: 2024-10-11T15:39:23.803Z (about 1 month ago)
- Language: PHP
- Homepage:
- Size: 50.8 KB
- Stars: 222
- Watchers: 10
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Video Platforms Parser
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
```
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]](https://github.com/chojnicki/video-platforms-parser/issues/4))
- 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
]
```