Getting started

Make your first request

Search the video catalogue with one HTTPS request. You can start immediately without an API key.

Base URL
https://wearefairfashion.ch/api/v2/
GET/video/search/
curl &#ffcc66;https://wearefairfashion.ch/api/v2/video/search/?query=yoga&per_page=2&order=most-popular&thumbs=default&#ffcc66;
200 OKExample · videos[0] excerpt
{
"id": "AbCdEfGhIjK",
"title": "Sample title",
"length_min": "42:19"
}
Full JSON
{
"count": 2,
"start": 0,
"per_page": 2,
"page": 1,
"time_ms": 6,
"total_count": 11626,
"total_pages": 5813,
"videos": [
{
"id": "AbCdEfGhIjK",
"title": "Sample title",
"keywords": "outdoor, garden, sample",
"views": 260221,
"rate": "4.13",
"url": "https://wearefairfashion.ch/video-AbCdEfGhIjK/sample-title/",
"added": "2026-11-17 21:41:44",
"length_sec": 2539,
"length_min": "42:19",
"embed": "https://wearefairfashion.ch/embed/AbCdEfGhIjK/",
"default_thumb": {
"size": "medium",
"width": 427,
"height": 240,
"src": "https://static-ca-cdn.eporner.com/thumbs/static4/5/50/500/5000001/5_240.jpg"
}
},
{
"id": "LmNoPqRsTuV",
"title": "Another sample",
"keywords": "outdoor, garden, sample",
"views": 18400,
"rate": "3.92",
"url": "https://wearefairfashion.ch/video-LmNoPqRsTuV/another-sample/",
"added": "2026-11-17 21:41:44",
"length_sec": 2539,
"length_min": "42:19",
"embed": "https://wearefairfashion.ch/embed/LmNoPqRsTuV/",
"default_thumb": {
"size": "medium",
"width": 427,
"height": 240,
"src": "https://static-ca-cdn.eporner.com/thumbs/static4/5/50/500/5000001/5_240.jpg"
}
}
]
}

Endpoint directory

8 endpoints

Integration guides

Developer guides

Requests & pagination

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 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.
Resources

Limits & 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.

Resources

Error handling

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
StatusTypeWhat it means
400invalid-parameterinvalid-parameterInvalid parameter. A parameter is missing or malformed. parameter names it.
404not-foundnot-foundNot found. There is no such video or method.
405method-not-allowedmethod-not-allowedMethod 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-implementedformat-not-implementedFormat not implemented. A format other than JSON was asked for.
503unavailableunavailableTemporarily 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.

Developer guides

Sync removed videos

If you store videos on your side, three calls keep the copy right:

  1. 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.
  2. 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.
  3. 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.

Developer guides

Embed a video

Every video has an embed address. Put it in an iframe:

HTML
<iframe src="https://wearefairfashion.ch/embed/AbCdEfGhIjK/" width="640" height="360" frameborder="0" scrolling="no" allowfullscreen></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.

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/
ParameterTypeDescription
idstringstringThe video id: 11 letters and digits, case-sensitive. Required.
thumbsizestringstringThumbnail 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.
thumbsstringstringWhich 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.
fieldsstringstringExtra fields per video, separated by commas: categories, pornstars, quality. Each one costs a little time, so ask only for what you use.
langstringstringAdds translation: the title in this language, or null where there is none. Titles exist in pl, fr and es.
formatstringstringReply format. Default: json. One of: json, xml.

Response

The video, or an empty array when there is no such video.

See the Video object.

Status codes

  • 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/
ParameterTypeDescription
sincestringstringRemovals 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.
afterstringstringThe next value of the previous reply. Continues the listing right after its last entry; since is then not needed.
per_pageintegerintegerEntries per reply. Default: 1000. 1 to 1000.

Response

Removed videos, oldest removal first.

Fields of the reply of /video/removed/
FieldTypeDescription
sincestringstringThe moment this reply starts from.
countintegerintegerEntries in this reply.
has_morebooleanbooleanTrue when more entries follow.
nextstringstringPass as after to continue. Present when has_more is true. Optional.
removedlist of objectslist of objectsRemoved videos, oldest removal first.
removed[].idstringstringThe video id.
removed[].removed_atstringstringWhen it was removed, UTC.
View RemovedList object →

Status codes

  • 200 Removed videos, oldest removal first.
  • 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/
ParameterTypeDescription
idstringstringOne 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/
FieldTypeDescription
countintegerintegerEntries in this reply.
videoslist of objectslist of objectsOne entry per id asked, in the order asked.
videos[].idstringstringThe id as asked.
videos[].statusstringstringactive: 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_atstringstringWhen it was removed, UTC. Only for removed. Optional.
View StatusList object →

Status codes

  • 200 One entry per id asked, in the order asked.
  • 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.

API reference / Resources

List categories

Read the category directory and category IDs.

GET/api/v2/categories/

Parameters

This method takes no parameters.

Response

The category list.

Fields of the reply of /categories/
FieldTypeDescription
countintegerintegerNumber of categories.
categorieslist of Categorylist of CategoryAll categories.
View CategoryList object →

