> For the complete documentation index, see [llms.txt](https://dinproxy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dinproxy.gitbook.io/docs/guides/web-unlocker.md).

# Web Unlocker

Send a URL, get the page back. Rendering, retries and blocks are handled for you.

The Web Unlocker fetches a page for you and returns its HTML, a screenshot, or both. It renders JavaScript, retries and works around anti-bot checks, so you don't manage proxies or browsers yourself.

* **Pay only for successes**: each successful request uses 1 result from your balance. Failed requests are free.
* **One API call** with the same [proxy users](https://dinproxy.gitbook.io/docs/getting-started/proxy-users.md) as your proxies.
* Optional country, waiting for an element, custom headers and cookies, and more: see the [API reference](https://dinproxy.gitbook.io/docs/guides/web-unlocker/api-reference.md).
* Four ways to connect your own tools: the [API](https://dinproxy.gitbook.io/docs/guides/web-unlocker/api-reference.md), [proxy mode](https://dinproxy.gitbook.io/docs/guides/web-unlocker/proxy-mode.md) for scrapers that expect a proxy, an [MCP server for AI assistants and a command-line tool](https://dinproxy.gitbook.io/docs/guides/web-unlocker/mcp-and-cli.md).

## Get started

1. Open **Products → Web Unlocker**. Results are sold in units of 1k (1,000 results); choose how many and click **Get access**.
2. **Connect your tools** gives ready-to-paste settings for the API, proxy mode, MCP and the command-line tool, filled in with your proxy user.
3. Under **Try a request**, run one request in the browser, then copy the generated code.

![The Web Unlocker page: 1 proxy user, 2 target and options, 3 the request as code, 4 run it](https://425895435-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7E6QHTS6ybO8hjC6Muku%2Fuploads%2FY5TWnjkWdhRH4XxbWrkK%2Fdinproxy-web-unlocker.png?alt=media)

1. **Authentication method**: the proxy user the request signs in with.
2. **Start crawling**: the target URL, an optional country, JavaScript rendering, and the output format (HTML, PNG screenshot, or both). **Advanced parameters** holds the other options.
3. **Request preview**: the same request as code in Node.js, Python, cURL, Java, C#, PHP, Go or Ruby. Switch to **Response** to see what came back.
4. **Start request** runs it.

## Example

```bash
curl --request POST 'https://app.dinproxy.com/api/unblocker/request' \
  --user '1024~myuser:YOUR_PASSWORD' \
  --header 'Content-Type: application/json' \
  --data '{"target_url": "https://example.com", "response_format": "html"}' \
  --max-time 130
```

```json
{ "success": true, "data": { "html": "<!doctype html><html>…</html>" } }
```

{% hint style="info" %}
A request can take up to 2 minutes. Keep your client's timeout above that (e.g. 130 seconds). To retry safely, send an `Idempotency-Key`: see [Retrying safely](https://dinproxy.gitbook.io/docs/guides/web-unlocker/api-reference.md#retrying-safely).
{% endhint %}
