In this section, we provide concise yet comprehensive guidance on navigating and utilizing the dashboard features. This section includes various subsections, each focused on different aspects of the dashboard, from setting up and managing proxies to understanding metrics and adjusting settings. Whether you're a novice or an experienced user, you'll find straightforward instructions to optimize your use of our services through the dashboard.

The Domain Filtering (previously Allowances) feature is split into two sections:

• Restrictions section that enables you to list domains our proxies will not access

• Permissions section that enables you to create a whitelist of accessible domains

For further information on how to create and manage these lists, please refer to the 'Domain Filtering' (previously ‘Allowances’) subsection located within the ‘Dashboard’ section of our documentation.

Welcome to IPRoyal documentation. These documents provide everything you need to get started using our services. If something is missing or you want to share feedback, please contact us at or via chat on our .

Useful Links

Our offers answers to the most frequently asked questions about our services, billing, account settings, and more.

Our offers proxy-related news, product updates, integration tutorials, web scraping guides, code examples, and expert insights.

We also offer several free tools to make your proxy usage more convenient. These include , a Windows-based , and an page.

In the orders section, outlined by the orange dotted border in the image, you can track and manage your orders. This part of the dashboard presents a table listing all your transactions, including order ID, any associated notes, order date, the amount paid, the amount of traffic available before the order, and the current status of each order. You can search for specific orders using a note or ID, filter the entries displayed per page, and filter by order status. For each listed order, there are options to view detailed information. You also have the option to download the invoice for all confirmed orders. This feature is designed to give you a clear and organized view of your past activity and assist in managing your purchases effectively.

Before continuing, we recommend visiting our 'Proxy' documentation to understand how it works and the meaning of the inputs in the panel.

This is your proxy access configuration panel, where you can customize the settings for your proxy usage. The panel offers a variety of inputs for detailed configuration. Each setting allows you to tailor the proxy behavior to your exact requirements, such as selecting the country, state/region, ISP, and type, as well as defining rotation preferences.

Further down, you will find the formatted proxy list section. This area displays your proxies in a ready-to-use format, complete with all necessary details for each proxy connection. You have the convenient option to 'Copy' the list to your clipboard or 'Download list' for offline use. You can also select the format that best fits your needs and specify the quantity of proxies you wish to view or export. This streamlined approach ensures quick and easy access to your proxy information for immediate use.

When configuring your proxy, it's important to consider the protocol that best suits your needs. There are two primary types available: HTTP/HTTPS and SOCKS5. Each protocol operates on its distinct set of ports and serves different purposes. We offer two primary types of proxy protocols.

Our system's sub-user feature is a powerful tool designed to enable our users to become resellers, thereby opening up new business opportunities. By leveraging this feature, users are empowered to create and manage numerous sub-users, essentially setting up a network that can be offered to other parties. This feature not only facilitates the expansion of our users' service offerings but also allows them to establish and grow their own businesses. It's a seamless way for users to scale operations, diversify their business models, and explore new revenue streams by reselling access to sub-users.

Users can easily manage their sub-users directly through our streamlined dashboard. This allows for quick adjustments and oversight of sub-user activities, ensuring the smooth operation of their reseller functions.

URL

https://resi-api.iproyal.com/v1

Authorization

Authentication is managed via the Authorization header. To ensure secure access, all requests must include this header, followed by your API token, prefixed with the word "Bearer" and a space. The format should be:

Authorization:Bearer <your_api_token>

Your API token is available on the dashboard's Settings page in the 'API' section. Here, you can also reset your token if necessary. Keep it secure and update your applications with the new token if you reset it.

In this part of the guide, we offer clear and thorough instructions for mastering the dashboard's functionalities. This guide is designed to be user-friendly, ensuring that both beginners and seasoned users can efficiently maximize the benefits of our services using the dashboard.

Base URL

https://apid.iproyal.com/v1/reseller

Authorization

To authorize your API calls, we validate the X-Access-Token header. You can find and reset this token on the dashboard's Settings page in the 'API' section.

Base URL

https://apid.iproyal.com/v1/reseller

Authorization

To authorize your API calls, we validate the X-Access-Token header. You can find and reset this token on the dashboard's Settings page in the 'API' section.

