> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/get-started/quick-start-web-unblocker.md).

# Quick Start: Web Unblocker

{% hint style="info" %}
Already familiar with the basics? Check out [Web Unblocker documentation](/products/web-unblocker.md).
{% endhint %}

Oxylabs [Web Unblocker](https://oxylabs.io/products/web-unblocker) is an AI-powered proxy solution designed to handle the most sophisticated bot traffic management systems (e.g., Akamai, Cloudflare, or DataDome). It automatically manages proxy rotation, browser fingerprinting, and CAPTCHA handling 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 tool 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 access 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.