Generic Playwright Scraper

What this Actor does

Render public pages with Playwright and extract text fields using a safe declarative CSS selector map. This Actor wraps the Generic Playwright Scraper API and writes one dataset item per scraped URL.

Input example

{
  "selectors": {
    "heading": "h1",
    "summary": "p"
  },
  "waitFor": "main",
  "timeoutMs": 15000,
  "screenshot": false
}

Input fields

Provide public URLs and a JSON object mapping output field names to CSS selectors. User JavaScript, page functions, and hooks are not supported in v1.

• urls (array, user input): Up to 100 public http(s) URLs. Private-network, localhost, link-local, and metadata URLs are blocked.
• selectors (object, user input): Object of fieldName to CSS selector, for example {"heading":"h1","summary":"p"}.
• waitFor (string, user input): Optional CSS selector to wait for before extraction.
• timeoutMs (integer, user input): Per-URL timeout from 1000 to 30000 milliseconds.
• screenshot (boolean, user input): When true, include a PNG data URL screenshot in each result.
• apiBaseUrl (string, optional override): Override of the upstream API base URL. Defaults to runtime.baseUrl from service.json.

Output dataset

Each dataset item is one rendered page with extracted selector fields.

• input: Original Actor input for this run.
• url: Requested URL.
• finalUrl: Final URL after redirects.
• status: HTTP status from the main document response.
• fields: Extracted field map.
• screenshot: Optional PNG data URL screenshot.

Developer notes

Set GENERIC_PLAYWRIGHT_SCRAPER_API_KEY as an Apify secret environment variable. The Actor forwards it as X-API-Key to the upstream API. Use apiBaseUrl only for local or staging QA. Production runs default to the deployed API base URL from service.json. For advanced testing, a requests array can call explicit API paths; normal users should use the service-specific fields above.

Run locally

$apify run

Deploy

$apify push