In this part of the guide, we offer clear and thorough instructions for mastering the dashboard's functionalities. This guide is designed to be user-friendly, ensuring that both beginners and seasoned users can efficiently maximize the benefits of our services using the dashboard.

Whether you're looking to automate account maintenance or tailor your proxy settings for specific tasks, the 'Configuration' section offers detailed information on how to customize and manage various settings to enhance your proxy experience. This section is divided into several key subsections, each dedicated to a specific configuration area. These include setting up automatic top-ups to ensure uninterrupted service, accessing proxies effectively, and utilizing advanced features like IP Whitelisting and IP Skipping for refined control over your proxy connections.

In this section, we’ll walk you through the steps for managing domains accessible via our proxies. We recommend reviewing our 'Domain Filtering (previously ‘Allowances’) documentation beforehand to familiarize yourself with the concept.

Navigate to the ‘Residential’ section on the sidebar menu (1), which brings you to the main dashboard for Residential Proxies.

From there, find the 'Domain Filtering' (previously ‘Allowances’) (2) button. Clicking this button enables you to manage and edit domain blocklist and whitelist settings, where you can specify which domains will be accessible via our proxies.

The ‘Restrictions’ (1) section enables you to create a list of domains our proxies will not access. All you need is to provide a URL in the designated field (2) and click the ‘Add’ (3) button. You can modify the list of blocked domains by clicking the ‘Remove’ (4) button next to the entry you want to remove.

Alternatively, you can use the ‘Permissions’ (1) section to create a list of domains that our proxies can access. All you need is to provide a URL in the designated field (2) and click the ‘Add’ button (3). You can modify the list of whitelisted domains by clicking the ‘Remove’ (4) button next to the entry you want to remove.

Note: As long as you have a single domain in your allowed sites list, all other domains will not be accessible via our proxies.

Our Residential Proxies are available in two payment plans - pay-as-you-go and subscription. The subscription feature offers a simple and efficient way for our users to ensure a steady supply of traffic without the hassle of reordering. This option also comes with an exclusive 5% discount.

In this section, we’ll walk you through the steps for managing a subscription.

— Navigate to the 'Residential' (1) section on the sidebar menu, which brings you to the main dashboard for Residential Proxies.

From there, find the 'Subscription' (2) banner to see the current status of your subscription.

If your subscription is active, you will see its details - status (1), next payment date (2), amount of traffic you subscribed to (3), and the price (4). Can click the 'Manage subscription' (5) button to get more information.

On this page, you have several options. You can change your payment method (1), upgrade (2) or cancel (3) your subscription, and get an overview of your subscription history (4).

Clicking the 'Upgrade plan' (1) button will take you to the order placement page.

You will see the pricing and available discounts (1), where you can choose a subscription upgrade, as well as your current subscription details and pricing (2). Add the number of GB (3) you want to add to your subscription, and you’ll see the updated pricing (4). Click the 'Continue' (5) button.

Select the payment method (1) and click the 'Complete order' (2) button.

Clicking the 'Cancel plan' (1) button will bring up a confirmation prompt. Click the 'Yes, cancel' (2) button to cancel your subscription or the 'Not now' (3) button to go back.

If your subscription isn’t activated, you can click the 'Reactivate' (1) button to reactivate it without changing any settings.

Select the payment method (1) and click the 'Complete order' (2) button.

If your subscription is active, you also have the option to add extra traffic without changing the plan. The amount of traffic you can add this way equals your current subscription. To do this, click the 'Quick top-up' button (1).

Select the payment method (1) and click the 'Complete order' (2) button.

There is an option to extend your order, a useful feature as it ensures you keep the IPs you've been provided. There are two methods for extending:

• A manual extension where you can go to the orders dashboard and simply click 'Extend';

• A subscription. Enabling this option will let you virtually forget about manual extensions, as it automatically renews the order each time it nears expiration.

When extending your order, you also have the option to change your plan. For instance, if you initially had a 90-day plan but only need the proxies for one more day or an additional month, you can adjust the duration accordingly during the extension process. The same option is available with a subscription.

Additionally, you can select the IP addresses you want to extend or subscribe to. This option is useful if you want to downsize your order but still keep specific IPs.

Manual Extension

Navigate to the 'ISP' section (1) via the sidebar menu.

