This API endpoint was modified by Bondhu Digital.
Downloads YouTube videos using `yt-dlp`, then optionally cuts segments using `ffmpeg`. Input via JSON.
Disclaimer: Downloading YouTube videos may violate their Terms of Service. Use responsibly.
Logging: Check .log files in youtube_downloads/ on errors.
Server Status
- yt-dlp Path:
/home/bondhudi/virtualenv/Bondhu_API/3.11/bin/yt-dlp - yt-dlp Status: Installed ✅ (Version: 2025.11.12)
- FFmpeg Path:
/home/bondhudi/virtualenv/Bondhu_API/3.11/bin/ffmpeg - FFmpeg Status: Found ✅ (Required for cutting sections)
- PHP cURL Ext: Installed ✅
- Permissions:
- Output Dir (youtube_downloads): Writable ✅
- Temp Dir (temp_yt_downloads): Writable ✅
API Usage
Endpoint
https://api.bondhudigital.com/index.php
Method
POST
Headers
Content-Type: application/json
Request Body (JSON Payload)
Send a JSON object with the following structure:
{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"name": "custom_video_name",
"start_time": 30,
"end_time": 120
}url(Required): String (Full YouTube video URL).name(Optional): String. Custom base name for the output file (sanitized). Defaults to Video ID.start_time(Optional): Number or String. Time in seconds to start the segment.end_time(Optional): Number or String. Time in seconds to end the segment.
Note on Timestamps: If timestamps are provided, the full video is downloaded first, then cut using FFmpeg (`-c copy` for speed). Accuracy depends on video keyframes.
Success Response (JSON)
Returns a link to the downloaded file and its filename.
{
"url": "https://api.bondhudigital.com/youtube_downloads/output_filename.mp4",
"filename": "output_filename.mp4"
}Error Response (JSON)
{
"error": "Error message from yt-dlp, ffmpeg, or script."
}Check the corresponding .log file in youtube_downloads/ for details.
How to Use (cURL Example)
Copy the command, replace values inside the JSON (`-d` argument), and run.
curl -X POST 'https://api.bondhudigital.com/index.php' \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","name":"custom_video_name","start_time":30,"end_time":120}'
Using with n8n:
- Use 'HTTP Request' node (POST, URL:
https://api.bondhudigital.com/index.php, Body: JSON). - In JSON / Parameter field, construct payload:
={{ { "url": $json.youtubeUrl, "name": $json.customName, "start_time": $json.startTimeInSeconds, "end_time": $json.endTimeInSeconds } }}
(Adjust expressions, omit optional fields if not needed).
Important Notes & Troubleshooting
- Dependencies: `yt-dlp` (install/update: `yt-dlp -U`), `ffmpeg` (required for cutting).
- Workflow: Full video downloaded first, then cut. Uses more bandwidth/temp space than section download.
- YouTube Changes/ToS: Keep `yt-dlp` updated. Respect Terms of Service.
- Rate Limiting/Blocking: Possible with heavy use.
- Errors: Check `.log` files & PHP error log. Common: paths, `exec` disabled, permissions, timeouts, invalid URLs, copyrights, ffmpeg cut errors.
- Cut Accuracy: Using `-c copy` is fast but cuts on keyframes; exact times might vary slightly.