{ "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), when we hold them. 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": "" } } ] } } } }, "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), when we hold them. 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": "" } } } } }, "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), when we hold them. 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": "" } } ] } } } }, "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), when we hold them. 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": "" } } ] } } } }, "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), when we hold them. 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": "" } } ], "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), when we hold them. 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" } } } } } } } } } } } } }