{
 "openapi": "3.0.3",
 "info": {
  "title": "Porn API",
  "version": "1.0.0",
  "description": "Porn / XXX / NSFW video API. Search 300,000+ free adult videos (straight, gay, trans) by keyword, tag, category, performer, studio and length, and get a ready-to-use embed player for every result. Built for tube sites, apps, Telegram/Discord bots and content widgets. Every result has a permanent embed URL and iframe code -- store it, it never expires. Only working videos are returned: each one is health-checked and dead files are replaced or removed. 18+ content only; you must comply with the laws where you show it."
 },
 "servers": [
  {
   "url": "https://pornalizer.app/api/v1"
  }
 ],
 "tags": [
  {
   "name": "Videos"
  },
  {
   "name": "Sync"
  },
  {
   "name": "Performers"
  },
  {
   "name": "Lists"
  }
 ],
 "paths": {
  "/search": {
   "get": {
    "tags": [
     "Videos"
    ],
    "operationId": "searchVideos",
    "summary": "Search videos",
    "description": "Filter, sort and page through the catalogue. All filters combine (AND).",
    "parameters": [
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Words to find in the title or description.",
      "schema": {
       "type": "string",
       "maxLength": 100
      }
     },
     {
      "name": "orientation",
      "in": "query",
      "required": false,
      "description": "Who the video is for.",
      "schema": {
       "type": "string",
       "enum": [
        "all",
        "straight",
        "gay",
        "trans",
        "bi"
       ],
       "default": "all"
      }
     },
     {
      "name": "content_type",
      "in": "query",
      "required": false,
      "description": "scene = studio productions, amateur = homemade.",
      "schema": {
       "type": "string",
       "enum": [
        "scene",
        "amateur"
       ]
      }
     },
     {
      "name": "tags",
      "in": "query",
      "required": false,
      "description": "Comma-separated tag slugs (any of them). Slugs come from GET /tags.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "categories",
      "in": "query",
      "required": false,
      "description": "Comma-separated category slugs (GET /categories).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "performers",
      "in": "query",
      "required": false,
      "description": "Comma-separated performer slugs (GET /performers).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "studios",
      "in": "query",
      "required": false,
      "description": "Comma-separated studio slugs (GET /studios).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "min_duration",
      "in": "query",
      "required": false,
      "description": "Shortest length in seconds.",
      "schema": {
       "type": "integer",
       "minimum": 0,
       "maximum": 36000
      }
     },
     {
      "name": "max_duration",
      "in": "query",
      "required": false,
      "description": "Longest length in seconds.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 36000
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "description": "Add a \"translation\" object (title + description) in this language to every video. Machine translations shared with our translated sites; null while one is not ready yet.",
      "schema": {
       "type": "string",
       "enum": [
        "es",
        "pt",
        "fr",
        "de",
        "it",
        "ru",
        "tr",
        "ar",
        "nl",
        "pl"
       ]
      }
     },
     {
      "name": "updated_since",
      "in": "query",
      "required": false,
      "description": "Only videos changed at or after this moment (ISO 8601). For incremental sync: store the time of your last run and pass it here with sort=updated.",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "published_since",
      "in": "query",
      "required": false,
      "description": "Only videos published at or after this moment (ISO 8601).",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "quality",
      "in": "query",
      "required": false,
      "description": "complete (default) = only videos ready to publish as-is: clean title, duration, description and tags. all = every playable video, some with missing metadata.",
      "schema": {
       "type": "string",
       "enum": [
        "complete",
        "all"
       ],
       "default": "complete"
      }
     },
     {
      "name": "sort",
      "in": "query",
      "required": false,
      "description": "Order of the results.",
      "schema": {
       "type": "string",
       "enum": [
        "newest",
        "oldest",
        "popular",
        "longest",
        "shortest",
        "updated"
       ],
       "default": "newest"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page number, from 1.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Results per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 100,
       "default": 20
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "page": {
           "type": "integer"
          },
          "per_page": {
           "type": "integer"
          },
          "total": {
           "type": "integer"
          },
          "pages": {
           "type": "integer"
          },
          "next_page": {
           "type": "integer",
           "nullable": true
          },
          "sort": {
           "type": "string"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "integer",
              "example": 7153684
             },
             "title": {
              "type": "string"
             },
             "description": {
              "type": "string",
              "description": "Up to 600 characters."
             },
             "duration_seconds": {
              "type": "integer",
              "nullable": true,
              "example": 2778
             },
             "duration": {
              "type": "string",
              "nullable": true,
              "example": "46:18"
             },
             "orientation": {
              "type": "string",
              "enum": [
               "straight",
               "gay",
               "trans",
               "bi"
              ]
             },
             "content_type": {
              "type": "string",
              "enum": [
               "scene",
               "amateur"
              ]
             },
             "resolution": {
              "type": "string",
              "nullable": true
             },
             "published_at": {
              "type": "string",
              "format": "date-time",
              "nullable": true
             },
             "thumbnail": {
              "type": "string",
              "format": "uri",
              "nullable": true
             },
             "tags": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "categories": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "performers": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "studio": {
              "allOf": [
               {
                "type": "object",
                "properties": {
                 "name": {
                  "type": "string"
                 },
                 "slug": {
                  "type": "string"
                 }
                }
               }
              ],
              "nullable": true
             },
             "stats": {
              "type": "object",
              "properties": {
               "views": {
                "type": "integer"
               },
               "likes": {
                "type": "integer"
               },
               "dislikes": {
                "type": "integer"
               }
              }
             },
             "translation": {
              "type": "object",
              "description": "Only with lang=.",
              "properties": {
               "lang": {
                "type": "string"
               },
               "title": {
                "type": "string",
                "nullable": true
               },
               "description": {
                "type": "string",
                "nullable": true
               }
              }
             },
             "poster": {
              "type": "string",
              "format": "uri",
              "nullable": true,
              "description": "Large scene image when known (16:9)."
             },
             "mirrors": {
              "type": "array",
              "description": "Backup copies of the same file on other hosts (EarnVids, Streamtape, Uqload, VOE, LuluStream, Vinovo), when we hold them, best player first. embed.url already switches to a mirror by itself if the main file ever dies; these are for your own fallback player.",
              "items": {
               "type": "object",
               "properties": {
                "host": {
                 "type": "string"
                },
                "embed_url": {
                 "type": "string",
                 "format": "uri"
                },
                "active": {
                 "type": "boolean",
                 "description": "true = currently the main file"
                }
               }
              }
             },
             "embed": {
              "type": "object",
              "description": "Permanent player: store it, it never expires. Player options, appended to url: ?autoplay=1 and/or muted=1.",
              "properties": {
               "url": {
                "type": "string",
                "format": "uri",
                "example": "https://pornalizer.app/player/embed/7153684/"
               },
               "iframe": {
                "type": "string"
               },
               "responsive_iframe": {
                "type": "string",
                "description": "16:9 iframe that fills its container (mobile-ready)."
               }
              }
             }
            }
           }
          }
         }
        },
        "example": {
         "page": 1,
         "per_page": 1,
         "total": 455,
         "pages": 455,
         "next_page": 2,
         "sort": "newest",
         "results": [
          {
           "id": 7153684,
           "title": "Angela White Invites Prince Over For A Long Overdue Anal Excavation",
           "description": "Angela White summons Prince to her downtown hotel so he can have his way with all of her holes! It\u2019s been way too long since the last time Angela was able to fe...",
           "duration_seconds": 2778,
           "duration": "46:18",
           "orientation": "straight",
           "content_type": "scene",
           "resolution": null,
           "published_at": "2026-10-23T15:22:08.517356+00:00",
           "thumbnail": "https://pornalizer.app/media/thumbnails/webp/pz-7153684.webp",
           "tags": [
            "Anal",
            "Ass To Mouth",
            "Big Ass",
            "Big Dick",
            "Black",
            "Blowjob"
           ],
           "categories": [
            {
             "name": "Anal",
             "slug": "anal"
            },
            {
             "name": "Big Ass",
             "slug": "big-ass"
            }
           ],
           "performers": [
            {
             "name": "Angela White",
             "slug": "angela-white"
            },
            {
             "name": "Prince Yahshua",
             "slug": "prince-yahshua"
            }
           ],
           "studio": {
            "name": "Jules Jordan",
            "slug": "jules-jordan"
           },
           "stats": {
            "views": 0,
            "likes": 0,
            "dislikes": 0
           },
           "embed": {
            "url": "https://pornalizer.app/player/embed/7153684/",
            "iframe": "<iframe src=\"https://pornalizer.app/player/embed/7153684/\" width=\"640\" height=\"360\" frameborder=\"0\" scrolling=\"no\" allowfullscreen allow=\"autoplay; encrypted-media\"></iframe>"
           }
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/videos/{video_id}": {
   "get": {
    "tags": [
     "Videos"
    ],
    "operationId": "getVideo",
    "summary": "Get one video",
    "parameters": [
     {
      "name": "video_id",
      "in": "path",
      "required": true,
      "description": "Video id from any result.",
      "schema": {
       "type": "integer"
      },
      "example": 7153684
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "description": "Add a \"translation\" object (title + description) in this language to every video. Machine translations shared with our translated sites; null while one is not ready yet.",
      "schema": {
       "type": "string",
       "enum": [
        "es",
        "pt",
        "fr",
        "de",
        "it",
        "ru",
        "tr",
        "ar",
        "nl",
        "pl"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "integer",
           "example": 7153684
          },
          "title": {
           "type": "string"
          },
          "description": {
           "type": "string",
           "description": "Up to 600 characters."
          },
          "duration_seconds": {
           "type": "integer",
           "nullable": true,
           "example": 2778
          },
          "duration": {
           "type": "string",
           "nullable": true,
           "example": "46:18"
          },
          "orientation": {
           "type": "string",
           "enum": [
            "straight",
            "gay",
            "trans",
            "bi"
           ]
          },
          "content_type": {
           "type": "string",
           "enum": [
            "scene",
            "amateur"
           ]
          },
          "resolution": {
           "type": "string",
           "nullable": true
          },
          "published_at": {
           "type": "string",
           "format": "date-time",
           "nullable": true
          },
          "thumbnail": {
           "type": "string",
           "format": "uri",
           "nullable": true
          },
          "tags": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "categories": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "slug": {
              "type": "string"
             }
            }
           }
          },
          "performers": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "slug": {
              "type": "string"
             }
            }
           }
          },
          "studio": {
           "allOf": [
            {
             "type": "object",
             "properties": {
              "name": {
               "type": "string"
              },
              "slug": {
               "type": "string"
              }
             }
            }
           ],
           "nullable": true
          },
          "stats": {
           "type": "object",
           "properties": {
            "views": {
             "type": "integer"
            },
            "likes": {
             "type": "integer"
            },
            "dislikes": {
             "type": "integer"
            }
           }
          },
          "translation": {
           "type": "object",
           "description": "Only with lang=.",
           "properties": {
            "lang": {
             "type": "string"
            },
            "title": {
             "type": "string",
             "nullable": true
            },
            "description": {
             "type": "string",
             "nullable": true
            }
           }
          },
          "poster": {
           "type": "string",
           "format": "uri",
           "nullable": true,
           "description": "Large scene image when known (16:9)."
          },
          "mirrors": {
           "type": "array",
           "description": "Backup copies of the same file on other hosts (EarnVids, Streamtape, Uqload, VOE, LuluStream, Vinovo), when we hold them, best player first. embed.url already switches to a mirror by itself if the main file ever dies; these are for your own fallback player.",
           "items": {
            "type": "object",
            "properties": {
             "host": {
              "type": "string"
             },
             "embed_url": {
              "type": "string",
              "format": "uri"
             },
             "active": {
              "type": "boolean",
              "description": "true = currently the main file"
             }
            }
           }
          },
          "embed": {
           "type": "object",
           "description": "Permanent player: store it, it never expires. Player options, appended to url: ?autoplay=1 and/or muted=1.",
           "properties": {
            "url": {
             "type": "string",
             "format": "uri",
             "example": "https://pornalizer.app/player/embed/7153684/"
            },
            "iframe": {
             "type": "string"
            },
            "responsive_iframe": {
             "type": "string",
             "description": "16:9 iframe that fills its container (mobile-ready)."
            }
           }
          }
         }
        },
        "example": {
         "id": 7153684,
         "title": "Angela White Invites Prince Over For A Long Overdue Anal Excavation",
         "description": "Angela White summons Prince to her downtown hotel so he can have his way with all of her holes! It\u2019s been way too long since the last time Angela was able to fe...",
         "duration_seconds": 2778,
         "duration": "46:18",
         "orientation": "straight",
         "content_type": "scene",
         "resolution": null,
         "published_at": "2026-10-23T15:22:08.517356+00:00",
         "thumbnail": "https://pornalizer.app/media/thumbnails/webp/pz-7153684.webp",
         "tags": [
          "Anal",
          "Ass To Mouth",
          "Big Ass",
          "Big Dick",
          "Black",
          "Blowjob"
         ],
         "categories": [
          {
           "name": "Anal",
           "slug": "anal"
          },
          {
           "name": "Big Ass",
           "slug": "big-ass"
          }
         ],
         "performers": [
          {
           "name": "Angela White",
           "slug": "angela-white"
          },
          {
           "name": "Prince Yahshua",
           "slug": "prince-yahshua"
          }
         ],
         "studio": {
          "name": "Jules Jordan",
          "slug": "jules-jordan"
         },
         "stats": {
          "views": 0,
          "likes": 0,
          "dislikes": 0
         },
         "embed": {
          "url": "https://pornalizer.app/player/embed/7153684/",
          "iframe": "<iframe src=\"https://pornalizer.app/player/embed/7153684/\" width=\"640\" height=\"360\" frameborder=\"0\" scrolling=\"no\" allowfullscreen allow=\"autoplay; encrypted-media\"></iframe>"
         }
        }
       }
      }
     },
     "404": {
      "description": "No available video with this id",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/videos/{video_id}/related": {
   "get": {
    "tags": [
     "Videos"
    ],
    "operationId": "relatedVideos",
    "summary": "Related videos",
    "description": "Same performers first, then the most specific shared tags.",
    "parameters": [
     {
      "name": "video_id",
      "in": "path",
      "required": true,
      "description": "Video id from any result.",
      "schema": {
       "type": "integer"
      },
      "example": 7153684
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "description": "Add a \"translation\" object (title + description) in this language to every video. Machine translations shared with our translated sites; null while one is not ready yet.",
      "schema": {
       "type": "string",
       "enum": [
        "es",
        "pt",
        "fr",
        "de",
        "it",
        "ru",
        "tr",
        "ar",
        "nl",
        "pl"
       ]
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "How many.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 50,
       "default": 12
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "video_id": {
           "type": "integer"
          },
          "count": {
           "type": "integer"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "integer",
              "example": 7153684
             },
             "title": {
              "type": "string"
             },
             "description": {
              "type": "string",
              "description": "Up to 600 characters."
             },
             "duration_seconds": {
              "type": "integer",
              "nullable": true,
              "example": 2778
             },
             "duration": {
              "type": "string",
              "nullable": true,
              "example": "46:18"
             },
             "orientation": {
              "type": "string",
              "enum": [
               "straight",
               "gay",
               "trans",
               "bi"
              ]
             },
             "content_type": {
              "type": "string",
              "enum": [
               "scene",
               "amateur"
              ]
             },
             "resolution": {
              "type": "string",
              "nullable": true
             },
             "published_at": {
              "type": "string",
              "format": "date-time",
              "nullable": true
             },
             "thumbnail": {
              "type": "string",
              "format": "uri",
              "nullable": true
             },
             "tags": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "categories": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "performers": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "studio": {
              "allOf": [
               {
                "type": "object",
                "properties": {
                 "name": {
                  "type": "string"
                 },
                 "slug": {
                  "type": "string"
                 }
                }
               }
              ],
              "nullable": true
             },
             "stats": {
              "type": "object",
              "properties": {
               "views": {
                "type": "integer"
               },
               "likes": {
                "type": "integer"
               },
               "dislikes": {
                "type": "integer"
               }
              }
             },
             "translation": {
              "type": "object",
              "description": "Only with lang=.",
              "properties": {
               "lang": {
                "type": "string"
               },
               "title": {
                "type": "string",
                "nullable": true
               },
               "description": {
                "type": "string",
                "nullable": true
               }
              }
             },
             "poster": {
              "type": "string",
              "format": "uri",
              "nullable": true,
              "description": "Large scene image when known (16:9)."
             },
             "mirrors": {
              "type": "array",
              "description": "Backup copies of the same file on other hosts (EarnVids, Streamtape, Uqload, VOE, LuluStream, Vinovo), when we hold them, best player first. embed.url already switches to a mirror by itself if the main file ever dies; these are for your own fallback player.",
              "items": {
               "type": "object",
               "properties": {
                "host": {
                 "type": "string"
                },
                "embed_url": {
                 "type": "string",
                 "format": "uri"
                },
                "active": {
                 "type": "boolean",
                 "description": "true = currently the main file"
                }
               }
              }
             },
             "embed": {
              "type": "object",
              "description": "Permanent player: store it, it never expires. Player options, appended to url: ?autoplay=1 and/or muted=1.",
              "properties": {
               "url": {
                "type": "string",
                "format": "uri",
                "example": "https://pornalizer.app/player/embed/7153684/"
               },
               "iframe": {
                "type": "string"
               },
               "responsive_iframe": {
                "type": "string",
                "description": "16:9 iframe that fills its container (mobile-ready)."
               }
              }
             }
            }
           }
          }
         }
        },
        "example": {
         "video_id": 7153684,
         "count": 1,
         "results": [
          {
           "id": 7153684,
           "title": "Angela White Invites Prince Over For A Long Overdue Anal Excavation",
           "description": "Angela White summons Prince to her downtown hotel so he can have his way with all of her holes! It\u2019s been way too long since the last time Angela was able to fe...",
           "duration_seconds": 2778,
           "duration": "46:18",
           "orientation": "straight",
           "content_type": "scene",
           "resolution": null,
           "published_at": "2026-10-23T15:22:08.517356+00:00",
           "thumbnail": "https://pornalizer.app/media/thumbnails/webp/pz-7153684.webp",
           "tags": [
            "Anal",
            "Ass To Mouth",
            "Big Ass",
            "Big Dick",
            "Black",
            "Blowjob"
           ],
           "categories": [
            {
             "name": "Anal",
             "slug": "anal"
            },
            {
             "name": "Big Ass",
             "slug": "big-ass"
            }
           ],
           "performers": [
            {
             "name": "Angela White",
             "slug": "angela-white"
            },
            {
             "name": "Prince Yahshua",
             "slug": "prince-yahshua"
            }
           ],
           "studio": {
            "name": "Jules Jordan",
            "slug": "jules-jordan"
           },
           "stats": {
            "views": 0,
            "likes": 0,
            "dislikes": 0
           },
           "embed": {
            "url": "https://pornalizer.app/player/embed/7153684/",
            "iframe": "<iframe src=\"https://pornalizer.app/player/embed/7153684/\" width=\"640\" height=\"360\" frameborder=\"0\" scrolling=\"no\" allowfullscreen allow=\"autoplay; encrypted-media\"></iframe>"
           }
          }
         ]
        }
       }
      }
     },
     "404": {
      "description": "No available video with this id",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/videos/random": {
   "get": {
    "tags": [
     "Videos"
    ],
    "operationId": "randomVideos",
    "summary": "Random videos",
    "description": "1-10 random videos; takes the same filters as /search. Never cached.",
    "parameters": [
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Words to find in the title or description.",
      "schema": {
       "type": "string",
       "maxLength": 100
      }
     },
     {
      "name": "orientation",
      "in": "query",
      "required": false,
      "description": "Who the video is for.",
      "schema": {
       "type": "string",
       "enum": [
        "all",
        "straight",
        "gay",
        "trans",
        "bi"
       ],
       "default": "all"
      }
     },
     {
      "name": "content_type",
      "in": "query",
      "required": false,
      "description": "scene = studio productions, amateur = homemade.",
      "schema": {
       "type": "string",
       "enum": [
        "scene",
        "amateur"
       ]
      }
     },
     {
      "name": "tags",
      "in": "query",
      "required": false,
      "description": "Comma-separated tag slugs (any of them). Slugs come from GET /tags.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "categories",
      "in": "query",
      "required": false,
      "description": "Comma-separated category slugs (GET /categories).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "performers",
      "in": "query",
      "required": false,
      "description": "Comma-separated performer slugs (GET /performers).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "studios",
      "in": "query",
      "required": false,
      "description": "Comma-separated studio slugs (GET /studios).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "min_duration",
      "in": "query",
      "required": false,
      "description": "Shortest length in seconds.",
      "schema": {
       "type": "integer",
       "minimum": 0,
       "maximum": 36000
      }
     },
     {
      "name": "max_duration",
      "in": "query",
      "required": false,
      "description": "Longest length in seconds.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 36000
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "description": "Add a \"translation\" object (title + description) in this language to every video. Machine translations shared with our translated sites; null while one is not ready yet.",
      "schema": {
       "type": "string",
       "enum": [
        "es",
        "pt",
        "fr",
        "de",
        "it",
        "ru",
        "tr",
        "ar",
        "nl",
        "pl"
       ]
      }
     },
     {
      "name": "updated_since",
      "in": "query",
      "required": false,
      "description": "Only videos changed at or after this moment (ISO 8601). For incremental sync: store the time of your last run and pass it here with sort=updated.",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "published_since",
      "in": "query",
      "required": false,
      "description": "Only videos published at or after this moment (ISO 8601).",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "quality",
      "in": "query",
      "required": false,
      "description": "complete (default) = only videos ready to publish as-is: clean title, duration, description and tags. all = every playable video, some with missing metadata.",
      "schema": {
       "type": "string",
       "enum": [
        "complete",
        "all"
       ],
       "default": "complete"
      }
     },
     {
      "name": "count",
      "in": "query",
      "required": false,
      "description": "How many.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 10,
       "default": 1
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "count": {
           "type": "integer"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "integer",
              "example": 7153684
             },
             "title": {
              "type": "string"
             },
             "description": {
              "type": "string",
              "description": "Up to 600 characters."
             },
             "duration_seconds": {
              "type": "integer",
              "nullable": true,
              "example": 2778
             },
             "duration": {
              "type": "string",
              "nullable": true,
              "example": "46:18"
             },
             "orientation": {
              "type": "string",
              "enum": [
               "straight",
               "gay",
               "trans",
               "bi"
              ]
             },
             "content_type": {
              "type": "string",
              "enum": [
               "scene",
               "amateur"
              ]
             },
             "resolution": {
              "type": "string",
              "nullable": true
             },
             "published_at": {
              "type": "string",
              "format": "date-time",
              "nullable": true
             },
             "thumbnail": {
              "type": "string",
              "format": "uri",
              "nullable": true
             },
             "tags": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "categories": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "performers": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "studio": {
              "allOf": [
               {
                "type": "object",
                "properties": {
                 "name": {
                  "type": "string"
                 },
                 "slug": {
                  "type": "string"
                 }
                }
               }
              ],
              "nullable": true
             },
             "stats": {
              "type": "object",
              "properties": {
               "views": {
                "type": "integer"
               },
               "likes": {
                "type": "integer"
               },
               "dislikes": {
                "type": "integer"
               }
              }
             },
             "translation": {
              "type": "object",
              "description": "Only with lang=.",
              "properties": {
               "lang": {
                "type": "string"
               },
               "title": {
                "type": "string",
                "nullable": true
               },
               "description": {
                "type": "string",
                "nullable": true
               }
              }
             },
             "poster": {
              "type": "string",
              "format": "uri",
              "nullable": true,
              "description": "Large scene image when known (16:9)."
             },
             "mirrors": {
              "type": "array",
              "description": "Backup copies of the same file on other hosts (EarnVids, Streamtape, Uqload, VOE, LuluStream, Vinovo), when we hold them, best player first. embed.url already switches to a mirror by itself if the main file ever dies; these are for your own fallback player.",
              "items": {
               "type": "object",
               "properties": {
                "host": {
                 "type": "string"
                },
                "embed_url": {
                 "type": "string",
                 "format": "uri"
                },
                "active": {
                 "type": "boolean",
                 "description": "true = currently the main file"
                }
               }
              }
             },
             "embed": {
              "type": "object",
              "description": "Permanent player: store it, it never expires. Player options, appended to url: ?autoplay=1 and/or muted=1.",
              "properties": {
               "url": {
                "type": "string",
                "format": "uri",
                "example": "https://pornalizer.app/player/embed/7153684/"
               },
               "iframe": {
                "type": "string"
               },
               "responsive_iframe": {
                "type": "string",
                "description": "16:9 iframe that fills its container (mobile-ready)."
               }
              }
             }
            }
           }
          }
         }
        },
        "example": {
         "count": 1,
         "results": [
          {
           "id": 7153684,
           "title": "Angela White Invites Prince Over For A Long Overdue Anal Excavation",
           "description": "Angela White summons Prince to her downtown hotel so he can have his way with all of her holes! It\u2019s been way too long since the last time Angela was able to fe...",
           "duration_seconds": 2778,
           "duration": "46:18",
           "orientation": "straight",
           "content_type": "scene",
           "resolution": null,
           "published_at": "2026-10-23T15:22:08.517356+00:00",
           "thumbnail": "https://pornalizer.app/media/thumbnails/webp/pz-7153684.webp",
           "tags": [
            "Anal",
            "Ass To Mouth",
            "Big Ass",
            "Big Dick",
            "Black",
            "Blowjob"
           ],
           "categories": [
            {
             "name": "Anal",
             "slug": "anal"
            },
            {
             "name": "Big Ass",
             "slug": "big-ass"
            }
           ],
           "performers": [
            {
             "name": "Angela White",
             "slug": "angela-white"
            },
            {
             "name": "Prince Yahshua",
             "slug": "prince-yahshua"
            }
           ],
           "studio": {
            "name": "Jules Jordan",
            "slug": "jules-jordan"
           },
           "stats": {
            "views": 0,
            "likes": 0,
            "dislikes": 0
           },
           "embed": {
            "url": "https://pornalizer.app/player/embed/7153684/",
            "iframe": "<iframe src=\"https://pornalizer.app/player/embed/7153684/\" width=\"640\" height=\"360\" frameborder=\"0\" scrolling=\"no\" allowfullscreen allow=\"autoplay; encrypted-media\"></iframe>"
           }
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/videos": {
   "get": {
    "tags": [
     "Sync"
    ],
    "operationId": "getVideosBatch",
    "summary": "Get many videos by id",
    "description": "Up to 100 videos in one call -- re-sync the videos you already published. Ids that are no longer available come back in \"missing\" (unpublish those).",
    "parameters": [
     {
      "name": "ids",
      "in": "query",
      "required": true,
      "description": "Comma-separated video ids, up to 100.",
      "schema": {
       "type": "string"
      },
      "example": "7153684,7153685"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "description": "Add a \"translation\" object (title + description) in this language to every video. Machine translations shared with our translated sites; null while one is not ready yet.",
      "schema": {
       "type": "string",
       "enum": [
        "es",
        "pt",
        "fr",
        "de",
        "it",
        "ru",
        "tr",
        "ar",
        "nl",
        "pl"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "count": {
           "type": "integer"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "integer",
              "example": 7153684
             },
             "title": {
              "type": "string"
             },
             "description": {
              "type": "string",
              "description": "Up to 600 characters."
             },
             "duration_seconds": {
              "type": "integer",
              "nullable": true,
              "example": 2778
             },
             "duration": {
              "type": "string",
              "nullable": true,
              "example": "46:18"
             },
             "orientation": {
              "type": "string",
              "enum": [
               "straight",
               "gay",
               "trans",
               "bi"
              ]
             },
             "content_type": {
              "type": "string",
              "enum": [
               "scene",
               "amateur"
              ]
             },
             "resolution": {
              "type": "string",
              "nullable": true
             },
             "published_at": {
              "type": "string",
              "format": "date-time",
              "nullable": true
             },
             "thumbnail": {
              "type": "string",
              "format": "uri",
              "nullable": true
             },
             "tags": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "categories": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "performers": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "studio": {
              "allOf": [
               {
                "type": "object",
                "properties": {
                 "name": {
                  "type": "string"
                 },
                 "slug": {
                  "type": "string"
                 }
                }
               }
              ],
              "nullable": true
             },
             "stats": {
              "type": "object",
              "properties": {
               "views": {
                "type": "integer"
               },
               "likes": {
                "type": "integer"
               },
               "dislikes": {
                "type": "integer"
               }
              }
             },
             "translation": {
              "type": "object",
              "description": "Only with lang=.",
              "properties": {
               "lang": {
                "type": "string"
               },
               "title": {
                "type": "string",
                "nullable": true
               },
               "description": {
                "type": "string",
                "nullable": true
               }
              }
             },
             "poster": {
              "type": "string",
              "format": "uri",
              "nullable": true,
              "description": "Large scene image when known (16:9)."
             },
             "mirrors": {
              "type": "array",
              "description": "Backup copies of the same file on other hosts (EarnVids, Streamtape, Uqload, VOE, LuluStream, Vinovo), when we hold them, best player first. embed.url already switches to a mirror by itself if the main file ever dies; these are for your own fallback player.",
              "items": {
               "type": "object",
               "properties": {
                "host": {
                 "type": "string"
                },
                "embed_url": {
                 "type": "string",
                 "format": "uri"
                },
                "active": {
                 "type": "boolean",
                 "description": "true = currently the main file"
                }
               }
              }
             },
             "embed": {
              "type": "object",
              "description": "Permanent player: store it, it never expires. Player options, appended to url: ?autoplay=1 and/or muted=1.",
              "properties": {
               "url": {
                "type": "string",
                "format": "uri",
                "example": "https://pornalizer.app/player/embed/7153684/"
               },
               "iframe": {
                "type": "string"
               },
               "responsive_iframe": {
                "type": "string",
                "description": "16:9 iframe that fills its container (mobile-ready)."
               }
              }
             }
            }
           }
          },
          "missing": {
           "type": "array",
           "items": {
            "type": "integer"
           }
          }
         }
        },
        "example": {
         "count": 1,
         "results": [
          {
           "id": 7153684,
           "title": "Angela White Invites Prince Over For A Long Overdue Anal Excavation",
           "description": "Angela White summons Prince to her downtown hotel so he can have his way with all of her holes! It\u2019s been way too long since the last time Angela was able to fe...",
           "duration_seconds": 2778,
           "duration": "46:18",
           "orientation": "straight",
           "content_type": "scene",
           "resolution": null,
           "published_at": "2026-10-23T15:22:08.517356+00:00",
           "thumbnail": "https://pornalizer.app/media/thumbnails/webp/pz-7153684.webp",
           "tags": [
            "Anal",
            "Ass To Mouth",
            "Big Ass",
            "Big Dick",
            "Black",
            "Blowjob"
           ],
           "categories": [
            {
             "name": "Anal",
             "slug": "anal"
            },
            {
             "name": "Big Ass",
             "slug": "big-ass"
            }
           ],
           "performers": [
            {
             "name": "Angela White",
             "slug": "angela-white"
            },
            {
             "name": "Prince Yahshua",
             "slug": "prince-yahshua"
            }
           ],
           "studio": {
            "name": "Jules Jordan",
            "slug": "jules-jordan"
           },
           "stats": {
            "views": 0,
            "likes": 0,
            "dislikes": 0
           },
           "embed": {
            "url": "https://pornalizer.app/player/embed/7153684/",
            "iframe": "<iframe src=\"https://pornalizer.app/player/embed/7153684/\" width=\"640\" height=\"360\" frameborder=\"0\" scrolling=\"no\" allowfullscreen allow=\"autoplay; encrypted-media\"></iframe>"
           }
          }
         ],
         "missing": [
          7153685
         ]
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/videos/removed": {
   "get": {
    "tags": [
     "Sync"
    ],
    "operationId": "removedVideos",
    "summary": "Removed videos",
    "description": "Videos that stopped being available since a moment (default: last 7 days), newest first. Poll it daily and unpublish these ids -- your site never shows a dead player. Updated hourly.",
    "parameters": [
     {
      "name": "since",
      "in": "query",
      "required": false,
      "description": "ISO 8601 date or datetime.",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page number.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 1000,
       "default": 100
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "page": {
           "type": "integer"
          },
          "per_page": {
           "type": "integer"
          },
          "total": {
           "type": "integer"
          },
          "pages": {
           "type": "integer"
          },
          "next_page": {
           "type": "integer",
           "nullable": true
          },
          "since": {
           "type": "string"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "integer"
             },
             "removed_at": {
              "type": "string",
              "format": "date-time"
             }
            }
           }
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/videos/{video_id}/status": {
   "get": {
    "tags": [
     "Sync"
    ],
    "operationId": "videoStatus",
    "summary": "Is a video active?",
    "description": "Cheap check before showing a stored embed: active = playable now.",
    "parameters": [
     {
      "name": "video_id",
      "in": "path",
      "required": true,
      "description": "Video id from any result.",
      "schema": {
       "type": "integer"
      },
      "example": 7153684
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "integer"
          },
          "active": {
           "type": "boolean"
          },
          "complete": {
           "type": "boolean"
          },
          "removed_at": {
           "type": "string",
           "format": "date-time",
           "nullable": true
          }
         }
        },
        "example": {
         "id": 7153684,
         "active": true,
         "complete": true,
         "removed_at": null
        }
       }
      }
     }
    }
   }
  },
  "/videos/trending": {
   "get": {
    "tags": [
     "Videos"
    ],
    "operationId": "trendingVideos",
    "summary": "Trending videos",
    "description": "Most watched complete videos published in the last day, week or month. Takes the /search filters.",
    "parameters": [
     {
      "name": "period",
      "in": "query",
      "required": false,
      "description": "Window.",
      "schema": {
       "type": "string",
       "enum": [
        "day",
        "week",
        "month"
       ],
       "default": "week"
      }
     },
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Words to find in the title or description.",
      "schema": {
       "type": "string",
       "maxLength": 100
      }
     },
     {
      "name": "orientation",
      "in": "query",
      "required": false,
      "description": "Who the video is for.",
      "schema": {
       "type": "string",
       "enum": [
        "all",
        "straight",
        "gay",
        "trans",
        "bi"
       ],
       "default": "all"
      }
     },
     {
      "name": "content_type",
      "in": "query",
      "required": false,
      "description": "scene = studio productions, amateur = homemade.",
      "schema": {
       "type": "string",
       "enum": [
        "scene",
        "amateur"
       ]
      }
     },
     {
      "name": "tags",
      "in": "query",
      "required": false,
      "description": "Comma-separated tag slugs (any of them). Slugs come from GET /tags.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "categories",
      "in": "query",
      "required": false,
      "description": "Comma-separated category slugs (GET /categories).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "performers",
      "in": "query",
      "required": false,
      "description": "Comma-separated performer slugs (GET /performers).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "studios",
      "in": "query",
      "required": false,
      "description": "Comma-separated studio slugs (GET /studios).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "min_duration",
      "in": "query",
      "required": false,
      "description": "Shortest length in seconds.",
      "schema": {
       "type": "integer",
       "minimum": 0,
       "maximum": 36000
      }
     },
     {
      "name": "max_duration",
      "in": "query",
      "required": false,
      "description": "Longest length in seconds.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 36000
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "description": "Add a \"translation\" object (title + description) in this language to every video. Machine translations shared with our translated sites; null while one is not ready yet.",
      "schema": {
       "type": "string",
       "enum": [
        "es",
        "pt",
        "fr",
        "de",
        "it",
        "ru",
        "tr",
        "ar",
        "nl",
        "pl"
       ]
      }
     },
     {
      "name": "updated_since",
      "in": "query",
      "required": false,
      "description": "Only videos changed at or after this moment (ISO 8601). For incremental sync: store the time of your last run and pass it here with sort=updated.",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "published_since",
      "in": "query",
      "required": false,
      "description": "Only videos published at or after this moment (ISO 8601).",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "quality",
      "in": "query",
      "required": false,
      "description": "complete (default) = only videos ready to publish as-is: clean title, duration, description and tags. all = every playable video, some with missing metadata.",
      "schema": {
       "type": "string",
       "enum": [
        "complete",
        "all"
       ],
       "default": "complete"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page (1-50).",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 50,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 100,
       "default": 20
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "period": {
           "type": "string"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "integer",
              "example": 7153684
             },
             "title": {
              "type": "string"
             },
             "description": {
              "type": "string",
              "description": "Up to 600 characters."
             },
             "duration_seconds": {
              "type": "integer",
              "nullable": true,
              "example": 2778
             },
             "duration": {
              "type": "string",
              "nullable": true,
              "example": "46:18"
             },
             "orientation": {
              "type": "string",
              "enum": [
               "straight",
               "gay",
               "trans",
               "bi"
              ]
             },
             "content_type": {
              "type": "string",
              "enum": [
               "scene",
               "amateur"
              ]
             },
             "resolution": {
              "type": "string",
              "nullable": true
             },
             "published_at": {
              "type": "string",
              "format": "date-time",
              "nullable": true
             },
             "thumbnail": {
              "type": "string",
              "format": "uri",
              "nullable": true
             },
             "tags": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "categories": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "performers": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "slug": {
                 "type": "string"
                }
               }
              }
             },
             "studio": {
              "allOf": [
               {
                "type": "object",
                "properties": {
                 "name": {
                  "type": "string"
                 },
                 "slug": {
                  "type": "string"
                 }
                }
               }
              ],
              "nullable": true
             },
             "stats": {
              "type": "object",
              "properties": {
               "views": {
                "type": "integer"
               },
               "likes": {
                "type": "integer"
               },
               "dislikes": {
                "type": "integer"
               }
              }
             },
             "translation": {
              "type": "object",
              "description": "Only with lang=.",
              "properties": {
               "lang": {
                "type": "string"
               },
               "title": {
                "type": "string",
                "nullable": true
               },
               "description": {
                "type": "string",
                "nullable": true
               }
              }
             },
             "poster": {
              "type": "string",
              "format": "uri",
              "nullable": true,
              "description": "Large scene image when known (16:9)."
             },
             "mirrors": {
              "type": "array",
              "description": "Backup copies of the same file on other hosts (EarnVids, Streamtape, Uqload, VOE, LuluStream, Vinovo), when we hold them, best player first. embed.url already switches to a mirror by itself if the main file ever dies; these are for your own fallback player.",
              "items": {
               "type": "object",
               "properties": {
                "host": {
                 "type": "string"
                },
                "embed_url": {
                 "type": "string",
                 "format": "uri"
                },
                "active": {
                 "type": "boolean",
                 "description": "true = currently the main file"
                }
               }
              }
             },
             "embed": {
              "type": "object",
              "description": "Permanent player: store it, it never expires. Player options, appended to url: ?autoplay=1 and/or muted=1.",
              "properties": {
               "url": {
                "type": "string",
                "format": "uri",
                "example": "https://pornalizer.app/player/embed/7153684/"
               },
               "iframe": {
                "type": "string"
               },
               "responsive_iframe": {
                "type": "string",
                "description": "16:9 iframe that fills its container (mobile-ready)."
               }
              }
             }
            }
           }
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/suggest": {
   "get": {
    "tags": [
     "Lists"
    ],
    "operationId": "suggest",
    "summary": "Autocomplete",
    "description": "For a search box: performers, categories and tags whose name starts with q, most videos first.",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "description": "At least 2 characters.",
      "schema": {
       "type": "string",
       "minLength": 2
      },
      "example": "ang"
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Per group.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 20,
       "default": 5
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/performers/{slug}": {
   "get": {
    "tags": [
     "Performers"
    ],
    "operationId": "getPerformer",
    "summary": "Performer profile",
    "description": "Bio, image, aliases, age, birthplace, ethnicity, hair, eyes, height (cm), weight (kg), measurements, natural/enhanced, tattoos, piercings, career years and social/database links (OnlyFans, Twitter, Instagram, IAFD...) when known.",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "description": "Performer slug (from /performers, /suggest or a video).",
      "schema": {
       "type": "string"
      },
      "example": "angela-white"
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "No available video with this id",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/performers/find": {
   "get": {
    "tags": [
     "Performers"
    ],
    "operationId": "findPerformers",
    "summary": "Find performers by looks",
    "description": "Filter performers by hair, ethnicity, nationality, eyes, height range and natural/enhanced breasts. Valid values: GET /performers/attributes.",
    "parameters": [
     {
      "name": "hair",
      "in": "query",
      "required": false,
      "description": "e.g. Blonde.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "ethnicity",
      "in": "query",
      "required": false,
      "description": "e.g. Latin.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "nationality",
      "in": "query",
      "required": false,
      "description": "e.g. Czech.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "eyes",
      "in": "query",
      "required": false,
      "description": "e.g. Blue.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "min_height",
      "in": "query",
      "required": false,
      "description": "cm",
      "schema": {
       "type": "integer",
       "minimum": 100,
       "maximum": 230
      }
     },
     {
      "name": "max_height",
      "in": "query",
      "required": false,
      "description": "cm",
      "schema": {
       "type": "integer",
       "minimum": 100,
       "maximum": 230
      }
     },
     {
      "name": "fake_boobs",
      "in": "query",
      "required": false,
      "description": "true = enhanced, false = natural.",
      "schema": {
       "type": "string",
       "enum": [
        "true",
        "false"
       ]
      }
     },
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Part of the name.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "min_videos",
      "in": "query",
      "required": false,
      "description": "Only performers with at least this many videos.",
      "schema": {
       "type": "integer",
       "default": 1
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 200,
       "default": 50
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/performers/attributes": {
   "get": {
    "tags": [
     "Performers"
    ],
    "operationId": "performerAttributes",
    "summary": "Performer attribute values",
    "description": "Every hair, ethnicity, nationality and eye value with its performer count -- the values /performers/find accepts.",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/categories/{slug}": {
   "get": {
    "tags": [
     "Lists"
    ],
    "operationId": "getCategory",
    "summary": "One category",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "description": "Category slug.",
      "schema": {
       "type": "string"
      },
      "example": "anal"
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "No available video with this id",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/tags": {
   "get": {
    "tags": [
     "Lists"
    ],
    "operationId": "listTags",
    "summary": "List tags",
    "description": "All tags with their video counts; use the slug in the /search \"tags\" filter.",
    "parameters": [
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Part of the name.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "sort",
      "in": "query",
      "required": false,
      "description": "Order.",
      "schema": {
       "type": "string",
       "enum": [
        "popular",
        "name",
        "newest"
       ],
       "default": "popular"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page number.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 500,
       "default": 50
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "page": {
           "type": "integer"
          },
          "per_page": {
           "type": "integer"
          },
          "total": {
           "type": "integer"
          },
          "pages": {
           "type": "integer"
          },
          "next_page": {
           "type": "integer",
           "nullable": true
          },
          "list": {
           "type": "string"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "slug": {
              "type": "string"
             },
             "video_count": {
              "type": "integer"
             },
             "search_filter": {
              "type": "object",
              "description": "Pass these to /search."
             }
            }
           }
          }
         }
        },
        "example": {
         "list": "tags",
         "page": 1,
         "per_page": 2,
         "total": 9652,
         "pages": 4826,
         "next_page": 2,
         "results": [
          {
           "name": "Blowjob",
           "slug": "blowjob",
           "video_count": 77014,
           "search_filter": {
            "tags": "blowjob"
           }
          },
          {
           "name": "Brown Hair",
           "slug": "brown-hair",
           "video_count": 45438,
           "search_filter": {
            "tags": "brown-hair"
           }
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/categories": {
   "get": {
    "tags": [
     "Lists"
    ],
    "operationId": "listCategories",
    "summary": "List categories",
    "description": "All categories with their video counts; use the slug in the /search \"categories\" filter.",
    "parameters": [
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Part of the name.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "sort",
      "in": "query",
      "required": false,
      "description": "Order.",
      "schema": {
       "type": "string",
       "enum": [
        "popular",
        "name",
        "newest"
       ],
       "default": "popular"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page number.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 500,
       "default": 50
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "page": {
           "type": "integer"
          },
          "per_page": {
           "type": "integer"
          },
          "total": {
           "type": "integer"
          },
          "pages": {
           "type": "integer"
          },
          "next_page": {
           "type": "integer",
           "nullable": true
          },
          "list": {
           "type": "string"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "slug": {
              "type": "string"
             },
             "video_count": {
              "type": "integer"
             },
             "search_filter": {
              "type": "object",
              "description": "Pass these to /search."
             }
            }
           }
          }
         }
        },
        "example": {
         "list": "categories",
         "page": 1,
         "per_page": 2,
         "total": 9652,
         "pages": 4826,
         "next_page": 2,
         "results": [
          {
           "name": "Blowjob",
           "slug": "blowjob",
           "video_count": 77014,
           "search_filter": {
            "tags": "blowjob"
           }
          },
          {
           "name": "Brown Hair",
           "slug": "brown-hair",
           "video_count": 45438,
           "search_filter": {
            "tags": "brown-hair"
           }
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/performers": {
   "get": {
    "tags": [
     "Lists"
    ],
    "operationId": "listPerformers",
    "summary": "List performers",
    "description": "All performers with their video counts; use the slug in the /search \"performers\" filter.",
    "parameters": [
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Part of the name.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "sort",
      "in": "query",
      "required": false,
      "description": "Order.",
      "schema": {
       "type": "string",
       "enum": [
        "popular",
        "name",
        "newest"
       ],
       "default": "popular"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page number.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 500,
       "default": 50
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "page": {
           "type": "integer"
          },
          "per_page": {
           "type": "integer"
          },
          "total": {
           "type": "integer"
          },
          "pages": {
           "type": "integer"
          },
          "next_page": {
           "type": "integer",
           "nullable": true
          },
          "list": {
           "type": "string"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "slug": {
              "type": "string"
             },
             "video_count": {
              "type": "integer"
             },
             "search_filter": {
              "type": "object",
              "description": "Pass these to /search."
             }
            }
           }
          }
         }
        },
        "example": {
         "list": "performers",
         "page": 1,
         "per_page": 2,
         "total": 9652,
         "pages": 4826,
         "next_page": 2,
         "results": [
          {
           "name": "Blowjob",
           "slug": "blowjob",
           "video_count": 77014,
           "search_filter": {
            "tags": "blowjob"
           }
          },
          {
           "name": "Brown Hair",
           "slug": "brown-hair",
           "video_count": 45438,
           "search_filter": {
            "tags": "brown-hair"
           }
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/studios": {
   "get": {
    "tags": [
     "Lists"
    ],
    "operationId": "listStudios",
    "summary": "List studios",
    "description": "All studios with their video counts; use the slug in the /search \"studios\" filter.",
    "parameters": [
     {
      "name": "query",
      "in": "query",
      "required": false,
      "description": "Part of the name.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "sort",
      "in": "query",
      "required": false,
      "description": "Order.",
      "schema": {
       "type": "string",
       "enum": [
        "popular",
        "name",
        "newest"
       ],
       "default": "popular"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page number.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      }
     },
     {
      "name": "per_page",
      "in": "query",
      "required": false,
      "description": "Per page.",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 500,
       "default": 50
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "page": {
           "type": "integer"
          },
          "per_page": {
           "type": "integer"
          },
          "total": {
           "type": "integer"
          },
          "pages": {
           "type": "integer"
          },
          "next_page": {
           "type": "integer",
           "nullable": true
          },
          "list": {
           "type": "string"
          },
          "results": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "slug": {
              "type": "string"
             },
             "video_count": {
              "type": "integer"
             },
             "search_filter": {
              "type": "object",
              "description": "Pass these to /search."
             }
            }
           }
          }
         }
        },
        "example": {
         "list": "studios",
         "page": 1,
         "per_page": 2,
         "total": 9652,
         "pages": 4826,
         "next_page": 2,
         "results": [
          {
           "name": "Blowjob",
           "slug": "blowjob",
           "video_count": 77014,
           "search_filter": {
            "tags": "blowjob"
           }
          },
          {
           "name": "Brown Hair",
           "slug": "brown-hair",
           "video_count": 45438,
           "search_filter": {
            "tags": "brown-hair"
           }
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "object",
           "properties": {
            "code": {
             "type": "string",
             "example": "invalid_parameter"
            },
            "message": {
             "type": "string"
            },
            "param": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  }
 }
}