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

# How to Use Oculus Proxies With Superagent

> Enhance your Node.js scraping workflows by integrating Oculus Proxies with Superagent for seamless, location-distributed requests and rate-limit protection.

## What is Superagent?

**Superagent** is a lightweight HTTP request library for Node.js. It is highly extensible through a plugin system, allowing it to handle complex tasks like proxy authentication or retries while maintaining a cleaner, more readable syntax than older libraries like `request`. Using **Oculus proxies** allows you to mimic requests coming from different locations, preventing rate-limiting on your main IP.

<Tip>
  If you're using **Oculus** to scrape search engines like **Google, Bing, or Yandex** and facing connection issues, your proxy type may need adjustment. **ISP Premium Proxies** provide stable and unrestricted access, preventing blocks that standard proxies may encounter. Switching to **ISP Premium Proxies** can improve performance.
</Tip>

## How to Use Oculus Proxies With Superagent

<Steps>
  <Step title="Install package">
    Install via cmd:

    ```
    npm install superagent superagent-proxy
    ```
  </Step>

  <Step title="Example code">
    Use the following code as an example for Superagent. Make sure to replace `proxyUri` with the correct proxy credentials from your [dashboard](https://oculusproxies.com/dashboard/).

    ```javascript theme={null}
    const superagent = require('superagent');
    require('superagent-proxy')(superagent); 

    const proxyUri = 'http://USERNAME:PASSWORD@proxy.oculus-proxy.com:PORT';

    superagent
    .get('http://httpbin.org/ip')
    .proxy(proxyUri)
    .end((err, res) => {
    if (err) return console.error(err);
    console.log('IP via Superagent:', res.text);
    });
    ```
  </Step>
</Steps>
