> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start 

> Site Unblocker Quick Start

Decodo **Site Unblocker** is a proxy-like solution that allows users to extract valuable web data from the most challenging targets without building a web scraper or using a headless browser.

To start using Site Unblocker, go to the Decodo Dashboard and select **Site Unblocker**. You can choose between **Pay per GB** and **Pay per Request** plans. The setup is the same for both subscriptions.

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/9a7409bed464c2fd28bd64604205144a21f2f4e66daf8e36c9461318e73311a2-Group_427323175.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=39434baa6edcd70ac73b93594ac9fe7b" className="mx-auto" width="3448" height="1400" data-path="images/docs/9a7409bed464c2fd28bd64604205144a21f2f4e66daf8e36c9461318e73311a2-Group_427323175.png" />

***

* The Site Unblocker solution uses the following **endpoint** for requests:

```text theme={null}
unblock.decodo.com:60000
```

* Here are some **examples**:

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
  	-U "USERNAME:PASSWORD" "https://ip.decodo.com/"
  ```

  ```python Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
  }

  response = requests.request(
      'GET',
      'https://ip.decodo.com/',
      verify=False,
      proxies=proxies,
  )

  print(response.text)
  ```

  ```javascript Node theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'USERNAME';
  const password = 'PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const response = await fetch('https://ip.decodo.com/', {
    method: 'get',
    agent: agent,
  });

  console.log(await response.text());
  ```
</CodeGroup>

<Note>
  In order to use Site Unblocker via `cURL`: `-k` or the equivalent `--insecure` flag is required. Note that you can still target websites that use `HTTPS`.
</Note>

## Authentication

Once you have an active **Site Unblocker** subscription, you will be able to view your automatically generated proxy **Username** and **Password** at the top of the **API Playground tab**.

<Note>
  1. You may **copy** your username or password by clicking on it
  2. To see the password click the **eye** icon.
  3. You can generate a new password by clicking on the arrow icon and choosing **Confirm**.
</Note>

<img src="https://mintcdn.com/decodo/7ZKpc3GV1DKO_XQr/images/docs/15741fc9278797175f88d232fbda12f2e00620750a39b82212f822f734ac21c4-Group_427323176.png?fit=max&auto=format&n=7ZKpc3GV1DKO_XQr&q=85&s=2f43991a84e13f10036a991455da26b3" className="mx-auto" width="3448" height="736" data-path="images/docs/15741fc9278797175f88d232fbda12f2e00620750a39b82212f822f734ac21c4-Group_427323176.png" />

## API Playground

Here, you can try sending a request to your chosen target right from your dashboard:

### URL

1. First, enter the **URL** of the site you wish to target.

<img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/f26d4c70f64cea93f5768a0e0a80a19cfb3c935c69b66ed1f2020f5a6fc888ed-Group_427323177.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=4e4769d3afeabd764febe4efbb9134c2" className="mx-auto" style={{ width:"46%" }} width="1600" height="424" data-path="images/docs/f26d4c70f64cea93f5768a0e0a80a19cfb3c935c69b66ed1f2020f5a6fc888ed-Group_427323177.png" />

### `JavaScript` Rendering

2. Then, choose to enable or disable **`JavaScript`** rendering.

<Note>
  * Enabled **JS rendering** allows you to target dynamic pages without using a headless browser.
  * Learn more [**here**](https://help.decodo.com/docs/site-unblocker-javascript-rendering/).
</Note>

<img src="https://mintcdn.com/decodo/7ZKpc3GV1DKO_XQr/images/docs/06c551616b948faaffdb83272421e7f307a61cd8817450710953bcb77e2eaf6f-Group_427323178.png?fit=max&auto=format&n=7ZKpc3GV1DKO_XQr&q=85&s=38016628f447cee24550b25a6f90c411" className="mx-auto" style={{ width:"46%" }} width="1600" height="480" data-path="images/docs/06c551616b948faaffdb83272421e7f307a61cd8817450710953bcb77e2eaf6f-Group_427323178.png" />

* You can send the request right away by clicking **Send Request** or specify the parameters further:

### Location

3. Choose the **location** from which you'd like to access the website.

<Note>
  * Depending on your desired location, Site Unblocker will add proxies from the Decodo IP pool.
  * Learn more about **`geo`** parameters [**here**](https://help.decodo.com/docs/site-unblocker-geo-location/).
</Note>

<img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/604dec1284e4f477029b3d40e7d508185dd18a1f18ed0bb0e3f81c5e40bfa2b3-Group_427323180.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=649179181a83053fabb9ca8ea0760cb1" className="mx-auto" style={{ width:"46%" }} width="1600" height="396" data-path="images/docs/604dec1284e4f477029b3d40e7d508185dd18a1f18ed0bb0e3f81c5e40bfa2b3-Group_427323180.png" />

### Language

4. Specify the **Locale**.

<Note>
  * The **`locale`** parameter allows you to simulate requests from a specific geographic location or language.
  * This changes the web page interface language, not the language of the results.
  * Learn more [**here**](https://help.decodo.com/docs/site-unblocker-locale/).
</Note>

<img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/7117f53b7c760b1309572ee2204b789b8e7951f2616cd07dd1ea87b40fcfdc98-Group_427323182.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=9c2bc769e367b6ceb9a041b0592267cd" className="mx-auto" style={{ width:"46%" }} width="1600" height="468" data-path="images/docs/7117f53b7c760b1309572ee2204b789b8e7951f2616cd07dd1ea87b40fcfdc98-Group_427323182.png" />

### Headers

5. Specify the **header** along with their **values**.

<Note>
  * Some headers are pre-set by default in order to increase the success rate. Enable the option below to force your own headers, however, note that the success rate may drop. Failed requests with forced headers are always charged, even if scraping fails.
  * Learn more about headers [**here**](https://help.decodo.com/docs/site-unblocker-headers/).
</Note>

<img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/bca942e9db072fcae53be6b5a345cbc0c9e864db6cf991b7dec91efd744b18e3-Group_427323184.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=125161a5171b1767d36b4b267063fe2e" className="mx-auto" style={{ width:"46%" }} width="1600" height="584" data-path="images/docs/bca942e9db072fcae53be6b5a345cbc0c9e864db6cf991b7dec91efd744b18e3-Group_427323184.png" />

### Session

6. If you want to, name your **session**.

<Note>
  * The **`session_id`** parameter allows you to use the same proxy connection for yo to **10 minutes** for multiple requests.
  * Learn more [**here**](https://help.decodo.com/docs/site-unblocker-session/).
</Note>

<img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/5194c710711c138e3815233257c9076841a272fe7c9e257abcb45e8ec44d5ba1-Group_427323187.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=a0c4a2ae4a4d18503aac63a8b87d1e4c" className="mx-auto" style={{ width:"46%" }} width="1600" height="500" data-path="images/docs/5194c710711c138e3815233257c9076841a272fe7c9e257abcb45e8ec44d5ba1-Group_427323187.png" />

### HTTP Method

7. Then, you can choose the **`HTTP`method**. `GET` is the default one; however, you can select `POST` if you want to pass a payload with your request.

<Note>
  * Learn more about `POST` requests [**here**](https://help.decodo.com/docs/site-unblocker-post-requests/).
</Note>

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/833b94554d2bed2067509f8ae191b68b3f83f5c6fb1550de0943b0363afe9b0b-Group_427323189.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=5921b8793aec39e2f091cbd1371292a9" className="mx-auto" style={{ width:"46%" }} width="1600" height="672" data-path="images/docs/833b94554d2bed2067509f8ae191b68b3f83f5c6fb1550de0943b0363afe9b0b-Group_427323189.png" />

### Custom Status Codes

8. You can also specify **custom status codes**.

<Note>
  * Sometimes, websites return the required content together with a non-standard `HTTPS` status code.
  * If one of your targets does that, you can indicate which status codes are acceptable and valuable to you: `501, 502`, `503` and etc.
  * Learn more [**here**](https://help.decodo.com/docs/site-unblocker-custom-status-codes/).
</Note>

<img src="https://mintcdn.com/decodo/eRLuBYAbadfvmqDE/images/docs/18031d3de7190e2082a2cb312cbb448baec33596b4a51b20c32ae46be9252b36-Group_427323191.png?fit=max&auto=format&n=eRLuBYAbadfvmqDE&q=85&s=6ee28f9ec6b0594cd4abc8c756ad3710" className="mx-auto" style={{ width:"46%" }} width="1600" height="380" data-path="images/docs/18031d3de7190e2082a2cb312cbb448baec33596b4a51b20c32ae46be9252b36-Group_427323191.png" />

### Custom Cookies

9. Specify **custom cookies**.

<Note>
  * You can also **force cookies**. But note that when forcing headers or cookies, the request will always be charged to your subscription, even if the request fails.
  * Learn more [**here**](https://help.decodo.com/docs/site-unblocker-headers#cookies).
</Note>

<img src="https://mintcdn.com/decodo/eRLuBYAbadfvmqDE/images/docs/23e1d92d3d187d8355b8027ec7ea3d13cce7c9a4f499b05a2d0a32ee1579df4f-Group_427323193.png?fit=max&auto=format&n=eRLuBYAbadfvmqDE&q=85&s=a0f836741e5deb23422260b3fdc8e836" className="mx-auto" style={{ width:"46%" }} width="1600" height="444" data-path="images/docs/23e1d92d3d187d8355b8027ec7ea3d13cce7c9a4f499b05a2d0a32ee1579df4f-Group_427323193.png" />

### Request Body

10. Finally, specify the **Request Body** values.

<Note>
  * `POST` request body, example: `{"key1": "value1", "key2": "value2"}`, `{"key3: "value3"}`.
</Note>

### Markdown

11. Check the toggle to automatically parse `HTML` content into `Markdown`.

<Note>
  * `Markdown` reduces token count compared to raw `html`.
  * Learn more [**here**](https://help.decodo.com/docs/site-unblocker-markdown/).
</Note>

### Sending a Request

12. Once you're all set, press **Send Request**. After a few moments, you'll see the returned response and live preview.

<Note>
  1) If you select the **Request tab**, you may also copy the `cURL` command by clicking **Copy request**.
  2) You can **copy** the response or **download** it in `HTML`.
