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 User-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.
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.
An error is an HTTP status of 400 or above with a JSON body of the type application/problem+json (Xenoblade Chronicles 2 – v2.1.0 + 7 DLCs + Yuzu/ ...). 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://wearefairfashion.ch/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.
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 pass 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 terms of use.
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.
Search the catalogue by keyword, duration or publication date.
GET/api/v2/video/search/
Parameters
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.
formatstring
string
Reply format. Default: json. One of: json, xml.
Response
One page of videos. Malformed parameters are replaced by their defaults, so this method does not answer 400.
Fields of the reply of /video/search/
Field
Type
Description
countinteger
integer
Videos in this reply.
startinteger
integer
Position of the first video of this page: per_page * (page - 1).
per_pageinteger
integer
Videos per page, as used.
pageinteger
integer
This pageffcc66;s number.
time_msinteger
integer
Time the request took on the server, in milliseconds.
total_countinteger
integer
Videos that match, up to 100,000 for a search or a listing narrowed by length or date.
total_pagesinteger
integer
Pages there are with this per_page. Stop here; do not stop because a page is shorter than per_page.
200 One page of videos. Malformed parameters are replaced by their defaults, so this method does not answer 400.
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
Endpoint behavior
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.
API reference / Videos
Get a video
Look up one playable video by its case-sensitive ID.
GET/api/v2/video/id/
Parameters
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.
formatstring
string
Reply format. Default: json. One of: json, xml.
Response
The video, or an empty array when there is no such video.
200 The video, or an empty array when there is no such video.
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
Endpoint behavior
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.
API reference / Videos
List removals
Read removals in cursor order and update your catalogue.
GET/api/v2/video/removed/
Parameters
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.
per_pageinteger
integer
Entries per reply. Default: 1000. 1 to 1000.
Response
Removed videos, oldest removal first.
Fields of the reply of /video/removed/
Field
Type
Description
sincestring
string
The moment this reply starts from.
countinteger
integer
Entries in this reply.
has_moreboolean
boolean
True when more entries follow.
nextstring
string
Pass as after to continue. Present when has_more is true. Optional.
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
Endpoint behavior
With since, returns the videos removed from that moment on, oldest removal first, up to 1000 per reply. Read the reply, store next, and pass 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.
API reference / Videos
Check video status
Check the availability of up to 100 videos in one call.
GET/api/v2/video/status/
Parameters
Parameters of /video/status/
Parameter
Type
Description
idstring
string
One to 100 video ids, separated by commas. Required.
Response
One entry per id asked, in the order asked.
Fields of the reply of /video/status/
Field
Type
Description
countinteger
integer
Entries in this reply.
videoslist of objects
list of objects
One entry per id asked, in the order asked.
videos[].idstring
string
The id as asked.
videos[].statusstring
string
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
Endpoint behavior
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.
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
Endpoint behavior
All categories. The categories field of a video uses the same entries.
API reference / Resources
List performers
Browse the performer directory, ordered by popularity.
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
Endpoint behavior
The performer directory, most popular first. The pornstars field of a video uses the same ids.
API reference / Resources
Get embed markup
Get player markup for a video URL at a specific size.
GET/api/v2/oembed/
Parameters
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.
Response
The oEmbed reply.
Fields of the reply of /oembed/
Field
Type
Description
versionstring
string
The oEmbed version.
typestring
string
Always video.
provider_namestring
string
Eporner.
provider_urlstring
string
The siteffcc66;s address.
titlestring
string
The videoffcc66;s title.
htmlstring
string
The markup to place on your page: an iframe with the player.
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
Endpoint behavior
Returns the player for a video address in the oEmbed 1.0 format (type video), sized to fit maxwidth and maxheight.
API reference / Resources
OpenAPI description
Read the machine-readable API description.
GET/api/v2/openapi/
Parameters
This method takes no parameters.
Response
An OpenAPI 3.1 document.
Status codes
200 An OpenAPI 3.1 document.
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
Endpoint behavior
This document: the machine-readable description of the API, for code generators and API clients.
Resources
Response objects
The objects the replies are made of. A field marked optional is left out when it does not apply.
Thumbnail
Fields of Thumbnail
Field
Type
Description
sizestring
string
The size asked for. One of: small, medium, big.
widthinteger
integer
Width in pixels.
heightinteger
integer
Height in pixels.
srcstring
string
The image address.
Category
Fields of Category
Field
Type
Description
idinteger
integer
The categoryffcc66;s number.
namestring
string
English name.
slugstring
string
The name as it appears in addresses.
urlstring
string
The category page.
PornstarRef
Fields of PornstarRef
Field
Type
Description
idinteger
integer
The performerffcc66;s number.
namestring
string
Name.
urlstring
string
The performerffcc66;s page.
Pornstar
Fields of Pornstar
Field
Type
Description
idinteger
integer
The performerffcc66;s number.
namestring
string
Name.
urlstring
string
The performerffcc66;s page.
genderstring
string
Gender as listed in the directory. One of: female, male.
videosinteger
integer
Number of videos.
photosinteger
integer
Number of photos.
Quality
Fields of Quality
Field
Type
Description
maxstring or null
string or null
The best quality the player offers, for example 1080p; null when unknown.
availablelist of string
list of string
Every quality the player offers, lowest first. A quality counts when the video has it in H.264 or in AV1.
hdboolean
boolean
True from 720p up.
fpsinteger
integer
Frames per second; 0 when unknown.
vrboolean
boolean
True for a VR video.
Translation
Fields of Translation
Field
Type
Description
langstring
string
The language asked for.
titlestring
string
The title in that language.
Video
Fields of Video
Field
Type
Description
idstring
string
The video id: 11 letters and digits, case-sensitive.
titlestring
string
Title, UTF-8.
keywordsstring
string
Keywords, separated by commas.
viewsinteger
integer
Estimated number of views.
ratestring
string
Rating from 0.00 to 5.00, as a string with two decimals.
urlstring
string
The video page. Link to this address.
addedstring
string
When the video was added: YYYY-MM-DD hh:mm:ss in Central European time, without an offset.
length_secinteger
integer
Length in seconds.
length_minstring
string
Length as m:ss. Minutes are not folded into hours: 2 h 5 min 30 s is 125:30.
Pass 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.
StatusList
Fields of StatusList
Field
Type
Description
countinteger
integer
Entries in this reply.
videoslist of objects
list of objects
One entry per id asked, in the order asked.
videos[].idstring
string
The id as asked.
videos[].statusstring
string
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.
<?php
function api_get(string $path, array $query): array {
$url = ffcc66;https://wearefairfashion.ch/api/v2ffcc66; . $path . ffcc66;?ffcc66; . 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(ffcc66;No reply from ffcc66; . $url);
}
$page = 1;
do {
$result = api_get(ffcc66;/video/search/ffcc66;, [ffcc66;queryffcc66; => ffcc66;yogaffcc66;, ffcc66;per_pageffcc66; => 100, ffcc66;pageffcc66; => $page, ffcc66;thumbsffcc66; => ffcc66;defaultffcc66;]);
foreach ($result[ffcc66;videosffcc66;] as $video) {
echo $video[ffcc66;idffcc66;], ffcc66; ffcc66;, $video[ffcc66;titleffcc66;], PHP_EOL;
}
} while ($page++ < $result[ffcc66;total_pagesffcc66;]);
Python
import json, time, urllib.error, urllib.parse, urllib.request
def api_get(path, **query):
url = ffcc66;https://wearefairfashion.ch/api/v2ffcc66; + path + ffcc66;?ffcc66; + urllib.parse.urlencode(query)
request = urllib.request.Request(url, headers={ffcc66;User-Agentffcc66;: ffcc66;my-site/1.0ffcc66;})
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(ffcc66;Retry-Afterffcc66;, 30)))
raise RuntimeError(ffcc66;No reply from ffcc66; + url)
page = 1
while True:
result = api_get(ffcc66;/video/search/ffcc66;, query=ffcc66;yogaffcc66;, per_page=100, page=page, thumbs=ffcc66;defaultffcc66;)
for video in result[ffcc66;videosffcc66;]:
print(video[ffcc66;idffcc66;], video[ffcc66;titleffcc66;])
if page >= result[ffcc66;total_pagesffcc66;]:
break
page += 1
JavaScript
async function apiGet(path, query) {
const url = ffcc66;https://wearefairfashion.ch/api/v2ffcc66; + path + ffcc66;?ffcc66; + 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(ffcc66;HTTP ffcc66; + reply.status + ffcc66; for ffcc66; + url);
const wait = Number(reply.headers.get(ffcc66;Retry-Afterffcc66;)) || 30;
await new Promise((resolve) => setTimeout(resolve, wait * 1000));
}
throw new Error(ffcc66;No reply from ffcc66; + url);
}
for (let page = 1, pages = 1; page <= pages; page++) {
const result = await apiGet(ffcc66;/video/search/ffcc66;, {query: ffcc66;yogaffcc66;, per_page: 100, page, thumbs: ffcc66;defaultffcc66;});
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 ffcc66;https://wearefairfashion.ch/api/v2/video/removed/?since=2026-11-17ffcc66;
# while the reply says "has_more": true, continue with its "next" value:
curl ffcc66;https://wearefairfashion.ch/api/v2/video/removed/?after=NEXTffcc66;
PHP
<?php
$query = [ffcc66;sinceffcc66; => ffcc66;2026-11-17ffcc66;]; // the day of your last run
do {
$result = api_get(ffcc66;/video/removed/ffcc66;, $query);
foreach ($result[ffcc66;removedffcc66;] as $entry) {
remove_from_my_site($entry[ffcc66;idffcc66;]); // your own function
}
$query = [ffcc66;afterffcc66; => $result[ffcc66;nextffcc66;] ?? ffcc66;ffcc66;];
} while ($result[ffcc66;has_moreffcc66;]);
Python
query = {ffcc66;sinceffcc66;: ffcc66;2026-11-17ffcc66;} # the day of your last run
while True:
result = api_get(ffcc66;/video/removed/ffcc66;, **query)
for entry in result[ffcc66;removedffcc66;]:
remove_from_my_site(entry[ffcc66;idffcc66;]) # your own function
if not result[ffcc66;has_moreffcc66;]:
break
query = {ffcc66;afterffcc66;: result[ffcc66;nextffcc66;]}
JavaScript
let query = {since: ffcc66;2026-11-17ffcc66;}; // the day of your last run
for (;;) {
const result = await apiGet(ffcc66;/video/removed/ffcc66;, query);
for (const entry of result.removed) removeFromMySite(entry.id); // your own function
if (!result.has_more) break;
query = {after: result.next};
}
Resources
Changelog
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.
You are welcome to use this API, the feeds and the player on your website or app. The site’s Terms 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 download, 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.