https://github.com/cool-dev-guy/vidsrc-api
A working vidsrc.to/vidsrc.me extractor as an api. Proof of concept and educational.(depreciated) instead use https://github.com/cool-dev-guy/vidsrc.ts
https://github.com/cool-dev-guy/vidsrc-api
api api-rest fastapi movie python python3 scraper series vidsrc vidsrc-api
Last synced: 2 months ago
JSON representation
A working vidsrc.to/vidsrc.me extractor as an api. Proof of concept and educational.(depreciated) instead use https://github.com/cool-dev-guy/vidsrc.ts
- Host: GitHub
- URL: https://github.com/cool-dev-guy/vidsrc-api
- Owner: cool-dev-guy
- License: gpl-3.0
- Created: 2024-01-12T01:14:57.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-16T06:01:22.000Z (almost 2 years ago)
- Last Synced: 2024-09-17T07:10:47.696Z (over 1 year ago)
- Topics: api, api-rest, fastapi, movie, python, python3, scraper, series, vidsrc, vidsrc-api
- Language: Python
- Homepage: https://github.com/cool-dev-guy/vidsrc.ts
- Size: 127 KB
- Stars: 74
- Watchers: 7
- Forks: 119
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vidsrc-api
### `IMPORTANT`
## UPDATE : PROJECT ABANDONED FOR LIMITED TIME
#### `MOVED TO` [https://github.com/cool-dev-guy/vidsrc.ts](https://github.com/cool-dev-guy/vidsrc.ts)
- The providers changed a lot in their code structure.
- And vidsrc.to is no more...
- So project moved to NEW [https://github.com/cool-dev-guy/vidsrc.ts](https://github.com/cool-dev-guy/vidsrc.ts)
- WHAT'S NEW ?
- Code base shifted to use typescript(node/deno compatible)
- Fast execution and simple to read code structure.
[](https://api-movie-source.vercel.app/)
[](https://api-movie-source.vercel.app/)
`STATUS`- `WORKING` - `(UPDATED MAR/31/24)`
- Added stable fixes for most of the sources so it wont break too often.
- Everything Works currently and the speed has also increased in the latest commit dut o use of non-blocking async functions.
- Still the code may have some bugs,so feel free to post bugs in the issue section :)
A simple web scrapper based on this [resolver](https://github.com/Ciarands).
## About
- ### Deploying methods.
- #### _Any Platform_
Project specifically made to run on vercel,but easy to deploy on other platforms.Just check the running fastapi on the specific platform.
- #### _Vercel_
Project is easy to deploy on vercel.
1. `Fork` this `repo`.
2. Open vercel and create `new project` and choose your `forked repo`.
3. Use the default settings and click `deploy`.
4. Your build will `surely fail` because of [this](https://github.com/orgs/vercel/discussions/6287)
*_vercel's latest update.Node.js version 20.x dosent fully support python._
6. Now open the project's settings and scroll down.Now you can see a row caled `Node Version`.
`CHANGE it to 18.x`
*_there's an detailed explanation in this issue [link](https://github.com/cool-dev-guy/vidsrc-api/issues/12#issuecomment-2032147362)_
- #### _Vercel easy_
Or if vercel fixes this bug,you can use this button.But vercel didnt fix this yet.
[](https://vercel.com/new/clone?repository-url=https://github.com/cool-dev-guy/vidsrc-api)
`IMPORTANT `: Vercel is facing a bug recently so setting node version to `18.x` is a fix for it.
*_there's an detailed explanation in this issue [link](https://github.com/cool-dev-guy/vidsrc-api/issues/12#issuecomment-2032147362)_
- ### Running it locally
1.Fork and Clone the repo.
2.Create a virtial env if you want.
3.install the deps.[`pip install -r requirements.txt`]
4.open `models/utils.py` and change the value of `BASE` to your `api-base-url`/`deployment-base-url`.( for subtitle )
5.install `uvicorn` via `pip install uvicorn` & run it using uvicorn.[`uvicorn main:app --reload --port=8000`]
- If you liked the project and updates `buy me a coffee` :)
- If any issues,drop an issue on `github issues`.
### FEATURES
```
- async support - Most process are async but still some fixes are needed.
- very fast results
- subtitle support for every sources.
```
### NOTES
```
- Dont overload the deployment.
- This api is made for educational purpouse only. This is just a simple scrapper built arround `https://github.com/Ciarands` vidsrc downloader.This project was only made to prevent ads and redirects caused by the `iframe`s
- This api isnt a copy of the inspired project,but its a complete reqrite of code to make it work as an api and use async style to give vary fast results.
- Dont perform bulk request to the api and store the m3u8's returned,cuz they may not work after 24 hours or so.This api scrape websites that have `video on demand` feature so storing it is useless.
```
### USAGE (`GET`)
- example base url:
https://api.vercel.app
- endpoints:
- `/vidsrc/{db_id}` - vidsrc.to
- `/vsrcme/{db_id}` - vidsrc.me
- `/streams/{db_id}` - get streams from all 4 sources in one request.
- `/subs/?url={subtitle_url@opensubtitles.org}`
- parameters:
- `s` - season (series only)
- `e` - episodes (series only)
- `l` - language(subtitle)
- example url (movie) : `https://api.vercel.app/vidsrc/ttXXXXXX`
- example url (series) : `https://api.vercel.app/vidsrc/ttXXXXXX?s=1&e=2`
### RESPONSE SCEMA
> [UPDATE] Added a common response scheam for the endpoints,so every source is an element of an array.And the api retruns an array.
- `Working`
```json
{
"status":200,
"info":"success",
"sources":[
{
"name": "SOURCE_NAME",
"data": {
"stream": "FILE.m3u8",
"subtitle": [
{
"lang":"LANGUAGE",
"file":"FILE.srt"
}
{
"lang":"LANGUAGE2",
"file":"FILE2.srt"
}
]
}
},
{
"name": "SOURCE_NAME2",
"data": {
"stream": "FILE2.m3u8",
"subtitle": [
{
"lang":"LANGUAGE",
"file":"FILE.srt"
}
{
"lang":"LANGUAGE2",
"file":"FILE2.srt"
}
]
}
}
]
}
```
- `Error/Stream Unavailable`
```json
{
"status":200,
"info":"success",
"sources":[]
}
### ERROR CODES
```
ERROR CODES
===========
TODO
```
### OTHER PROJECTS
- [cool-proxy](https://github.com/cool-dev-guy/cool-proxy) - A proxy made in C++