</Note>

<img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/fb967fff2dce4c54ac89c3e912c59023f80fa52f0b388a9ff73cb04242442646-Group_427323194.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=61c604b348b8481b6d8ecd8b96dc06e8" className="mx-auto" style={{ width:"46%" }} width="1600" height="1236" data-path="images/docs/fb967fff2dce4c54ac89c3e912c59023f80fa52f0b388a9ff73cb04242442646-Group_427323194.png" />

<img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/b490308538abc4ecccde3b2d14e5b725b97eeeef071f8de45b013c41e8115760-Group_427323196.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=f178c573611e32319cfd553074a29f1c" className="mx-auto" style={{ width:"46%" }} width="1600" height="1236" data-path="images/docs/b490308538abc4ecccde3b2d14e5b725b97eeeef071f8de45b013c41e8115760-Group_427323196.png" />

## Usage Statistics

To track your traffic usage, go to the **Usage Statistics** tab.

### Graph

Here, you can see various statistics displayed in a graph:

<Note>
  1. The number of **requests** you've sent (total successful requests, failed requests, and success rate).
  2. The **average response time**.
  3. The **traffic used**
  4. The number of **`JavaScript`renders**
  5. Choose the **time period**.
  6. **Filter** by target.
  7. **Group** by hour, day, week, or month.
  8. **Export** the table data in `.CSV`, `.TXT`, or `.JSON` formats.
