Skip to content
2034networkPublic

About

Porn API: free XXX / NSFW video search & embed on RapidAPI. Python & JavaScript clients, Postman collection.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Porn API — free XXX video search & embed

➡️ 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.

Why this API

  • 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.url and embed.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.

Quick start

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'

Python

pip install git+https://github.com/2034network/porn-api.git
from 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 pages

Errors raise PornAPIError with .status and .param (the parameter at fault).

JavaScript (Node 18+ / browsers)

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;

Postman

Import postman/porn-api.postman_collection.json and set rapidapi_key.

Endpoints

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

18+ only

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.

License

MIT — see LICENSE.

About

Porn API: free XXX / NSFW video search & embed on RapidAPI. Python & JavaScript clients, Postman collection.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages