{
  "openapi": "3.0.1",
  "info": {
    "title": "🔥 Website Screenshot Generator",
    "description": "[🥇 high-quality 🏆] Website Screenshot generator for full-page, viewport, and element screenshots. Capture websites as PNG, JPEG, WebP, or PDF with mobile emulation, metadata extraction, and batch processing.",
    "version": "0.1",
    "x-build-id": "iimYsFcqxVaudUv8e"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/extractmaster01~website-screenshot-generator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-extractmaster01-website-screenshot-generator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/extractmaster01~website-screenshot-generator/runs": {
      "post": {
        "operationId": "runs-sync-extractmaster01-website-screenshot-generator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/extractmaster01~website-screenshot-generator/run-sync": {
      "post": {
        "operationId": "run-sync-extractmaster01-website-screenshot-generator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "urls"
        ],
        "properties": {
          "urls": {
            "title": "URLs",
            "type": "array",
            "description": "List of URLs to screenshot. Supports up to 1000 URLs per run.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "screenshotType": {
            "title": "Screenshot Type",
            "enum": [
              "fullPage",
              "viewport",
              "element"
            ],
            "type": "string",
            "description": "What to capture: the full scrollable page, the visible viewport only, or a specific element by CSS selector.",
            "default": "fullPage"
          },
          "format": {
            "title": "Output Format",
            "enum": [
              "png",
              "jpeg",
              "webp",
              "pdf"
            ],
            "type": "string",
            "description": "Image format. PNG is lossless. JPEG/WebP produce smaller files. PDF embeds the screenshot as an image inside a PDF page — visually identical to the PNG output, not a print layout.",
            "default": "png"
          },
          "quality": {
            "title": "JPEG/WebP Quality",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Compression quality for JPEG and WebP formats (1–100). Higher = better quality, larger file. Ignored for PNG and PDF.",
            "default": 85
          },
          "device": {
            "title": "Device Preset",
            "enum": [
              "custom",
              "Desktop 1920x1080",
              "Desktop 1440x900",
              "Desktop 1280x800",
              "Laptop 1366x768",
              "iPhone 15 Pro",
              "iPhone 14",
              "iPhone SE",
              "Pixel 7",
              "Samsung Galaxy S23",
              "iPad Pro 12.9",
              "iPad Mini"
            ],
            "type": "string",
            "description": "Emulate a specific device for responsive screenshots. Sets viewport, User-Agent, and touch support automatically. Use 'custom' to set your own dimensions.",
            "default": "Desktop 1920x1080"
          },
          "viewportWidth": {
            "title": "Custom Viewport Width (px)",
            "minimum": 100,
            "maximum": 3840,
            "type": "integer",
            "description": "Browser width in pixels. Only used when Device is set to 'Custom'.",
            "default": 1280
          },
          "viewportHeight": {
            "title": "Custom Viewport Height (px)",
            "minimum": 200,
            "maximum": 2160,
            "type": "integer",
            "description": "Browser height in pixels. Only used when Device is set to 'Custom'.",
            "default": 1080
          },
          "selector": {
            "title": "CSS Selector (Element Screenshot)",
            "type": "string",
            "description": "CSS selector of the element to screenshot. Only used when Screenshot Type is 'Specific Element'. Example: '#hero-section' or '.product-card:first-child'",
            "default": ""
          },
          "waitUntil": {
            "title": "Wait Until",
            "enum": [
              "load",
              "domcontentloaded",
              "networkidle",
              "networkidle0",
              "networkidle2"
            ],
            "type": "string",
            "description": "When to consider the page ready for capture. 'load' works for most sites and is the recommended default. 'networkidle' waits until no network requests for 500 ms — best for SPAs and React/Vue/Angular apps, but may time out on news or ad-heavy sites. 'networkidle0' and 'networkidle2' are accepted as aliases for 'networkidle'.",
            "default": "load"
          },
          "waitForSelector": {
            "title": "Wait For Selector",
            "type": "string",
            "description": "Wait for a specific CSS selector to appear before capturing. Useful for dynamic/lazy content. Example: '.product-list' or '#main-content'",
            "default": ""
          },
          "delay": {
            "title": "Delay Before Capture (ms)",
            "minimum": 0,
            "maximum": 3600000,
            "type": "integer",
            "description": "Extra wait time in milliseconds after page load before taking the screenshot. Useful for CSS animations or deferred rendering (e.g., 1000 = 1 second).",
            "default": 0
          },
          "waitForImages": {
            "title": "Wait for Images to Load",
            "type": "boolean",
            "description": "Wait for all images on the page to finish loading before capturing. Enable this for sites with carousels, lazy-loaded galleries, or hero images that render after the load event via JavaScript.",
            "default": false
          },
          "scrollToBottom": {
            "title": "Scroll to Bottom (Lazy Load)",
            "type": "boolean",
            "description": "Scroll to the bottom of the page before capturing to trigger lazy-loaded images, carousels, and infinite scroll content.",
            "default": false
          },
          "delayAfterScrolling": {
            "title": "Delay After Scrolling (ms)",
            "minimum": 0,
            "maximum": 3600000,
            "type": "integer",
            "description": "Wait time in milliseconds after scrolling to bottom. Only applies when 'Scroll to Bottom' is enabled and 'Wait for Network Idle After Scroll' is disabled.",
            "default": 2500
          },
          "waitUntilNetworkIdleAfterScroll": {
            "title": "Wait for Network Idle After Scroll",
            "type": "boolean",
            "description": "After scrolling to the bottom, wait until the network goes quiet (no requests for 500 ms) before capturing. Smarter than a fixed delay — catches lazy-loaded images and API calls triggered by scroll. Overrides 'Delay After Scrolling' when enabled.",
            "default": false
          },
          "waitUntilNetworkIdleAfterScrollTimeout": {
            "title": "Network Idle After Scroll Timeout (ms)",
            "minimum": 1000,
            "maximum": 3600000,
            "type": "integer",
            "description": "Maximum time to wait for network idle after scrolling. Only used when 'Wait for Network Idle After Scroll' is enabled. If the timeout is exceeded, the capture continues anyway.",
            "default": 30000
          },
          "blockCookieBanners": {
            "title": "Auto-dismiss Cookie Banners",
            "type": "boolean",
            "description": "Automatically click 'Accept' on GDPR/cookie consent banners (OneTrust, Didomi, Cookiebot, CookieYes, and 10+ others) for cleaner screenshots.",
            "default": true
          },
          "selectorsToHide": {
            "title": "CSS Selectors to Hide",
            "type": "string",
            "description": "Comma-separated CSS selectors of elements to hide before capturing. Useful for persistent banners, chat widgets, or overlays. Example: '.cookie-banner, #intercom-frame, .chat-widget'",
            "default": ""
          },
          "blockAds": {
            "title": "Block Ads & Trackers",
            "type": "boolean",
            "description": "Block ad networks and tracking scripts (Google Ads, Taboola, Hotjar, Mixpanel, etc.) for cleaner and faster screenshots.",
            "default": false
          },
          "darkMode": {
            "title": "Dark Mode",
            "type": "boolean",
            "description": "Emulate 'prefers-color-scheme: dark' to capture the site's dark theme.",
            "default": false
          },
          "javascript": {
            "title": "Enable JavaScript",
            "type": "boolean",
            "description": "Execute JavaScript on the page. Disable for static HTML-only pages to speed up captures.",
            "default": true
          },
          "extractMetadata": {
            "title": "Extract Page Metadata",
            "type": "boolean",
            "description": "Extract page title, meta description, Open Graph image, canonical URL, and language alongside each screenshot.",
            "default": true
          },
          "customHeaders": {
            "title": "Custom HTTP Headers",
            "type": "object",
            "description": "Custom HTTP headers to send with each request. Useful for authentication tokens or A/B test overrides. Example: {\"Authorization\": \"Bearer TOKEN\", \"X-Custom-Header\": \"value\"}",
            "default": {}
          },
          "cookies": {
            "title": "Cookies",
            "type": "array",
            "description": "Cookies to inject before navigating. Use for authenticated sessions. Each item must have 'name', 'value', and 'domain'. Example: [{\"name\": \"session\", \"value\": \"abc123\", \"domain\": \".example.com\"}]",
            "default": []
          },
          "injectCss": {
            "title": "Inject CSS",
            "type": "string",
            "description": "Custom CSS injected into the page before capturing. Use to hide elements, change fonts, or override styles. Example: '.popup { display: none !important; } body { font-size: 16px; }'",
            "default": ""
          },
          "timeout": {
            "title": "Page Load Timeout (ms)",
            "minimum": 5000,
            "maximum": 120000,
            "type": "integer",
            "description": "Maximum time in milliseconds to wait for a page to load before failing. Increase for slow sites (e.g., 60000 = 60 seconds).",
            "default": 30000
          },
          "maxRetries": {
            "title": "Retries on Failure",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Number of times to retry a failed URL. Higher values improve reliability on flaky or slow sites. Recommended: 10 for production.",
            "default": 10
          },
          "maxConcurrency": {
            "title": "Max Concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of browser tabs running simultaneously. Higher = faster, but uses more memory. Recommended: 3 for stability, 5+ for speed with sufficient memory.",
            "default": 3
          },
          "maxItems": {
            "title": "Max Screenshots",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of screenshots to capture. Useful for testing or cost control. Leave empty for no limit."
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Proxy settings for bypassing geo-restrictions or bot detection. Most sites work without a proxy. Enable Apify Proxy or your own if you encounter blocks."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}