</Note>

<img src="https://mintcdn.com/decodo/7ZKpc3GV1DKO_XQr/images/docs/0d92ea5df0001f39bf22669eb11018ce41a8a674d277e2dca5f1b09b38bae803-Group_427323197.png?fit=max&auto=format&n=7ZKpc3GV1DKO_XQr&q=85&s=f6776f4f2c2647a46d07249441abce5c" className="mx-auto" width="3448" height="2244" data-path="images/docs/0d92ea5df0001f39bf22669eb11018ce41a8a674d277e2dca5f1b09b38bae803-Group_427323197.png" />

### Top Targets

At the bottom of the page, you can see more detailed information about each **target**:

<Note>
  1. The **target**.
  2. The **number of requests**.
  3. **Traffic**
  4. **Success rate**.
  5. **Average response time**
  6. **Spend** in `$` (Amounts displayed are without **VAT**)
</Note>

<img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/624386601aa7cfe7db05071b3b610fe8ddb43d7353704bdf4742817361c69dfc-Group_427323198.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=16e852e6c26e2ead102a8786db04e521" className="mx-auto" width="3448" height="448" data-path="images/docs/624386601aa7cfe7db05071b3b610fe8ddb43d7353704bdf4742817361c69dfc-Group_427323198.png" />

***

<Note>
  ### Statistics Via Requests

  * Learn more about `URL` parameters for statistics [**here**](https://help.decodo.com/docs/site-unblocker-statistics/).
</Note>

## Troubleshooting

If you are having any issues, check out our [**troubleshooting**](https://help.decodo.com/docs/site-unblocker-troubleshooting/) section or reach out directly to our support team available 24/7.

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>