{ "openapi": "3.0.3", "info": { "title": "Screenshotty - Website Screenshot API", "description": "A powerful screenshot API that captures high-quality screenshots of websites or raw HTML content. Supports various output formats, custom viewports, JavaScript/CSS injection, element selection, geo-targeting, and more.\n\n## Quick Start\n\nSubscribe to the API on RapidAPI and use your RapidAPI key:\n```bash\ncurl -X GET \"https://screenshotty1.p.rapidapi.com/v1/screenshot?url=https://example.com\" \\\n -H \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: screenshotty1.p.rapidapi.com\"\n```\n\n## Features\n- 📸 Capture full-page or viewport screenshots\n- 🎨 Multiple output formats (PNG, JPEG, WebP, PDF, etc.)\n- 🖥️ Custom viewport dimensions (up to 4K resolution)\n- ✂️ Crop specific regions or capture specific CSS selectors\n- 🔧 JavaScript and CSS injection for page manipulation\n- 🍪 Cookie and HTTP header support for authenticated pages\n- 🌍 Geo-targeting with proxy support from multiple countries\n- 🚫 Built-in ad blocker\n- ⚡ Fast processing with real browser rendering\n\n## Rate Limits\nRate limits depend on your subscription plan. Check your RapidAPI dashboard for details.", "version": "1.1.0" }, "servers": [ { "url": "https://screenshotty1.p.rapidapi.com", "description": "RapidAPI Production Server", "x-rapidapi-host": "screenshotty1.p.rapidapi.com" } ], "security": [ { "RapidAPIKey": [], "RapidAPIHost": [] } ], "x-rapidapi": { "api-id": "screenshotty1", "host": "screenshotty1.p.rapidapi.com", "category": "Tools", "tags": ["screenshot", "web capture", "pdf", "website", "image", "render", "browser"] }, "paths": { "/v1/screenshot": { "get": { "summary": "Take a screenshot (GET)", "description": "Capture a screenshot of a URL or HTML content using query parameters. This endpoint is useful for simple requests or when you need to embed the screenshot URL directly in HTML (e.g., `

`).", "operationId": "getScreenshot", "tags": ["Screenshot"], "x-code-samples": [ { "lang": "cURL", "label": "cURL (RapidAPI)", "source": "curl -X GET \"https://screenshotty1.p.rapidapi.com/v1/screenshot?url=https%3A%2F%2Fexample.com&format=image%2Fpng\" \\\n -H \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: screenshotty1.p.rapidapi.com\" \\\n --output screenshot.png" }, { "lang": "JavaScript", "label": "Node.js (axios)", "source": "const axios = require('axios');\nconst fs = require('fs');\n\nconst options = {\n method: 'GET',\n url: 'https://screenshotty1.p.rapidapi.com/v1/screenshot',\n params: {\n url: 'https://example.com',\n format: 'image/png'\n },\n headers: {\n 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY',\n 'X-RapidAPI-Host': 'screenshotty1.p.rapidapi.com'\n },\n responseType: 'arraybuffer'\n};\n\naxios.request(options)\n .then(response => fs.writeFileSync('screenshot.png', response.data))\n .catch(error => console.error(error));" }, { "lang": "Python", "label": "Python (requests)", "source": "import requests\n\nurl = \"https://screenshotty1.p.rapidapi.com/v1/screenshot\"\n\nparams = {\n \"url\": \"https://example.com\",\n \"format\": \"image/png\"\n}\n\nheaders = {\n \"X-RapidAPI-Key\": \"YOUR_RAPIDAPI_KEY\",\n \"X-RapidAPI-Host\": \"screenshotty1.p.rapidapi.com\"\n}\n\nresponse = requests.get(url, headers=headers, params=params)\n\nwith open(\"screenshot.png\", \"wb\") as f:\n f.write(response.content)" }, { "lang": "PHP", "label": "PHP (cURL)", "source": " \"https://screenshotty1.p.rapidapi.com/v1/screenshot?url=https%3A%2F%2Fexample.com&format=image%2Fpng\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_HTTPHEADER => [\n \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\",\n \"X-RapidAPI-Host: screenshotty1.p.rapidapi.com\"\n ],\n]);\n\n$response = curl_exec($curl);\ncurl_close($curl);\n\nfile_put_contents('screenshot.png', $response);" } ], "parameters": [ { "$ref": "#/components/parameters/url" }, { "$ref": "#/components/parameters/html" }, { "$ref": "#/components/parameters/format" }, { "$ref": "#/components/parameters/response_type" }, { "$ref": "#/components/parameters/responseType" }, { "$ref": "#/components/parameters/viewport_width" }, { "$ref": "#/components/parameters/viewportWidth" }, { "$ref": "#/components/parameters/viewport_height" }, { "$ref": "#/components/parameters/viewportHeight" }, { "$ref": "#/components/parameters/crop_x" }, { "$ref": "#/components/parameters/screenshotX" }, { "$ref": "#/components/parameters/crop_y" }, { "$ref": "#/components/parameters/screenshotY" }, { "$ref": "#/components/parameters/crop_width" }, { "$ref": "#/components/parameters/screenshotWidth" }, { "$ref": "#/components/parameters/crop_height" }, { "$ref": "#/components/parameters/screenshotHeight" }, { "$ref": "#/components/parameters/selector" }, { "$ref": "#/components/parameters/selectorToScreenshot" }, { "$ref": "#/components/parameters/full_page" }, { "$ref": "#/components/parameters/fullPage" }, { "$ref": "#/components/parameters/transparent_background" }, { "$ref": "#/components/parameters/omitBackground" }, { "$ref": "#/components/parameters/ready_event" }, { "$ref": "#/components/parameters/readyEvent" }, { "$ref": "#/components/parameters/wait_ms" }, { "$ref": "#/components/parameters/waitMs" }, { "$ref": "#/components/parameters/max_execution_ms" }, { "$ref": "#/components/parameters/maxExecutionMs" }, { "$ref": "#/components/parameters/javascript_code" }, { "$ref": "#/components/parameters/preRenderCode" }, { "$ref": "#/components/parameters/css_code" }, { "$ref": "#/components/parameters/cssCode" }, { "$ref": "#/components/parameters/user_agent" }, { "$ref": "#/components/parameters/userAgent" }, { "$ref": "#/components/parameters/http_headers" }, { "$ref": "#/components/parameters/httpHeaders" }, { "$ref": "#/components/parameters/adblock" }, { "$ref": "#/components/parameters/country" }, { "$ref": "#/components/parameters/block_cookie_banner" }, { "$ref": "#/components/parameters/light_mode" }, { "$ref": "#/components/parameters/viewport_preset" } ], "responses": { "200": { "$ref": "#/components/responses/ScreenshotSuccess" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" } } }, "post": { "summary": "Take a screenshot (POST)", "description": "Capture a screenshot of a URL or HTML content using a JSON body. This endpoint is recommended for complex requests, especially when using cookies, HTTP headers, or JavaScript/CSS injection.", "operationId": "postScreenshot", "tags": ["Screenshot"], "x-code-samples": [ { "lang": "cURL", "label": "cURL (RapidAPI)", "source": "curl -X POST \"https://screenshotty1.p.rapidapi.com/v1/screenshot\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: screenshotty1.p.rapidapi.com\" \\\n -d '{\n \"url\": \"https://example.com\",\n \"format\": \"image/png\",\n \"viewport_width\": 1920,\n \"viewport_height\": 1080,\n \"full_page\": true\n }' \\\n --output screenshot.png" }, { "lang": "JavaScript", "label": "Node.js (axios)", "source": "const axios = require('axios');\nconst fs = require('fs');\n\nconst options = {\n method: 'POST',\n url: 'https://screenshotty1.p.rapidapi.com/v1/screenshot',\n headers: {\n 'Content-Type': 'application/json',\n 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY',\n 'X-RapidAPI-Host': 'screenshotty1.p.rapidapi.com'\n },\n data: {\n url: 'https://example.com',\n format: 'image/png',\n viewport_width: 1920,\n viewport_height: 1080,\n full_page: true,\n javascript_code: \"document.querySelector('.cookie-banner')?.remove();\"\n },\n responseType: 'arraybuffer'\n};\n\naxios.request(options)\n .then(response => fs.writeFileSync('screenshot.png', response.data))\n .catch(error => console.error(error));" }, { "lang": "Python", "label": "Python (requests)", "source": "import requests\n\nurl = \"https://screenshotty1.p.rapidapi.com/v1/screenshot\"\n\npayload = {\n \"url\": \"https://example.com\",\n \"format\": \"image/png\",\n \"viewport_width\": 1920,\n \"viewport_height\": 1080,\n \"full_page\": True,\n \"javascript_code\": \"document.querySelector('.cookie-banner')?.remove();\"\n}\n\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Key\": \"YOUR_RAPIDAPI_KEY\",\n \"X-RapidAPI-Host\": \"screenshotty1.p.rapidapi.com\"\n}\n\nresponse = requests.post(url, json=payload, headers=headers)\n\nwith open(\"screenshot.png\", \"wb\") as f:\n f.write(response.content)" }, { "lang": "PHP", "label": "PHP (cURL)", "source": " \"https://screenshotty1.p.rapidapi.com/v1/screenshot\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_POST => true,\n CURLOPT_POSTFIELDS => json_encode([\n 'url' => 'https://example.com',\n 'format' => 'image/png',\n 'viewport_width' => 1920,\n 'viewport_height' => 1080,\n 'full_page' => true\n ]),\n CURLOPT_HTTPHEADER => [\n \"Content-Type: application/json\",\n \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\",\n \"X-RapidAPI-Host: screenshotty1.p.rapidapi.com\"\n ],\n]);\n\n$response = curl_exec($curl);\ncurl_close($curl);\n\nfile_put_contents('screenshot.png', $response);" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotRequest" }, "examples": { "simpleUrl": { "summary": "Simple URL screenshot", "value": { "url": "https://example.com", "format": "image/png" } }, "customViewport": { "summary": "Custom viewport size", "value": { "url": "https://example.com", "viewport_width": 1440, "viewport_height": 900, "format": "image/webp" } }, "withJavaScript": { "summary": "With JavaScript injection", "value": { "url": "https://example.com", "javascript_code": "document.querySelector('.cookie-banner')?.remove();", "ready_event": "networkidle", "wait_ms": 1000 } }, "htmlContent": { "summary": "Screenshot raw HTML", "value": { "html": "

Hello World

", "viewport_width": 800, "viewport_height": 600 } }, "elementScreenshot": { "summary": "Screenshot a specific element", "value": { "url": "https://example.com", "selector": "#main-content", "transparent_background": true, "format": "image/png" } }, "withCookiesAndHeaders": { "summary": "With cookies and custom headers", "value": { "url": "https://example.com/dashboard", "cookies": [ { "name": "session_id", "value": "abc123", "domain": "example.com" } ], "http_headers": { "Authorization": "Bearer token123", "Accept-Language": "en-US" } } }, "pdfExport": { "summary": "Export as PDF", "value": { "url": "https://example.com/report", "format": "application/pdf", "full_page": true } }, "geoTargeted": { "summary": "Screenshot from specific country", "value": { "url": "https://example.com", "country": "US", "response_type": "json" } }, "mobileSimulation": { "summary": "Simulate mobile device", "description": "Capture a screenshot as it would appear on an iPhone", "value": { "url": "https://example.com", "viewport_width": 390, "viewport_height": 844, "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1", "format": "image/png" } }, "socialMediaCard": { "summary": "Generate social media preview card", "description": "Create an Open Graph / Twitter card sized image", "value": { "url": "https://example.com", "viewport_width": 1200, "viewport_height": 630, "full_page": false, "format": "image/png" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ScreenshotSuccess" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" } } } }, "/v1/screenshot/countries": { "get": { "summary": "List available countries", "description": "Returns a list of available country codes that can be used with the `country` parameter to take screenshots from different geographic locations using proxies.", "operationId": "listCountries", "tags": ["Screenshot"], "x-code-samples": [ { "lang": "cURL", "label": "cURL (RapidAPI)", "source": "curl -X GET \"https://screenshotty1.p.rapidapi.com/v1/screenshot/countries\" \\\n -H \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: screenshotty1.p.rapidapi.com\"" }, { "lang": "JavaScript", "label": "Node.js (axios)", "source": "const axios = require('axios');\n\nconst options = {\n method: 'GET',\n url: 'https://screenshotty1.p.rapidapi.com/v1/screenshot/countries',\n headers: {\n 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY',\n 'X-RapidAPI-Host': 'screenshotty1.p.rapidapi.com'\n }\n};\n\naxios.request(options)\n .then(response => console.log(response.data))\n .catch(error => console.error(error));" }, { "lang": "Python", "label": "Python (requests)", "source": "import requests\n\nurl = \"https://screenshotty1.p.rapidapi.com/v1/screenshot/countries\"\n\nheaders = {\n \"X-RapidAPI-Key\": \"YOUR_RAPIDAPI_KEY\",\n \"X-RapidAPI-Host\": \"screenshotty1.p.rapidapi.com\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())" } ], "responses": { "200": { "description": "List of available country codes", "content": { "application/json": { "schema": { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "string" }, "example": ["US", "UK", "DE", "FR", "JP", "BR"] } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } } }, "components": { "securitySchemes": { "RapidAPIKey": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Key", "description": "Your RapidAPI application key. Get this from your RapidAPI dashboard after subscribing to the API." }, "RapidAPIHost": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Host", "description": "The RapidAPI host for this API. Must be set to `screenshotty1.p.rapidapi.com`." } }, "parameters": { "url": { "name": "url", "in": "query", "description": "The URL of the webpage to capture. Either `url` or `html` must be provided, but not both.", "required": false, "schema": { "type": "string", "format": "uri", "example": "https://example.com" } }, "html": { "name": "html", "in": "query", "description": "Raw HTML content to render and capture. Useful for generating images from dynamic content or templates. Either `url` or `html` must be provided, but not both.", "required": false, "schema": { "type": "string", "example": "

Hello World

" } }, "format": { "name": "format", "in": "query", "description": "The output image format. Defaults to `image/png`.", "required": false, "schema": { "type": "string", "enum": [ "image/png", "image/jpg", "image/jpeg", "image/gif", "image/webp", "image/jp2", "image/tiff", "application/pdf" ], "default": "image/png" } }, "response_type": { "name": "response_type", "in": "query", "description": "How the screenshot should be returned:\n- `image` (default): Returns the raw image binary data with appropriate Content-Type header\n- `file`: Same as `image`, returns raw binary data\n- `json`: Returns a JSON object with the image URL\n- `url`: Same as `json`, returns `{\"url\": \"...\"}`\n- `redirect`: Performs an HTTP redirect to the image URL", "required": false, "schema": { "type": "string", "enum": ["image", "json", "url", "redirect", "file"], "default": "image" } }, "responseType": { "name": "responseType", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `response_type` instead.\n\nHow the screenshot should be returned.", "required": false, "schema": { "type": "string", "enum": ["image", "json", "url", "redirect", "file"], "default": "image" } }, "viewport_width": { "name": "viewport_width", "in": "query", "description": "The width of the browser viewport in pixels. This determines the width of the rendered page. Maximum value is 3840 pixels.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 3840, "default": 1920, "example": 1920 } }, "viewportWidth": { "name": "viewportWidth", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `viewport_width` instead.\n\nThe width of the browser viewport in pixels.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 3840, "default": 1920, "example": 1920 } }, "viewport_height": { "name": "viewport_height", "in": "query", "description": "The height of the browser viewport in pixels. This affects the visible area before scrolling. Maximum value is 3840 pixels. Note: If `full_page` is true, the screenshot will capture the entire scrollable content regardless of this value.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 3840, "default": 1080, "example": 1080 } }, "viewportHeight": { "name": "viewportHeight", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `viewport_height` instead.\n\nThe height of the browser viewport in pixels.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 3840, "default": 1080, "example": 1080 } }, "crop_x": { "name": "crop_x", "in": "query", "description": "The X coordinate (in pixels) of the top-left corner of the crop region. Use together with `crop_y`, `crop_width`, and `crop_height` to capture a specific portion of the page.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 100 } }, "screenshotX": { "name": "screenshotX", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `crop_x` instead.\n\nThe X coordinate (in pixels) of the top-left corner of the crop region.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 100 } }, "crop_y": { "name": "crop_y", "in": "query", "description": "The Y coordinate (in pixels) of the top-left corner of the crop region. Use together with `crop_x`, `crop_width`, and `crop_height` to capture a specific portion of the page.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 50 } }, "screenshotY": { "name": "screenshotY", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `crop_y` instead.\n\nThe Y coordinate (in pixels) of the top-left corner of the crop region.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 50 } }, "crop_width": { "name": "crop_width", "in": "query", "description": "The width (in pixels) of the crop region. Use together with `crop_x`, `crop_y`, and `crop_height` to capture a specific portion of the page.", "required": false, "schema": { "type": "integer", "minimum": 1, "example": 800 } }, "screenshotWidth": { "name": "screenshotWidth", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `crop_width` instead.\n\nThe width (in pixels) of the crop region.", "required": false, "schema": { "type": "integer", "minimum": 1, "example": 800 } }, "crop_height": { "name": "crop_height", "in": "query", "description": "The height (in pixels) of the crop region. Use together with `crop_x`, `crop_y`, and `crop_width` to capture a specific portion of the page.", "required": false, "schema": { "type": "integer", "minimum": 1, "example": 600 } }, "screenshotHeight": { "name": "screenshotHeight", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `crop_height` instead.\n\nThe height (in pixels) of the crop region.", "required": false, "schema": { "type": "integer", "minimum": 1, "example": 600 } }, "selector": { "name": "selector", "in": "query", "description": "A CSS selector to identify a specific element to screenshot. Only the matching element will be captured, ignoring the rest of the page. Useful for capturing specific components like charts, cards, or sections.", "required": false, "schema": { "type": "string", "example": "#main-content" } }, "selectorToScreenshot": { "name": "selectorToScreenshot", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `selector` instead.\n\nA CSS selector to identify a specific element to screenshot.", "required": false, "schema": { "type": "string", "example": "#main-content" } }, "full_page": { "name": "full_page", "in": "query", "description": "When `true`, captures the entire scrollable page content, not just the visible viewport. When `false`, only captures the visible viewport area.", "required": false, "schema": { "type": "boolean", "default": true } }, "fullPage": { "name": "fullPage", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `full_page` instead.\n\nWhen `true`, captures the entire scrollable page content.", "required": false, "schema": { "type": "boolean", "default": true } }, "transparent_background": { "name": "transparent_background", "in": "query", "description": "When `true`, makes the background transparent (only works with PNG format). Useful for capturing elements that you want to overlay on other images or backgrounds.", "required": false, "schema": { "type": "boolean", "default": false } }, "omitBackground": { "name": "omitBackground", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `transparent_background` instead.\n\nWhen `true`, makes the background transparent (only works with PNG format).", "required": false, "schema": { "type": "boolean", "default": false } }, "ready_event": { "name": "ready_event", "in": "query", "description": "Specifies when to consider the page ready for screenshot:\n- `load`: Wait for the `load` event (all resources loaded)\n- `domcontentloaded` (default): Wait for the `DOMContentLoaded` event (HTML parsed)\n- `networkidle`: Wait until there are no more than 2 network connections for 500ms\n- `networkidle2`: Same as `networkidle`\n- `networkidle0`: Wait until there are no network connections for 500ms", "required": false, "schema": { "type": "string", "enum": ["load", "domcontentloaded", "networkidle", "networkidle2", "networkidle0"], "default": "domcontentloaded" } }, "readyEvent": { "name": "readyEvent", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `ready_event` instead.\n\nSpecifies when to consider the page ready for screenshot.", "required": false, "schema": { "type": "string", "enum": ["load", "domcontentloaded", "networkidle", "networkidle2", "networkidle0"], "default": "domcontentloaded" } }, "wait_ms": { "name": "wait_ms", "in": "query", "description": "Additional time to wait (in milliseconds) after the `ready_event` before taking the screenshot. Useful for pages with animations or delayed content loading.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 1000 } }, "waitMs": { "name": "waitMs", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `wait_ms` instead.\n\nAdditional time to wait (in milliseconds) after the ready event.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 1000 } }, "max_execution_ms": { "name": "max_execution_ms", "in": "query", "description": "Maximum time (in milliseconds) to wait for the page to load before timing out. If the page takes longer than this, the screenshot will fail.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 30000 } }, "maxExecutionMs": { "name": "maxExecutionMs", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `max_execution_ms` instead.\n\nMaximum time (in milliseconds) to wait for the page to load.", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 30000 } }, "user_agent": { "name": "user_agent", "in": "query", "description": "Custom User-Agent string to use when loading the page. Useful for accessing mobile versions of sites or bypassing basic bot detection.", "required": false, "schema": { "type": "string", "example": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15" } }, "userAgent": { "name": "userAgent", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `user_agent` instead.\n\nCustom User-Agent string to use when loading the page.", "required": false, "schema": { "type": "string", "example": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15" } }, "adblock": { "name": "adblock", "in": "query", "description": "When `true`, blocks ads and trackers for a cleaner screenshot. This can also speed up page loading.", "required": false, "schema": { "type": "boolean", "default": false } }, "country": { "name": "country", "in": "query", "description": "Two-letter country code (ISO 3166-1 alpha-2) to take the screenshot from a specific geographic location using a proxy. Use the `/v1/screenshot/countries` endpoint to get the list of available countries.", "required": false, "schema": { "type": "string", "example": "US" } }, "http_headers": { "name": "http_headers", "in": "query", "description": "Custom HTTP headers to send with the request (JSON encoded). Useful for authentication, language preferences, or custom headers required by the target site.", "required": false, "schema": { "type": "string", "example": "{\"Authorization\": \"Bearer token123\", \"Accept-Language\": \"en-US\"}" } }, "httpHeaders": { "name": "httpHeaders", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `http_headers` instead.\n\nCustom HTTP headers to send with the request (JSON encoded).", "required": false, "schema": { "type": "string", "example": "{\"Authorization\": \"Bearer token123\"}" } }, "javascript_code": { "name": "javascript_code", "in": "query", "description": "JavaScript code to execute on the page before taking the screenshot. Useful for removing popups, clicking buttons, scrolling, or modifying the page content.", "required": false, "schema": { "type": "string", "example": "document.querySelector('.cookie-banner')?.remove();" } }, "preRenderCode": { "name": "preRenderCode", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `javascript_code` instead.\n\nJavaScript code to execute on the page before taking the screenshot.", "required": false, "schema": { "type": "string", "example": "document.querySelector('.cookie-banner')?.remove();" } }, "css_code": { "name": "css_code", "in": "query", "description": "CSS code to inject into the page before taking the screenshot. Useful for hiding elements, changing styles, or adding custom styling.", "required": false, "schema": { "type": "string", "example": ".advertisement { display: none !important; }" } }, "cssCode": { "name": "cssCode", "in": "query", "deprecated": true, "description": "**DEPRECATED**: Use `css_code` instead.\n\nCSS code to inject into the page before taking the screenshot.", "required": false, "schema": { "type": "string", "example": ".advertisement { display: none !important; }" } }, "block_cookie_banner": { "name": "block_cookie_banner", "in": "query", "description": "When `true`, automatically detects and removes cookie consent banners and GDPR popups from the page before taking the screenshot.", "required": false, "schema": { "type": "boolean", "default": false } }, "light_mode": { "name": "light_mode", "in": "query", "description": "Controls the color scheme preference for the page:\n- `default`: Use the page's default color scheme\n- `light`: Force light mode (prefers-color-scheme: light)\n- `dark`: Force dark mode (prefers-color-scheme: dark)", "required": false, "schema": { "type": "string", "enum": ["default", "light", "dark"], "default": "default" } }, "viewport_preset": { "name": "viewport_preset", "in": "query", "description": "Quick viewport size preset for common devices. If specified, this sets both `viewport_width` and `viewport_height` automatically. You can still override individual dimensions by providing explicit `viewport_width` or `viewport_height` values.\n\nAvailable presets:\n- `desktop`: 1920×1080 (Full HD)\n- `desktop_hd`: 2560×1440 (2K/QHD)\n- `desktop_4k`: 3840×2160 (4K/UHD)\n- `tablet`: 768×1024 (iPad portrait)\n- `tablet_landscape`: 1024×768 (iPad landscape)\n- `mobile`: 390×844 (generic mobile portrait)\n- `mobile_landscape`: 844×390 (generic mobile landscape)\n- `mobile_android`: 360×800 (Android portrait)\n- `mobile_android_landscape`: 800×360 (Android landscape)\n- `iphone_se`: 375×667 (iPhone SE)\n- `iphone_14`: 390×844 (iPhone 14)\n- `iphone_14_pro`: 393×852 (iPhone 14 Pro)\n- `iphone_14_pro_max`: 430×932 (iPhone 14 Pro Max)\n- `iphone_15`: 393×852 (iPhone 15)\n- `iphone_15_pro_max`: 430×932 (iPhone 15 Pro Max)", "required": false, "schema": { "type": "string", "enum": ["desktop", "desktop_hd", "desktop_4k", "tablet", "tablet_landscape", "mobile", "mobile_landscape", "mobile_android", "mobile_android_landscape", "iphone_se", "iphone_14", "iphone_14_pro", "iphone_14_pro_max", "iphone_15", "iphone_15_pro_max"] } } }, "schemas": { "ScreenshotRequest": { "type": "object", "description": "Request body for creating a screenshot. **Note**: Fields using snake_case are recommended. camelCase aliases are deprecated but still supported for backwards compatibility.", "properties": { "url": { "type": "string", "format": "uri", "description": "The URL of the webpage to capture. Either `url` or `html` must be provided, but not both.", "example": "https://example.com" }, "html": { "type": "string", "description": "Raw HTML content to render and capture. Useful for generating images from dynamic content or templates. Either `url` or `html` must be provided, but not both.", "example": "

Hello World

" }, "format": { "type": "string", "description": "The output image format. Defaults to `image/png`.", "enum": [ "image/png", "image/jpg", "image/jpeg", "image/gif", "image/webp", "image/jp2", "image/tiff", "application/pdf" ], "default": "image/png" }, "response_type": { "type": "string", "description": "How the screenshot should be returned:\n- `image` (default): Returns the raw image binary data with appropriate Content-Type header\n- `file`: Same as `image`, returns raw binary data\n- `json`: Returns a JSON object with the image URL\n- `url`: Same as `json`, returns `{\"url\": \"...\"}`\n- `redirect`: Performs an HTTP redirect to the image URL", "enum": ["image", "json", "url", "redirect", "file"], "default": "image" }, "responseType": { "type": "string", "deprecated": true, "description": "**DEPRECATED**: Use `response_type` instead.", "enum": ["image", "json", "url", "redirect", "file"], "default": "image" }, "viewport_width": { "type": "integer", "description": "The width of the browser viewport in pixels. Maximum value is 3840 pixels.", "minimum": 1, "maximum": 3840, "default": 1920, "example": 1920 }, "viewportWidth": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `viewport_width` instead.", "minimum": 1, "maximum": 3840, "default": 1920 }, "viewport_height": { "type": "integer", "description": "The height of the browser viewport in pixels. Maximum value is 3840 pixels.", "minimum": 1, "maximum": 3840, "default": 1080, "example": 1080 }, "viewportHeight": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `viewport_height` instead.", "minimum": 1, "maximum": 3840, "default": 1080 }, "crop_x": { "type": "integer", "description": "The X coordinate (in pixels) of the top-left corner of the crop region.", "minimum": 0, "example": 100 }, "screenshotX": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `crop_x` instead.", "minimum": 0 }, "crop_y": { "type": "integer", "description": "The Y coordinate (in pixels) of the top-left corner of the crop region.", "minimum": 0, "example": 50 }, "screenshotY": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `crop_y` instead.", "minimum": 0 }, "crop_width": { "type": "integer", "description": "The width (in pixels) of the crop region.", "minimum": 1, "example": 800 }, "screenshotWidth": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `crop_width` instead.", "minimum": 1 }, "crop_height": { "type": "integer", "description": "The height (in pixels) of the crop region.", "minimum": 1, "example": 600 }, "screenshotHeight": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `crop_height` instead.", "minimum": 1 }, "selector": { "type": "string", "description": "A CSS selector to identify a specific element to screenshot. Only the matching element will be captured.", "example": "#main-content" }, "selectorToScreenshot": { "type": "string", "deprecated": true, "description": "**DEPRECATED**: Use `selector` instead." }, "full_page": { "type": "boolean", "description": "When `true`, captures the entire scrollable page content.", "default": true }, "fullPage": { "type": "boolean", "deprecated": true, "description": "**DEPRECATED**: Use `full_page` instead.", "default": true }, "transparent_background": { "type": "boolean", "description": "When `true`, makes the background transparent (only works with PNG format).", "default": false }, "omitBackground": { "type": "boolean", "deprecated": true, "description": "**DEPRECATED**: Use `transparent_background` instead.", "default": false }, "ready_event": { "type": "string", "description": "Specifies when to consider the page ready for screenshot:\n- `load`: Wait for the `load` event (all resources loaded)\n- `domcontentloaded` (default): Wait for the `DOMContentLoaded` event (HTML parsed)\n- `networkidle`: Wait until there are no more than 2 network connections for 500ms\n- `networkidle2`: Same as `networkidle`\n- `networkidle0`: Wait until there are no network connections for 500ms", "enum": ["load", "domcontentloaded", "networkidle", "networkidle2", "networkidle0"], "default": "domcontentloaded" }, "readyEvent": { "type": "string", "deprecated": true, "description": "**DEPRECATED**: Use `ready_event` instead.", "enum": ["load", "domcontentloaded", "networkidle", "networkidle2", "networkidle0"], "default": "domcontentloaded" }, "wait_ms": { "type": "integer", "description": "Additional time to wait (in milliseconds) after the `ready_event` before taking the screenshot.", "minimum": 0, "example": 1000 }, "waitMs": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `wait_ms` instead.", "minimum": 0 }, "max_execution_ms": { "type": "integer", "description": "Maximum time (in milliseconds) to wait for the page to load before timing out.", "minimum": 0, "example": 30000 }, "maxExecutionMs": { "type": "integer", "deprecated": true, "description": "**DEPRECATED**: Use `max_execution_ms` instead.", "minimum": 0 }, "javascript_code": { "type": "string", "description": "JavaScript code to execute on the page before taking the screenshot. Useful for removing popups, clicking buttons, scrolling, or modifying the page content.", "example": "document.querySelector('.cookie-banner')?.remove();" }, "preRenderCode": { "type": "string", "deprecated": true, "description": "**DEPRECATED**: Use `javascript_code` instead." }, "css_code": { "type": "string", "description": "CSS code to inject into the page before taking the screenshot. Useful for hiding elements, changing styles, or adding custom styling.", "example": ".advertisement { display: none !important; }" }, "cssCode": { "type": "string", "deprecated": true, "description": "**DEPRECATED**: Use `css_code` instead." }, "user_agent": { "type": "string", "description": "Custom User-Agent string to use when loading the page.", "example": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15" }, "userAgent": { "type": "string", "deprecated": true, "description": "**DEPRECATED**: Use `user_agent` instead." }, "cookies": { "type": "array", "description": "Array of cookies to set before loading the page. Useful for authenticated sessions or personalized content.", "items": { "$ref": "#/components/schemas/Cookie" }, "example": [ { "name": "session_id", "value": "abc123", "domain": "example.com" } ] }, "http_headers": { "type": "object", "description": "Custom HTTP headers to send with the request. Useful for authentication, language preferences, or custom headers required by the target site.", "additionalProperties": { "type": "string" }, "example": { "Authorization": "Bearer token123", "Accept-Language": "en-US" } }, "httpHeaders": { "type": "object", "deprecated": true, "description": "**DEPRECATED**: Use `http_headers` instead.", "additionalProperties": { "type": "string" } }, "adblock": { "type": "boolean", "description": "When `true`, blocks ads and trackers for a cleaner screenshot.", "default": false }, "country": { "type": "string", "description": "Two-letter country code (ISO 3166-1 alpha-2) to take the screenshot from a specific geographic location.", "example": "US" }, "block_cookie_banner": { "type": "boolean", "description": "When `true`, automatically detects and removes cookie consent banners and GDPR popups from the page before taking the screenshot.", "default": false }, "light_mode": { "type": "string", "description": "Controls the color scheme preference for the page:\n- `default`: Use the page's default color scheme\n- `light`: Force light mode (prefers-color-scheme: light)\n- `dark`: Force dark mode (prefers-color-scheme: dark)", "enum": ["default", "light", "dark"], "default": "default" }, "viewport_preset": { "type": "string", "description": "Quick viewport size preset for common devices. If specified, this sets both `viewport_width` and `viewport_height` automatically. You can still override individual dimensions.\n\nAvailable presets:\n- `desktop`: 1920×1080 (Full HD)\n- `desktop_hd`: 2560×1440 (2K/QHD)\n- `desktop_4k`: 3840×2160 (4K/UHD)\n- `tablet`: 768×1024 (iPad portrait)\n- `tablet_landscape`: 1024×768 (iPad landscape)\n- `mobile`: 390×844 (generic mobile portrait)\n- `mobile_landscape`: 844×390 (generic mobile landscape)\n- `mobile_android`: 360×800 (Android portrait)\n- `mobile_android_landscape`: 800×360 (Android landscape)\n- `iphone_se`: 375×667 (iPhone SE)\n- `iphone_14`: 390×844 (iPhone 14)\n- `iphone_14_pro`: 393×852 (iPhone 14 Pro)\n- `iphone_14_pro_max`: 430×932 (iPhone 14 Pro Max)\n- `iphone_15`: 393×852 (iPhone 15)\n- `iphone_15_pro_max`: 430×932 (iPhone 15 Pro Max)", "enum": ["desktop", "desktop_hd", "desktop_4k", "tablet", "tablet_landscape", "mobile", "mobile_landscape", "mobile_android", "mobile_android_landscape", "iphone_se", "iphone_14", "iphone_14_pro", "iphone_14_pro_max", "iphone_15", "iphone_15_pro_max"] } } }, "Cookie": { "type": "object", "description": "A browser cookie to set before loading the page", "required": ["name", "value"], "properties": { "name": { "type": "string", "description": "The name of the cookie", "example": "session_id" }, "value": { "type": "string", "description": "The value of the cookie", "example": "abc123xyz" }, "domain": { "type": "string", "description": "The domain for which the cookie is valid. If not specified, defaults to the URL's domain.", "example": "example.com" }, "path": { "type": "string", "description": "The path for which the cookie is valid", "default": "/", "example": "/" }, "expires": { "type": "number", "description": "Unix timestamp (in seconds) when the cookie expires", "example": 1735689600 }, "httpOnly": { "type": "boolean", "description": "Whether the cookie is HTTP-only", "default": false }, "secure": { "type": "boolean", "description": "Whether the cookie should only be sent over HTTPS", "default": false }, "sameSite": { "type": "string", "description": "The SameSite attribute of the cookie", "enum": ["Strict", "Lax", "None"] } } }, "ScreenshotUrlResponse": { "type": "object", "description": "Response when `responseType` is `json` or `url`", "properties": { "url": { "type": "string", "format": "uri", "description": "The URL where the screenshot image can be accessed", "example": "https://screenshots.rapidapi.io/abc123.png" } } }, "ErrorResponse": { "type": "object", "description": "Error response returned when the request fails", "properties": { "error": { "type": "string", "description": "A human-readable error message describing what went wrong", "example": "Country 'XX' is not available. Available countries: US, UK, DE, FR" } } }, "RapidAPIErrorResponse": { "type": "object", "description": "Error response from RapidAPI (subscription, quota, or rate limit issues)", "properties": { "message": { "type": "string", "description": "A human-readable error message from RapidAPI", "example": "You have exceeded the MONTHLY quota for requests on your current plan." } } } }, "responses": { "ScreenshotSuccess": { "description": "Screenshot captured successfully. The response format depends on the `responseType` parameter:\n- `image`/`file`: Returns binary image data\n- `json`/`url`: Returns JSON with image URL\n- `redirect`: Returns 302 redirect to image URL", "content": { "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } }, "image/webp": { "schema": { "type": "string", "format": "binary" } }, "image/gif": { "schema": { "type": "string", "format": "binary" } }, "application/pdf": { "schema": { "type": "string", "format": "binary" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotUrlResponse" } } } }, "BadRequest": { "description": "Bad request - Invalid parameters or screenshot processing failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "invalidCountry": { "summary": "Invalid country code", "value": { "error": "Country 'XX' is not available. Available countries: US, UK, DE, FR" } }, "processingFailed": { "summary": "Screenshot processing failed", "value": { "error": "Navigation timeout: page took too long to load" } } } } } }, "Unauthorized": { "description": "Unauthorized - Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "error": "Invalid or missing API key" } } } }, "InternalError": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "error": "Screenshot processing failed: no image URL returned" } } } }, "Forbidden": { "description": "Forbidden - Subscription inactive or quota exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RapidAPIErrorResponse" }, "examples": { "subscriptionInactive": { "summary": "Subscription not active", "value": { "message": "You are not subscribed to this API." } }, "quotaExceeded": { "summary": "Monthly quota exceeded", "value": { "message": "You have exceeded the MONTHLY quota for requests on your current plan." } } } } } }, "TooManyRequests": { "description": "Too Many Requests - Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RapidAPIErrorResponse" }, "example": { "message": "You have exceeded the rate limit per second for your plan. Please upgrade your plan or wait before making more requests." } } }, "headers": { "X-RateLimit-Limit": { "description": "The maximum number of requests allowed per time window", "schema": { "type": "integer", "example": 100 } }, "X-RateLimit-Remaining": { "description": "The number of requests remaining in the current time window", "schema": { "type": "integer", "example": 0 } }, "X-RateLimit-Reset": { "description": "Unix timestamp when the rate limit resets", "schema": { "type": "integer", "example": 1702598400 } } } } } }, "tags": [ { "name": "Screenshot", "description": "Endpoints for capturing screenshots of webpages and HTML content", "x-displayName": "Screenshot" } ], "x-readme": { "explorer-enabled": true, "proxy-enabled": true, "samples-enabled": true, "samples-languages": ["curl", "node", "python", "php", "java", "csharp", "go", "ruby"] } }