# Quick Start: Web Unblocker

Oxylabs [Web Unblocker](https://oxylabs.io/products/web-unblocker) is an AI-powered proxy solution designed to handle the most sophisticated anti-bot systems (e.g., Akamai, Cloudflare, or DataDome). It automatically manages proxy rotation, browser fingerprinting, and CAPTCHA solving so you can focus on the data.

{% stepper %}
{% step %}

### Setup & credentials

1. **Create an account:** Sign up at the [Oxylabs Dashboard](https://dashboard.oxylabs.io/).
2. **Create an API User:** Navigate to Web Unblocker → Users and create a username and password (These are credentials to authorize access to Web Unblocker and separate from you dashboard login)
   {% endstep %}

{% step %}

### Your first request

Web Unblocker is integrated as a proxy. Use the endpoint `unblock.oxylabs.io:60000` and pass your instructions via custom headers.

```bash
curl -k -x unblock.oxylabs.io:60000 -U 'USERNAME:PASSWORD' \
'https://sandbox.oxylabs.io/products' \
-H 'x-oxylabs-geo-location: United States' \
-H 'x-oxylabs-render: html'
```

{% hint style="info" %}
Replace `USERNAME` and `PASSWORD` with your User credentials
{% endhint %}
{% endstep %}
{% endstepper %}

### Essential Headers

Unlike standard proxies, Web Unblocker uses headers to control its AI-driven features:

| Header                    | Value                            | Description                                                         |
| ------------------------- | -------------------------------- | ------------------------------------------------------------------- |
| `x-oxylabs-geo-location`  | `United States`, `Germany`, etc. | Sets the exit node to a specific country.                           |
| `x-oxylabs-render`        | `html` or `png`                  | Enables JavaScript rendering or returns a screenshot.               |
| `x-oxylabs-session-id`    | `AnyRandomString`                | Keeps the same IP for multiple requests (Sticky Session).           |
| `x-oxylabs-force-headers` | `1`                              | Forces the unblocker to send your own custom headers to the target. |

### Common response codes

| Code  | Status              | Description                                                   |
| ----- | ------------------- | ------------------------------------------------------------- |
| `200` | `OK`                | Successful request. You receive the full rendered HTML.       |
| `401` | `Unauthorized`      | Invalid API User credentials or missing authentication.       |
| `429` | `Too Many Requests` | You have reached your account's rate limit.                   |
| `550` | `Faulted`           | The system failed to unblock the site after multiple retries. |

You can find the [full list of response codes](/products/web-unblocker/response-codes.md) in the Web Unblocker product section.

### Next Steps

* **Advanced browser control:** Need to click buttons or scroll? Check out the [Custom Browser Instructions](/products/web-unblocker/custom-browser-instructions.md) in the Products section.
* **Geo-targeting:** For localized data, see the [Geo-location](/products/web-unblocker/making-requests/geo-location.md) page for targeting specific countries, cities, or coordinates.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/get-started/quick-start-web-unblocker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
