Skip to main content
Piloterr
Back to library

Website WebUnlocker (POST) API

Send POST requests to whitelisted websites or APIs through WebUnlocker to bypass advanced anti-bot protection and retrieve the upstream response.

Active3 credits = 1 requestPOST/v2/website/webunlocker

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Website WebUnlocker (POST) API sends a POST request to a whitelisted website or API URL through Piloterr's WebUnlocker engine, then returns the upstream response (HTML or JSON). Use it when the target endpoint requires a JSON body and is protected by advanced anti-bot systems.

Whitelist required: The target domain must be on Piloterr's approved whitelist. Contact support to request a new domain.

QuickstartLink to Quickstart

POST https://api.piloterr.com/v2/website/webunlocker?query=https://www.seloger-bureaux-commerces.com/api/classifieds/search
Content-Type: application/json

{"page":1,"size":25,"codeTypeBiens":[600,700]}

Pass the target URL in query (query string or JSON body). The JSON body is forwarded as the POST payload to the target URL.

ParametersLink to Parameters

Parameter Type Required Description
query string yes Target URL with http or https (domain must be whitelisted)

Only POST is supported on this endpoint card. For GET page fetches, use Website WebUnlocker.

Response fieldsLink to Response fields

Field Type Description
(response body) string or object Upstream response after anti-bot bypass

NotesLink to Notes

  • Costs 3 credits per request
  • Prefer query-string query + JSON body for API payloads (same pattern as Website Crawler POST)
  • Contact Piloterr support to whitelist additional domains

Main use casesLink to Main use cases

  • Call protected search/listing APIs that expect a JSON body
  • Bypass DataDome / Cloudflare / Akamai on POST endpoints
  • Power enrichment pipelines against whitelisted commercial APIs
  • Prototype reverse-engineered XHR endpoints without maintaining unlocker infra

Related APIs

Expand your data capabilities with these complementary tools.

Website Antibot/v2/website/antibot

Detect which anti-bot protection protects a website before you scrape. Get the vendor, confidence level, and matching clues from a single URL check.

GET1 credit = 1 requestActive
Website Crawler (POST)/v2/website/crawler

A robust solution for efficiently extracting a wide range of data from web pages.

POST1 credit = 1 requestActive
Website Crawler/v2/website/crawler

Fetch public pages with fast HTTP crawling (no JavaScript). Best first choice for static or server-rendered HTML; use Rendering or WebUnlocker when JS or anti-bot blocks you.

GET1 credit = 1 requestActive
Website Email Phone Extractor/v2/website/email_phone_extractor

Extract emails and phone numbers from websites for comprehensive contact details, including social media profiles across 12+ platforms.

GET1 credit = 1 requestActive
Website Rendering/v2/website/rendering

Render JavaScript-heavy pages in a headless browser and return post-render HTML. Use when Crawler returns empty DOM; escalate to WebUnlocker if bot protection blocks the session.

GET2 credits = 1 requestActive
Website Rendering Instructions (POST)/v2/website/rendering

Execute browser automation instructions (scroll, scroll_to_bottom) during headless rendering to trigger lazy-loaded content, bypass anti-bot detection, and scrape dynamically loaded pages.

POST2 credits = 1 requestActive
Website Screenshot/v2/website/screenshot

Browser-like Screenshot API that captures webpages as PNG/JPEG/WebP or PDF for previews, QA, reporting, monitoring, and archiving no headless setup.

GET2 credits = 1 requestActive
Website Technology/v2/website/technology

Identify the technologies behind any website CMS, frameworks, analytics, CDN, hosting, and more, for competitive market analysis and technological insight.

GET1 credit = 1 requestActive
Website WebUnlocker/v2/website/webunlocker

Bypass advanced anti-bot systems (Cloudflare, DataDome, Akamai, PerimeterX) on whitelisted domains. Combines browser rendering and unlock tooling; use after Crawler and Rendering fail.

GET3 credits = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included