➡️ Get a free API key on RapidAPI: rapidapi.com/Pornalizer/api/porn-api8
Search 300,000+ free porn videos (straight, gay, trans) by keyword, tag, category, performer, studio and length, and get a permanent embed player for every result. A NSFW / adult video API for tube sites, apps, Telegram and Discord bots, and widgets — no hosting, no bandwidth, no broken players.
This repository holds small, dependency-free clients (Python, JavaScript), examples and a Postman collection.
- Not a scraper. It serves its own catalogue, so it doesn't break when Pornhub, XNXX or XVideos change their pages.
- Permanent embeds. Each video carries
embed.urlandembed.iframe— store them, they never expire. - Only working videos. Every video is health-checked continuously; dead files are replaced or removed.
- Free plan: 500,000 requests a month.
curl 'https://porn-api8.p.rapidapi.com/search?query=blonde&per_page=5' \
-H 'X-RapidAPI-Key: YOUR_KEY' -H 'X-RapidAPI-Host: porn-api8.p.rapidapi.com'pip install git+https://github.com/2034network/porn-api.gitfrom porn_api import PornAPI
api = PornAPI("YOUR_RAPIDAPI_KEY")
for v in api.search(query="blonde", sort="popular", per_page=5)["results"]:
print(v["title"], v["duration"], v["embed"]["url"])
api.random(count=3, orientation="trans") # bots, "surprise me"
api.related(7153684, limit=12) # "more like this"
api.list("performers", query="angela") # menus, A-Z pagesErrors raise PornAPIError with .status and .param (the parameter at fault).
import { PornAPI } from './js/porn-api.js';
const api = new PornAPI(process.env.RAPIDAPI_KEY);
const { results } = await api.search({ tags: ['anal'], min_duration: 600, sort: 'popular' });
document.querySelector('#player').innerHTML = results[0].embed.iframe;Import postman/porn-api.postman_collection.json and set rapidapi_key.
| Endpoint | What it does |
|---|---|
GET /search |
query, tags, categories, performers, studios, orientation (all, straight, gay, trans, bi), content_type (scene, amateur), min_duration, max_duration, sort (newest, oldest, popular, longest, shortest), page, per_page (≤100) |
GET /videos/{id} |
One video with full metadata and embed |
GET /videos/{id}/related |
Same performers first, then the most specific shared tags |
GET /videos/random |
1-10 random videos with the same filters |
GET /tags /categories /performers /studios |
Lists with video counts; pass search_filter to /search |
Full docs and a live playground: rapidapi.com/Pornalizer/api/porn-api8. No-key WordPress plugin and embed dumps for webmasters: adultembed.com.
examples/telegram_random_post.py— post a random video to a Telegram channel on a cron.examples/embed_page.html— search box + embed grid.
All content is adult. Show it only where it is legal and only to adults. Use the embeds as provided; don't rip or re-host the files.
MIT — see LICENSE.