# Website WebUnlocker (POST)

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `POST` |
| **Endpoint** | `/v2/website/webunlocker` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 3 credits per call |
| **Documentation** | https://www.piloterr.com/library/website-webunlocker-website-webunlocker-post |

## Description

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

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request POST 'https://api.piloterr.com/v2/website/webunlocker' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### POST search API via WebUnlocker

```json
{"results": [{"id": "234275997", "title": "Boutique", "price": 2862000, "city": "Paris 8ème", "url": "https://www.seloger-bureaux-commerces.com/annonces/achat/boutique/paris-8eme/234275997"}], "pagination": {"page": 1, "total": 1145}}
```

## Documentation

## 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.

## 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.

## 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 fields
| Field | Type | Description |
|---|---|---|
| (response body) | string or object | Upstream response after anti-bot bypass |

## 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 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