Skip to main content

Changelog

Notable changes to the OmniScrape API. Backwards-compatible additions (new optional fields) are made without a version bump — unknown fields are always ignored, so new parameters never break existing integrations.

v1.2.0

  • Free trial & proxy lock. New accounts get free credit and a 7-day trial for Web Unlocker and BaaS. Direct proxy URLs, dashboard credentials, and /v1/proxy/fetch return 402 with PROXY_LOCKED until PAYG ($5 minimum top-up) or a paid plan is active.
  • Proxy gateway. HTTP (8080), HTTPS (8443), and SOCKS5 (1080) on proxy.omniscrape.io with dedicated credentials and POST /auth/rotate-proxy-credentials.
  • 217 countries for residential geo-targeting (up from 25+).
  • Checkout billing. Balance top-ups and subscriptions via checkout; Paddle as Merchant of Record when integrated. See Refund Policy.

v1.1.0

  • Async jobs. Submit work to /v1/scrape/async and poll /v1/jobs/:id for large batches and slow targets.
  • Browser-as-a-Service. Drive a real remote browser by connecting Playwright/Puppeteer to a single CDP URL — wss://browser.omniscrape.io?apikey=.... See Browser connection.
  • Residential proxy fetch. Raw, bandwidth-billed fetches through residential IPs via /v1/proxy/fetch.
  • Capture XHR. Set capture_xhr to collect a page's background API responses. See JS rendering.
  • Per-request billing block. Every scrape response now includes a billing object with charged, cost_per_request, and balance_after.
  • Structured error codes. 429 and 402 responses include machine-readable code values (CONCURRENCY_LIMIT, MONTHLY_QUOTA_EXCEEDED, PROXY_LOCKED). See Errors.
  • Plans & quotas. Pay-As-You-Go, Startup, and Growth plans with per-plan concurrency and monthly request allowances. See Pricing.

v1.0.0

  • Initial public release of the Web Unlocker API (POST /v1/scrape).
  • Modes: auto, fast, js_rendering.
  • Output formats: html, markdown, plain_text, autoparse, screenshot.
  • CSS extraction and built-in templates (links, images, headings, emails, phone_numbers, metadata, tables).
  • Residential proxies with residential:<country> geo-targeting in 217 countries.
  • Sticky sessions via session_id.
  • Automatic anti-bot bypass for Cloudflare, DataDome, Akamai, PerimeterX, AWS WAF, and more.