Once you locate your order, click 'Extend' (2) to proceed.

In this section, you have the flexibility to select a new plan or continue with the current one (1), while also choosing specific IPs you want to extend (2). Additionally, you can view the 'Expire Date' to determine when the plan is set to expire. Once you’re satisfied with your choices, click 'Continue' (3).

Following this, you will be directed to a familiar page where you can proceed with the extension process and complete the payment for the extension.

Subscription

To enable subscriptions, please navigate to the 'Order details' section (1) on the ‘Order Configuration’ page.

On this page, you will find a panel that allows you to enable a subscription (2) for this order. You can modify the plan (3) and extend specific proxies (4). Once you’re satisfied with your choices, select your preferred payment method (5) and click ‘Save’ (6) to enable a subscription.

It’s important to note that certain domains will not be accessible via Residential Proxies. The requirements to access them are as follows:

The following domains become available after you confirm your identity on IPRoyal:

• Login.yahoo.com

• Login.live.com

• Linkedin.com

• All Ticketswap websites

• Banks in this.

The following domains become available after you confirm your identity and spend over $500 on IPRoyal:

• All .gov websites

• PlayStation websites.

The following domains will remain inaccessible even when you meet these conditions:

• Secure.gsb-yourbank.com

• Digital.iberiabank.com

• Wyndlabs.ai (sharing in grass.io is not allowed)

To access these domains, you need to contact our support team via email or live chat.

In this section of the dashboard, you have the convenience of setting up 'Auto Top-Up' for your account. To get started, toggle the 'Enable auto top-up' switch (1).

When enabled, this feature allows your account to automatically add more GB to your available traffic when it reaches a predetermined level, ensuring uninterrupted service.

You can choose your payment method (1), set the threshold at which the top-up should occur under 'When to add' (2), and specify the amount of GB to be added automatically under 'Amount to add' (3). There's also a field that displays your current balance for clarity, and the option to apply a coupon if you have one (4). Once you have configured your settings, simply click 'Save' (5) to activate the auto top-up feature.

In the 'Mobile Proxies' dashboard, the 'Orders' panel provides a comprehensive view of all your orders, encompassing active, expired, and unpaid ones. This panel is equipped with advanced filtering options, allowing you to sort and view orders based on a variety of criteria beyond just their status. These filters facilitate efficient management and quick access to specific orders. Each order entry includes convenient features to view its details, download an invoice, or extend its duration.

To improve connectivity and reliability when accessing our Residential Proxies from China (or nearby regions), we provide a set of alternative regional entry domains.

These domains function exactly like our standard proxy gateway, but may offer better stability, lower latency, and fewer connection issues for specific geographies.

In this section, we'll walk you through the steps for managing IP skipping lists. We recommend reviewing our 'IP Skipping' documentation beforehand to familiarize yourself with the concept.

Navigate to the 'Residential' section on the sidebar menu (1), which brings you to the main dashboard for Residential Proxies.

From there, find the 'IP skipping' (2) button. Clicking this button enables you to manage and edit your IP skipping settings, where you can specify and manage IP skipping entries.

To begin configuring your order, you first need to access its details page.

First, navigate to the 'ISP' section (1) via the sidebar menu.

Once you locate your order, click on 'Details' (2) to proceed.

