// FREE · NO AUTH · OPEN

Trashcore REST API

A free, open REST API providing scrapers and downloaders for social media, music, search and more. Built for bots and developers.

Browse Endpoints Setup Guide
13
ENDPOINTS
5
CATEGORIES
FREE
NO API KEY
JSON
RESPONSE
Base URL
url
loading...

ENDPOINTS

GET /downloader/yta?q={song_name} YouTube Audio
Parameters
NameTypeDescription
qrequiredstringSong name or artist + title
qualityoptionalstring128k (default), 192k, 320k
Response
"title": "Alan Walker - Faded", "thumb": "https://i.ytimg.com/vi/...", "duration": "00:03:33", "size": "3.28 MB", "sizeB": 3439329, "dl_url": "https://dl.iamworker.com/..."
Try it
song name
GET /downloader/ytv?url={youtube_url} YouTube Video
Parameters
NameTypeDescription
urlrequiredstringYouTube video URL
qualityoptionalstring360p (default), 720p, 1080p
Response
"title": "Alan Walker - Faded", "thumb": "https://i.ytimg.com/vi/...", "duration": "00:03:33", "quality": "360p", "size": "12.4 MB", "dl_url": "https://dl.iamworker.com/..."
Try it
GET /downloader/tiktok?url={tiktok_url} TikTok DL
Parameters
NameTypeDescription
urlrequiredstringTikTok video URL
Response
"result": { "id": "7234567890123", "title": "video caption...", "play": "https://...", "music": "https://...", "author": { "nickname": "username" }, "digg_count": 12400, "duration": 15 }
Try it
GET /downloader/twitter?url={tweet_url} Twitter / X DL
Parameters
NameTypeDescription
urlrequiredstringTwitter / X post URL
Response
"desc": "tweet text...", "thumb": "https://pbs.twimg.com/...", "HD": "https://video.twimg.com/...", "SD": "https://video.twimg.com/...", "audio": "https://twdown.net/..."
Try it
GET /downloader/facebook?url={fb_url} Facebook DL
Parameters
NameTypeDescription
urlrequiredstringFacebook video URL
Response
"title": "Facebook Video", "hd": "https://video.xx.fbcdn.net/hd...", "sd": "https://video.xx.fbcdn.net/sd...", "url": "https://video.xx.fbcdn.net/..."
Try it
GET /downloader/gdrive?url={drive_url} Google Drive DL
Parameters
NameTypeDescription
urlrequiredstringGoogle Drive file share URL
Response
"fileName": "document.pdf", "fileSize": "2.4 MB", "fileSizeB": 2516582, "mimetype": "application/pdf", "downloadUrl": "https://drive.google.com/..."
Try it
GET /downloader/npm?q={package_name} npm Package
Parameters
NameTypeDescription
qrequiredstringnpm package name e.g. axios
Response
"name": "axios", "version": "1.6.0", "description": "Promise based HTTP client", "license": "MIT", "owner": "jasonsaayman", "downloadLink": "https://registry.npmjs.org/...", "homepage": "https://axios-http.com"
Try it
GET /search/lyrics?q={song_name} Song Lyrics
Parameters
NameTypeDescription
qrequiredstringSong name or artist + title
Response
"title": "Faded", "artist": "Alan Walker", "lyrics": "You were the shadow to my light...", "link": "https://genius.com/...", "image": "https://images.genius.com/..."
Try it
GET /search/gimage?q={query} Google Images
Parameters
NameTypeDescription
qrequiredstringImage search query
Response
// Array of image URLs [ "https://example.com/image1.jpg", "https://example.com/image2.png", ... ]
Try it
GET /search/wallpaper?q={query} HD Wallpapers
Parameters
NameTypeDescription
qrequiredstringWallpaper search query
pageoptionalnumberPage number (default: 1)
Response
[ { "title": "Anime Landscape 4K", "image": "https://www.besthdwallpaper.com/..." }, ... ]
Try it
GET /social/ttstalk?username={username} TikTok Profile
Parameters
NameTypeDescription
usernamerequiredstringTikTok username (without @)
Response
"id": "6829680307", "username": "charlidamelio", "name": "charli d'amelio", "avatar": "https://...", "bio": "bio text", "verified": true, "followers": "152M", "likes": "11.2B"
Try it
GET /social/igstalk?username={username} Instagram Profile
Parameters
NameTypeDescription
usernamerequiredstringInstagram username
limitoptionalnumberPosts to return (default: 12)
Response
"profile": { "name": "Cristiano Ronaldo", "followers": 619000000, "verified": true }, "posts": [ ... ]
Try it
GET /tools/ttp?text={text} Text to Image
Parameters
NameTypeDescription
textrequiredstringText to render as image
coloroptionalstringHex color without # (default: 30F4EF)
Response
"status": 200, "result": "https://www.picturetopeople.org/p2p/..."
Try it

SETUP GUIDE

📦 1. Clone / create folder

bash
mkdir trashcore-api && cd trashcore-api

⚙️ 2. Install dependencies

bash
npm install express cors api-dylux

▶ 3. Start server

bash
node server.js
# Running on port 3000

🌐 4. Test a route

bash
curl "http://localhost:3000/downloader/npm?q=axios"

🚀 Deploy to Railway

bash
# Push to GitHub, then connect on Railway
# Set start command: node server.js
# PORT is set automatically

🐍 Usage from Python

python
import requests
r = requests.get(
  "http://localhost:3000/downloader/yta",
  params={"q": "Alan Walker Faded"}
)
print(r.json())