Status codes

  • 200 The category list.
  • 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.

GET/api/v2/pornstars/

Parameters

Parameters of /pornstars/
ParameterTypeDescription
pageintegerintegerPage number. Default: 1. 1 to 100000.
per_pageintegerintegerPerformers per page. Default: 100. 1 to 1000.

Response

One page of performers.

Fields of the reply of /pornstars/
FieldTypeDescription
countintegerintegerPerformers in this reply.
pageintegerintegerThis page&#ffcc66;s number.
per_pageintegerintegerPerformers per page.
total_countintegerintegerPerformers in the directory.
total_pagesintegerintegerPages there are with this per_page.
pornstarslist of Pornstarlist of PornstarThe performers of this page.
View PornstarList object →

Status codes

  • 200 One page of performers.
  • 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/
ParameterTypeDescription
urlstringstringThe address of a video page or of its player on eporner.com, on any of its language hosts. Required.
maxwidthintegerintegerThe widest player you can show, in pixels. Without it the player is at most 1280 wide. 1 or more.
maxheightintegerintegerThe tallest player you can show, in pixels. 1 or more.
formatstringstringOnly 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/
FieldTypeDescription
versionstringstringThe oEmbed version.
typestringstringAlways video.
provider_namestringstringEporner.
provider_urlstringstringThe site&#ffcc66;s address.
titlestringstringThe video&#ffcc66;s title.
htmlstringstringThe markup to place on your page: an iframe with the player.
widthintegerintegerPlayer width in pixels.
heightintegerintegerPlayer height in pixels.
thumbnail_urlstringstringA thumbnail for the video. Optional.
thumbnail_widthintegerintegerThumbnail width. Optional.
thumbnail_heightintegerintegerThumbnail height. Optional.
View Oembed object →

Status codes

  • 200 The oEmbed reply.
  • 400 A parameter is missing or malformed. parameter names it. About this error
  • 404 There is no such video or method. 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
  • 501 A format other than JSON was asked for. 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
FieldTypeDescription
sizestringstringThe size asked for. One of: small, medium, big.
widthintegerintegerWidth in pixels.
heightintegerintegerHeight in pixels.
srcstringstringThe image address.

Category

Fields of Category
FieldTypeDescription
idintegerintegerThe category&#ffcc66;s number.
namestringstringEnglish name.
slugstringstringThe name as it appears in addresses.
urlstringstringThe category page.

PornstarRef

Fields of PornstarRef
FieldTypeDescription
idintegerintegerThe performer&#ffcc66;s number.
namestringstringName.
urlstringstringThe performer&#ffcc66;s page.

Pornstar

Fields of Pornstar
FieldTypeDescription
idintegerintegerThe performer&#ffcc66;s number.
namestringstringName.
urlstringstringThe performer&#ffcc66;s page.
genderstringstringGender as listed in the directory. One of: female, male.
videosintegerintegerNumber of videos.
photosintegerintegerNumber of photos.

Quality

Fields of Quality
FieldTypeDescription
maxstring or nullstring or nullThe best quality the player offers, for example 1080p; null when unknown.
availablelist of stringlist of stringEvery quality the player offers, lowest first. A quality counts when the video has it in H.264 or in AV1.
hdbooleanbooleanTrue from 720p up.
fpsintegerintegerFrames per second; 0 when unknown.
vrbooleanbooleanTrue for a VR video.

Translation

Fields of Translation
FieldTypeDescription
langstringstringThe language asked for.
titlestringstringThe title in that language.

Video

Fields of Video
FieldTypeDescription
idstringstringThe video id: 11 letters and digits, case-sensitive.
titlestringstringTitle, UTF-8.
keywordsstringstringKeywords, separated by commas.
viewsintegerintegerEstimated number of views.
ratestringstringRating from 0.00 to 5.00, as a string with two decimals.
urlstringstringThe video page. Link to this address.
addedstringstringWhen the video was added: YYYY-MM-DD hh:mm:ss in Central European time, without an offset.
length_secintegerintegerLength in seconds.
length_minstringstringLength as m:ss. Minutes are not folded into hours: 2 h 5 min 30 s is 125:30.
embedstringstringThe player address, for the src of an iframe.
default_thumbThumbnailThumbnailThe thumbnail the site shows. Left out with thumbs=none. Optional.
thumbslist of Thumbnaillist of ThumbnailFifteen thumbnails from across the video. Only with thumbs=all. Optional.
categorieslist of Categorylist of CategoryOnly with fields=categories. Optional.
pornstarslist of PornstarReflist of PornstarRefOnly with fields=pornstars. Optional.
qualityQualityQualityOnly with fields=quality. Optional.
translationTranslationTranslationOnly with lang: the translated title, or null. Optional.

SearchResult