Upon entering this page, you will first encounter the 'Proxy details' and 'Order details' toggle (

In this section, we will delve into the creation and configuration of a proxy string. We'll cover how to target specific locations, apply rotation settings, select the appropriate protocol, and more. Additionally, we will demonstrate how to make a request using a proxy.

To begin, it's important to understand that a proxy string comprises four elements: host, port, username, and password. While there are multiple methods to combine these four elements, for the sake of simplicity, we will adopt the format: HOST:PORT:USERNAME:PASSWORD.

Residential proxies utilize the password segment of the string to configure the aforementioned settings. For instance, consider the following proxy string designed to target the state of California in the USA:

As mentioned earlier, the string has four main sections (highlighted in blue), and the last one is labeled 'Password.' This section holds all the configuration details for the proxy.

In the preceding sections, we discussed various configurations that can be applied to a proxy via the proxy string. IP Whitelisting is a feature that streamlines this process by allowing you to preserve your proxy configuration string and link it to a specific IP address. Essentially, this feature enables you to establish a preset configuration and associate it with an IP. Consequently, this eliminates the need for authentication credentials, permitting a direct connection to the proxy using just the HOST:PORT format. This method enhances ease of access while maintaining the security and specificity of your proxy settings.

What Are the Benefits of IP Whitelisting

Whitelisting IPs offers several advantages over the more common username/password authentication.

In the 'Datacenter Proxies' dashboard, the 'Orders' panel provides a comprehensive view of all your orders, encompassing active, expired, and unpaid ones. This panel is equipped with advanced filtering options, allowing you to sort and view orders based on a variety of criteria beyond just their status. These filters facilitate efficient management and quick access to specific orders. Each order entry includes convenient features to view its details, download an invoice, or extend its duration.

To begin configuring your order, you first need to access its details page.

First, navigate to the 'Datacenter' section (1) via the sidebar menu.

Once you locate your order, click on 'Details' (2) to proceed.

Upon entering this page, you will first encounter the 'Proxy details' and 'Order details' toggle (

In this section, we'll walk you through the steps for managing IP whitelists. We recommend reviewing our 'IP Whitelisting' documentation beforehand to familiarize yourself with the concept.

Navigate to the 'Residential' section on the sidebar menu (1), which brings you to the main dashboard for Residential Proxies.

From there, find the 'Whitelist' (2) button. Clicking this button enables you to manage and edit your whitelist settings, where you can specify and manage whitelist entries.

On the configuration page, select the 'Add' option.

Configure your proxy (1). For more information about configuration and input meanings, head to the 'Proxy' section.

To begin configuring your order, you first need to access its details page.

First, navigate to the 'Mobile' section (1) via the sidebar menu.

Once you locate your order, click on 'Details' (2) to proceed.

In the 'ISP proxies' dashboard, the 'Orders' panel provides a comprehensive view of all your orders, encompassing active, expired, and unpaid ones. This panel is equipped with advanced filtering options, allowing you to sort and view orders based on a variety of criteria beyond just their status. These filters facilitate efficient management and quick access to specific orders. Each order entry includes convenient features to view its details, download an invoice, or extend its duration.

In the 'Statistics' section of your Residential Proxies dashboard, you have the ability to monitor and analyze your proxy usage over time. This interactive graph, outlined by the orange dotted border in the image, provides a visual representation of your proxy traffic, which you can further adjust by selecting a specific time period. This can help you understand peak usage times or identify trends. Additionally, you have the option to filter the data by specific websites and choose the units of measurement (such as MB or GB).

For a more detailed review or record-keeping purposes, you can download the report by clicking the 'Download report' button. This tool is essential for managing your proxies effectively and ensuring that your usage aligns with your needs and expectations.

A is an advanced, AI-powered solution built to reliably access and extract public web data – even from sites protected by geo-restrictions, CAPTCHAs, Cloudflare protections, and other anti-bot systems. Unlike , a Web Unblocker automates the entire unblocking process, from smart IP selection to automatic retries, eliminating common scraping obstacles.

The user management feature makes team collaboration easier than ever. As an IPRoyal account owner, you have the ability to create sub-accounts, granting your team members access to the IPRoyal dashboard. This approach improves security, control, and efficiency, making it simple to delegate tasks while still having full oversight of all activities on your account.

Sub-account users can:

• Configure and use proxies

• Use a unique API token

URL

https://resi-api.iproyal.com/v1/web-unblocker

Authorization

Base URL

https://apid.iproyal.com/v1/reseller

Authorization

In this part of the guide, we offer clear and thorough instructions for mastering the dashboard's functionalities. This guide is designed to be user-friendly, ensuring that both beginners and seasoned users can efficiently maximize the benefits of our services using the dashboard.

Here are the most common errors faced by our clients.

Mobile proxy doesn’t react to IP rotation request instantly.

Due to the specifics of our hardware and varying cell tower traffic in the US, there may be times when a carrier does not immediately assign a new IP address upon request. In some cases, this process could take up to 30 minutes, and the duration can vary depending on the time of day. Control over the IP pool lies with the ISP, so the frequency of new IP allocation is determined by their policies. For those seeking immediate rotation of US proxies, we advise acquiring additional ports. This allows you to switch proxies within your system whenever a new IP is desired. After switching, you can then request a new IP for the proxy that was previously replaced. If the rotation process encounters a complete stall, our systems are designed to automatically detect and resolve the issue, ensuring you won’t need to take any action.

Sometimes mobile proxy rotates by itself.

Proxies that are under ISP’s have their own Rotation per day as constituted by CGNAT Process. The IP you are getting in every rotation you made on the proxy are coming from the ISP itself. For the IP changing more frequently than expected it is due to ISP’s own rotation which we don’t have a control for its own rotation interval.

Mobile proxy is unstable or down.

If you encounter a non-functional proxy, there’s no need for immediate action on your part. Our system is equipped to identify such issues, and our support team is automatically engaged to work on a resolution. However, there may be instances where the system does not detect unstable proxies. In such cases, we advise you to report the proxy through the report button on your dashboard. Our support team will address and resolve the issue within 20 minutes.

In rare cases, IP appears from State.

It’s completely normal for mobile proxy IPs to be located around the location proxy is operating in. Even cases when ISP give IP from other side of a country is acceptable and no web service will raise any red flag for that. Regular users using mobile phones in the city experience same IP location placements. We do not have control over IPs of proxy, they come straight from ISP.

Abusing, using too much traffic or connections.

Our “unlimited” mobile proxy service is designed to cater to a wide range of needs with flexibility and reliability. However, the term “unlimited” comes with the responsibility of fair usage to ensure all our clients enjoy a consistent and quality experience. Excessive data usage poses a risk of our SIM cards being temporarily restricted or permanently banned by our carriers due to their fair usage policies. To mitigate this risk and maintain the high-quality service expected by all our clients, we kindly ask you to consider lowering your data usage or splitting your traffic across multiple proxies. This approach not only adheres to fair usage guidelines but also helps in ensuring your activities can continue without interruption.

IP Rotation and Skipping

Web Unblocker automatically chooses the most effective IP address for each request and skips problematic ones to avoid bans.

Automatic Retries

Web Unblocker retries failed requests with new IPs automatically. Please note we currently allow up to 200 active connections at the same time, so if a site takes longer to unblock, the effective request rate may decrease accordingly.

Geo-Location Targeting

Geo-location can be set manually at country, city and state level.

JavaScript Rendering

Web Unblocker offers on-demand JavaScript rendering using a special flag.

Custom Headers

Web Unblocker supports the use of custom HTTP headers, allowing you to tailor requests for specific use cases.

IPRoyal currently offers over over 32 million Residential Proxies in over 195 countries. This number is constantly growing, so our clients can rely on fresh proxies for all sorts of tasks.

Key Advantages of IPRoyal Residential Proxies

• Highly competitive pricing

We offer some of the lowest prices in the industry with advanced features, high reliability, and .

• Exclusive proxy pool

With over 32 million ethically-sourced residential IPs in over 195 countries, we guarantee efficient web scraping, SEO research, data aggregation, social media management, and more.

• Precise targeting

Choose proxies from any part of the world (country, state, or city) with a single click and no extra cost.

• Pay-as-you-go option

No contracts, no wasted bandwidth, and no monthly limits - you only pay for what you need.

• No data expiration

Once you purchase your residential proxy traffic - it’s yours forever. It never expires, so you can use it whenever you want.

• 24/7 support

With an average response time of just 58 seconds, our skilled team of experts is available around the clock and ready to help you set up and make the most of your proxies.

Technical Features of IPRoyal Residential Proxies

• Advanced session control

Get a new IP on each request or use a sticky session of up to 7 days.

• Unlimited simultaneous sessions

No limits and restrictions - use as many connections and scale your operations as needed.

• Dual authentication

Username/password and IP whitelisting available for the highest compatibility with scrapers, bots, and other tools.

• HTTP(S) and SOCKS5 support

Choose the protocol that suits your needs to get the best results with any usage case.

• API access

Integrate our residential proxies into your infrastructure, manage sub-users, and more.

In this section, we'll walk you through the steps for managing sub-users. We recommend reading our 'Sub-Users' introduction beforehand to familiarize yourself with the concept.

Navigate to the 'Residential' section on the sidebar menu (1), which brings you to the main dashboard for Residential Proxies.

From there, find the 'Sub-Users' (2) button. Clicking on this button will bring you to the sub-users dashboard.

If you haven't created any sub-users yet, you will initially see a brief introduction. By clicking the 'Sub-Users Dashboard' button, you will be directed to the panel where you can create your first sub-user.

The 'Create Sub-User' page features three input fields.

The first is for the sub-user's username (1), which is used to connect to the proxy.

The second field is for setting the password (2).

And the third is 'Assign Traffic' (3). The number entered in this field is the amount of traffic (in GB) that will be deducted from your (the main user's) account and allocated to the sub-user.

After filling out these inputs, click the 'Create' (4) button to finalize the creation of your sub-user.

Congratulations on creating your first sub-user. The image below illustrates the interface you'll encounter following the creation.

It includes:

• a button for adding additional sub-users (1);

• a display panel indicating your main user’s remaining traffic (2);

• a table listing all sub-users with a search feature for easy navigation (3).

Equally crucial are the management buttons (4) adjacent to each sub-user entry, which provide options to create whitelists and generate proxies for them.

At IPRoyal, we offer a wide selection of ISP Proxies across multiple countries, so our clients have access to a variety of options. We also update our proxy network regularly to ensure our clients can always rely on new proxies for all their tasks.

Key Advantages of IPRoyal ISP Proxies

• Highly competitive pricing

We offer discounts on the number of purchased proxies, along with additional discounts for longer periods (5% off with the 60-day plan and 10% off with the 90-day plan) advanced features, high reliability, and .

• Excellent location coverage

Our proxies are available in many countries on four continents. We’re also constantly adding new locations. If you need a location we don’t offer, contact our support team and we’ll consider adding it.

• Premium ISP providers

Regardless of the location you choose, you can rest assured that each IP comes from a premium local internet service provider. We guarantee each IP is 100% residential.

• High speeds

With speeds of up to 100Mbps and zero bandwidth limits, we offer a reliable solution even for the most bandwidth-intensive tasks.

• HTTPS & SOCKS5 compatible

Choose the protocol that suits your needs to get the best results with any usage case.

• 24/7 support

With an average response time of just 58 seconds, our skilled team of experts is available around the clock and ready to help you set up and make the most of your proxies.

Technical Features of IPRoyal ISP Proxies

• 99.9% uptime

Consistent uptime and reliable connections around the clock enable you to access the resources you need whenever you need them.

• State and city targeting

Take advantage of unmatched precision with proxy targeting at the state and city level, empowering you to tailor your operations for specific regions.

• Dual authentication

Enhance security by managing proxy access through username and password or IP whitelisting authentication, ensuring only authorized users can connect.

• Dedicated IPs

Each ISP proxy is reserved just for you to offer ultimate online privacy and full control over your online activities.

• Unlimited traffic & sessions

Maximize your potential with zero traffic and session restrictions for complete online freedom.

• Easy integration & API support

Optimize your workflow and simplify operations with a hassle-free user experience.

There is an option to extend your order, a useful feature as it ensures you keep the IPs you've been provided. There are two methods for extending:

• A manual extension where you can go to the orders dashboard and simply click 'Extend';

• A subscription. Enabling this will let you virtually forget about manual extensions, as it automatically renews the order each time it nears expiration.

When extending your order, you also have the option to change your plan. For instance, if you initially had a 90-day plan but only need the proxies for one more day or an additional month, you can adjust the duration accordingly during the extension process. The same option is available with a subscription.

Additionally, you can select the IP addresses you want to extend or subscribe to. This option is useful if you want to downsize your order but still keep specific IPs.

Manual Extension

Navigate to the 'Datacenter' section (1) via the sidebar menu.

Once you locate your order, click on 'Extend' (2) to proceed.

In this section, you have the flexibility to select a new plan or continue with the current one (1), while also choosing specific IPs you want to extend (2). Additionally, you can view the 'Expire Date' to determine when the plan is set to expire. Once you’re satisfied with your choices, click 'Continue' (3).

Following this, you will be directed to a familiar page where you can proceed with the extension process and complete the payment for the extension.

Subscription

To enable subscriptions, please navigate to the 'Order details' section (1) on the ‘Order Configuration’ page.

On this page, you will find a panel that allows you to enable a subscription (2) for this order. You can modify the plan (3) and extend specific proxies (4). Once you’re satisfied with your choices, select your preferred payment method (5) and click ‘Save’ (6) to enable a subscription.

You can specify a country, city or a US state, from which to access your target website.

Country Targeting

You can enable country-level targeting by appending _country- to the password in your proxy credentials.

Example usage for US:

curl -k -v -x http://unblocker.iproyal.com:12323 --proxy-user user:password_country-us -L https://ipv4.icanhazip.com

The value of this parameter is a two-letter country code (ISO 3166-1 alpha-2 format).

You can set more than one country at once.

City Targeting

For city-level targeting, append the _city- key to the password in your proxy credentials. Its value should be the name of the city.

Example:

State Targeting

This feature allows state-level targeting only in US. To target a specific state, append the _state- key to the password in your proxy credentials. Its value should be the name of the state.

Example:

By default, the Web Unblocker attempts to load websites using a simple HTTP request. It checks the HTTP response code, and if the response is successful (e.g., status code 200), the body is returned to the client.

However, some websites return a 200 OK status while still serving a placeholder or error message indicating that JavaScript is disabled. In such cases, no actual page content is rendered or visible.

To handle this, the web unblocker offers on-demand JavaScript rendering using a special render flag. This instructs the unblocker to fully render the page in a headless browser before returning the response, allowing access to JavaScript-dependent content.

How to Use the render Flag

You can enable rendering by appending _render-1 to the password in your proxy credentials. For example:

Use Cases

• Accessing sites that require JavaScript to display content

• Bypassing anti-bot pages that rely on JavaScript

• Scraping modern web apps with dynamic front-ends

Notes

• Rendering may increase response times due to the overhead of launching a headless browser.

• Use rendering only when needed, as most sites can still be accessed with basic HTTP requests.

When activated, the 'High-End Pool' option grants you access to the swiftest and most reliable proxies in our selection. Please be aware, however, that the trade-off for this enhanced quality is a smaller pool of available proxies than what is typically accessible.

To enable this feature, you will need to add the _streaming- key with value 1.

Example:

The IP skipping feature enables you to compile multiple lists of IP ranges that will be automatically bypassed during the IP resolution process for your proxy connection.

To enable this feature you will need to add the _skipipslist- key, value of the key is ULID (id) of the generated list.

Example:

At IPRoyal, we offer a wide selection of across multiple countries, so our clients have access to a variety of options. We also update our proxy network regularly to ensure our clients can always rely on new proxies for all their tasks.

Key Advantages of IPRoyal Datacenter Proxies

• Highly competitive pricing

There is an option to extend your order, a useful feature as it ensures you keep the IPs you've been provided. There are two methods for extending:

• A manual extension where you can go to the orders dashboard and simply click 'Extend';

• A subscription. Enabling this will let you virtually forget about manual extensions, as it automatically renews the order each time it nears expiration.

When extending your order, you also have the option to change your plan. For instance, if you initially had a 90-day plan but only need the proxies for one more day or an additional month, you can adjust the duration accordingly during the extension process. The same option is available with a subscription.

Web Unblocker supports the use of custom HTTP headers, allowing you to tailor requests for specific use cases.

Allowed Headers (Forwarded As-Is)

These headers are allowed and passed through the unblocker unchanged:

• Cookie

In the realm of proxy sessions, we offer two distinct types of rotation: 'Sticky' and 'Randomize'. Each type serves a different purpose, catering to the varying needs of our users.

Sticky

This option allows you to maintain a consistent proxy for the duration of your session. With sticky sessions, you can configure a 'lifetime' parameter, which determines how long the same proxy will be used before it switches to a new one. This is particularly useful for tasks that require a sustained connection to the same IP address, such as maintaining a consistent session while accessing web resources that have session-based authentication or tracking.

1. The _session- key instructs our routing system to either create or resolve a unique session for the connection. The value assigned to this key must be a random alphanumeric string, precisely 8 characters in length. This ensures the uniqueness and integrity of the session.

2. The _lifetime- key directs the router regarding the duration for which the session remains valid. The minimum duration is set at 1 second, and the maximum extends to 7 days. It is crucial to note the format here: only one unit of time can be specified. This parameter plays a pivotal role in defining the operational span of a sticky session, balancing between session stability and security needs.

Examples:

Randomize

Randomize sessions provide a new proxy with each request. This means that every time you make a request, it comes from a different IP address. This approach is ideal for tasks that require a high level of anonymity and reduced traceability, such as web scraping or accessing content without revealing a consistent identity.

To use this type of rotation, you don't need to add anything to the proxy string.

Note: To reduce IP rotation and improve performance of your proxies, add the _forcerandom-1 tag to your proxy string. This will increase the pool of selected locations.

In this section, we'll show practical examples of using the proxy string we've created. We'll focus on setting up HTTP/HTTPS and SOCKS5 connections, illustrated through examples in various programming languages.

Our ISP proxies are compatible with both UDP and TCP connections.

HTTP/HTTPS

SOCKS5

IPRoyal offers a wide selection of Mobile Proxies in multiple countries, so our clients always have plenty of options for their needs. We update our mobile proxy server network regularly to ensure a constant supply of fresh and reliable IPs for all sorts of tasks. You can check the list of available countries and locations on our website.

Key Advantages of IPRoyal Mobile Proxies

• Highly competitive pricing

We offer discounts for longer periods (5% off with the 60-day plan and 10% off with the 90-day plan) advanced features, high reliability, and .

• Versatile plans

Our proxies are available in four plans - from 1 to 90 days. Being able to choose the duration makes our services more accessible to a broader range of users who don’t have to commit to large packages.

• Real mobile IPs

All our mobile proxies come from residential mobile network pools - you’re renting a physical mobile device with a 3G/4G/5G SIM card.

• 24/7 support

With an average response time of just 58 seconds, our skilled team of experts is available around the clock and ready to help you set up and make the most of your proxies.

Technical Features of IPRoyal Mobile Proxies

• Instant IP rotation

The rotation interval depends on the plan you purchased. You can rotate your IP address manually once every 6 minutes with the 1-day plan and once manually or automatically every 6 minutes with the 30, 60, and 90-day plans. If you try to do it too often, you’ll get a different notification and your IP address won’t change.

• Access to the entire IP pool

By renting a mobile proxy, you can switch between all available IPs in your chosen location for full control over your online activities.

• Unlimited traffic & sessions

Maximize your potential with zero traffic and session restrictions for complete online freedom.

• High compatibility

Manage social media accounts, gather data, perform SEO research, automate processes, and more - you can use our mobile proxies for any site.

When enabled, this option instructs our router to skip static proxies.

To enable this feature, you will need to add the _skipispstatic- key with value 1.

Example:

curl -v -x http://username123:[email protected]:12321 -L http://example.com

<?php
$username = 'username123';
$password = 'password321_country-br_skipispstatic-1';
$proxy = 'geo.iproyal.com:12321';
$url = 'http://example.com';

$ch = curl_init();

In this section, we'll show practical examples of using the proxy string we've created. We'll focus on setting up HTTP/HTTPS and SOCKS5 connections, illustrated through examples in various programming languages.

Get User information

GET /residential/me

Get information about the available traffic on the main user and subusers count

Example request:

In this section, we'll show practical examples of using the proxy string we've created. We'll focus on setting up HTTP/HTTPS and SOCKS5 connections, illustrated through examples in various programming languages.

Our Datacenter proxies are compatible with both UDP and TCP connections.

Get User information

GET /me

Get information about the available requests on the user hash.

Example request:

Generate Proxy

GET /access/generate-proxy

Rotate IP

POST /orders/4g/rotate-ip/{key}

Query Parameters

Example request:

Remove Sessions

DELETE /sessions

Body Parameters

Example request:

In this section, we'll show practical examples of using the proxy string we've created. We'll focus on setting up HTTP/HTTPS and SOCKS5 connections, illustrated through examples in various programming languages.

HTTP/HTTPS

SOCKS5

Get Products

GET /products

Returns a product list containing plans, locations, questions and quantity discounts.

Example request:

Get Products

GET /products

Returns a product list containing plans, locations, questions and quantity discounts.

Example request:

Get Balance

GET /balance

Returns the user's balance.

Example request: