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.

Base address
https://www.megaxxx.info/api/v2/
Access
Open, no key
Format
JSON, UTF-8 (XML on search and id)
Version
2.1.0 · what changed

Quick start

  1. Ask for videos. This returns the two newest videos that match “yoga”:

    Request
    curl 'https://www.megaxxx.info/api/v2/video/search/?query=yoga&per_page=2&thumbs=default'
  2. Show them. Each video in the reply has a url to link to, a thumbnail, and an embed address for the player:

    HTML
    <iframe src="https://www.eporner.com/embed/AbCdEfGhIjK/" width="640" height="360" frameborder="0" scrolling="no" allowfullscreen></iframe>
  3. Keep your copy clean. Once a day, ask which videos were removed since your last run and take them off your site:

    Request
    curl 'https://www.megaxxx.info/api/v2/video/removed/?since=2026-11-17'

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

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
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://www.megaxxx.info/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:

  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.

Embedding

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

HTML
<iframe src="https://www.eporner.com/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 www.megaxxx.info. Your site is responsible for the age and child-protection rules that apply to it.

Methods

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/
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.
Example request
curl 'https://www.megaxxx.info/api/v2/video/id/?id=AbCdEfGhIjK&thumbs=default'
Example reply
{
"id": "AbCdEfGhIjK",
"title": "Sample title",
"keywords": "outdoor, garden, sample",
"views": 260221,
"rate": "4.13",
"url": "https://www.megaxxx.info/video-AbCdEfGhIjK/sample-title/",
"added": "2026-11-17 21:41:44",
"length_sec": 2539,
"length_min": "42:19",
"embed": "https://www.eporner.com/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"
}
}

The reply is a 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

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

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.
Example request
curl 'https://www.megaxxx.info/api/v2/video/removed/?since=2026-11-17T00:00:00Z&per_page=2'
Example reply
{
"since": "2026-11-17T00:00:00Z",
"count": 2,
"has_more": true,
"next": "1794873600.18200456",
"removed": [
{
"id": "AbCdEfGhIjK",
"removed_at": "2026-11-17T00:00:00Z"
},
{
"id": "LmNoPqRsTuV",
"removed_at": "2026-11-17T00:04:12Z"
}
]
}
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.
  • 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/
ParameterTypeDescription
idstringstringOne to 100 video ids, separated by commas. Required.
Example request
curl 'https://www.megaxxx.info/api/v2/video/status/?id=AbCdEfGhIjK,LmNoPqRsTuV'
Example reply
{
"count": 2,
"videos": [
{
"id": "AbCdEfGhIjK",
"status": "active"
},
{
"id": "LmNoPqRsTuV",
"status": "removed",
"removed_at": "2026-11-17T00:04:12Z"
}
]
}
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.
  • 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.

This method takes no parameters.

Example request
curl 'https://www.megaxxx.info/api/v2/categories/'
Example reply
{
"count": 2,
"categories": [
{
"id": 49,
"name": "Outdoor",
"slug": "outdoor",
"url": "https://www.megaxxx.info/cat/outdoor/"
},
{
"id": 18,
"name": "Massage",
"slug": "massage",
"url": "https://www.megaxxx.info/cat/massage/"
}
]
}
Fields of the reply of /categories/
FieldTypeDescription
countintegerintegerNumber of categories.
categorieslist of Categorylist of CategoryAll categories.
  • 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.

Parameters of /pornstars/
ParameterTypeDescription
pageintegerintegerPage number. Default: 1. 1 to 100000.
per_pageintegerintegerPerformers per page. Default: 100. 1 to 1000.
Example request
curl 'https://www.megaxxx.info/api/v2/pornstars/?per_page=2'
Example reply
{
"count": 2,
"page": 1,
"per_page": 2,
"total_count": 45440,
"total_pages": 22720,
"pornstars": [
{
"id": 4211,
"name": "Sample Name",
"url": "https://www.megaxxx.info/pornstar/sample-name/",
"gender": "female",
"videos": 312,
"photos": 48
},
{
"id": 977,
"name": "Another Name",
"url": "https://www.megaxxx.info/pornstar/another-name/",
"gender": "male",
"videos": 120,
"photos": 0
}
]
}
Fields of the reply of /pornstars/
FieldTypeDescription
countintegerintegerPerformers in this reply.
pageintegerintegerThis page'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.
  • 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/
ParameterTypeDescription
urlstringstringThe address of a video page or of its player on www.megaxxx.info, 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.
Example request
curl 'https://www.megaxxx.info/api/v2/oembed/?url=https%3A%2F%2Fwww.eporner.com%2Fvideo-AbCdEfGhIjK%2Fsample-title%2F&maxwidth=640'
Example reply
{
"version": "1.0",
"type": "video",
"provider_name": "Eporner",
"provider_url": "https://www.megaxxx.info/",
"title": "Sample title",
"html": "<iframe src=\"https://www.eporner.com/embed/AbCdEfGhIjK/\" width=\"640\" height=\"360\" frameborder=\"0\" scrolling=\"no\" allowfullscreen></iframe>",
"width": 640,
"height": 360,
"thumbnail_url": "https://static-ca-cdn.eporner.com/thumbs/static4/5/50/500/5000001/5_360.jpg",
"thumbnail_width": 640,
"thumbnail_height": 360
}
Fields of the reply of /oembed/
FieldTypeDescription
versionstringstringThe oEmbed version.
typestringstringAlways video.
provider_namestringstringEporner.
provider_urlstringstringThe site's address.
titlestringstringThe video'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.
  • 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

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's number.
namestringstringEnglish name.
slugstringstringThe name as it appears in addresses.
urlstringstringThe category page.

PornstarRef

Fields of PornstarRef
FieldTypeDescription
idintegerintegerThe performer's number.
namestringstringName.
urlstringstringThe performer's page.

Pornstar

Fields of Pornstar
FieldTypeDescription
idintegerintegerThe performer's number.
namestringstringName.
urlstringstringThe performer'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.

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.

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 'https://www.megaxxx.info/api/v2/video/removed/?since=2026-11-17'
# while the reply says "has_more": true, continue with its "next" value:
curl 'https://www.megaxxx.info/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.
  • 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.

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 www.megaxxx.info. 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 ]