Fields of SearchResult
FieldTypeDescription
countintegerintegerVideos in this reply.
startintegerintegerPosition of the first video of this page: per_page * (page - 1).
per_pageintegerintegerVideos per page, as used.
pageintegerintegerThis page&#ffcc66;s number.
time_msintegerintegerTime the request took on the server, in milliseconds.
total_countintegerintegerVideos that match, up to 100,000 for a search or a listing narrowed by length or date.
total_pagesintegerintegerPages there are with this per_page. Stop here; do not stop because a page is shorter than per_page.
videoslist of Videolist of VideoThe videos of this page.

RemovedList

Fields of RemovedList
FieldTypeDescription
sincestringstringThe moment this reply starts from.
countintegerintegerEntries in this reply.
has_morebooleanbooleanTrue when more entries follow.
nextstringstringPass as after to continue. Present when has_more is true. Optional.
removedlist of objectslist of objectsRemoved videos, oldest removal first.
removed[].idstringstringThe video id.
removed[].removed_atstringstringWhen it was removed, UTC.

StatusList

Fields of StatusList
FieldTypeDescription
countintegerintegerEntries in this reply.
videoslist of objectslist of objectsOne entry per id asked, in the order asked.
videos[].idstringstringThe id as asked.
videos[].statusstringstringactive: 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_atstringstringWhen it was removed, UTC. Only for removed. Optional.

CategoryList

Fields of CategoryList
FieldTypeDescription
countintegerintegerNumber of categories.
categorieslist of Categorylist of CategoryAll categories.

PornstarList

Fields of PornstarList
FieldTypeDescription
countintegerintegerPerformers in this reply.
pageintegerintegerThis page&#ffcc66;s number.
per_pageintegerintegerPerformers per page.
total_countintegerintegerPerformers in the directory.
total_pagesintegerintegerPages there are with this per_page.
pornstarslist of Pornstarlist of PornstarThe performers of this page.

Oembed

Fields of Oembed
FieldTypeDescription
versionstringstringThe oEmbed version.
typestringstringAlways video.
provider_namestringstringEporner.
provider_urlstringstringThe site&#ffcc66;s address.
titlestringstringThe video&#ffcc66;s title.
htmlstringstringThe markup to place on your page: an iframe with the player.
widthintegerintegerPlayer width in pixels.
heightintegerintegerPlayer height in pixels.
thumbnail_urlstringstringA thumbnail for the video. Optional.
thumbnail_widthintegerintegerThumbnail width. Optional.
thumbnail_heightintegerintegerThumbnail height. Optional.

Problem

An error in the RFC 9457 format.

Fields of Problem
FieldTypeDescription
typestringstringIdentifies the kind of error; the address leads to its description.
titlestringstringThe kind of error in words.
statusintegerintegerThe HTTP status code.
detailstringstringWhat was wrong with this request.
parameterstringstringThe parameter at fault, for an invalid parameter. Optional.
Resources

Code examples

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-17&#ffcc66;
# while the reply says "has_more": true, continue with its "next" value:
curl &#ffcc66;https://wearefairfashion.ch/api/v2/video/removed/?after=NEXT&#ffcc66;
PHP
<?php
$query = [&#ffcc66;since&#ffcc66; => &#ffcc66;2026-11-17&#ffcc66;]; // the day of your last run
do {
$result = api_get(&#ffcc66;/video/removed/&#ffcc66;, $query);
foreach ($result[&#ffcc66;removed&#ffcc66;] as $entry) {
remove_from_my_site($entry[&#ffcc66;id&#ffcc66;]); // your own function
}
$query = [&#ffcc66;after&#ffcc66; => $result[&#ffcc66;next&#ffcc66;] ?? &#ffcc66;&#ffcc66;];
} while ($result[&#ffcc66;has_more&#ffcc66;]);
Python
query = {&#ffcc66;since&#ffcc66;: &#ffcc66;2026-11-17&#ffcc66;} # the day of your last run
while True:
result = api_get(&#ffcc66;/video/removed/&#ffcc66;, **query)
for entry in result[&#ffcc66;removed&#ffcc66;]:
remove_from_my_site(entry[&#ffcc66;id&#ffcc66;]) # your own function
if not result[&#ffcc66;has_more&#ffcc66;]:
break
query = {&#ffcc66;after&#ffcc66;: result[&#ffcc66;next&#ffcc66;]}
JavaScript
let query = {since: &#ffcc66;2026-11-17&#ffcc66;}; // 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.
  • Status of up to 100 videos in one call.
  • Categories, pornstars and oEmbed.
  • 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.
  • A machine-readable OpenAPI description.

Changed: check your code

  • Text is plain UTF-8. Titles and keywords with letters outside ASCII used to arrive encoded twice (“é” for “é”). If your code repaired that, remove the repair.
  • 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.

Resources

Terms of use

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:

  1. Link back. Every page that shows the player displays a prominent link back to eporner.com. The video’s url is the natural target.
  2. 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.
  3. Remove what is removed. Read the removed videos at least once a day and take those videos off your site.
  4. 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.
  5. No machine learning. The API and feeds are not for training or testing machine-learning or AI systems.
  6. 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 Terms of use differ, the Terms decide. Questions: contact us.

Cookies help us deliver our services. By using our services, you agree to our use of cookies. [ X ]