Making Requests

Basic Query

A basic query is simple and straightforward. All you need to provide are your username and password. No additional parameters are necessary. When you execute this query, the request will be routed through a random IP address (proxy). Each subsequent request will automatically rotate and use a different proxy for a fresh connection.

In this example, a query to ip.homeip.io is performed from a random IP:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" http://ip.homeip.io

Replace USERNAME and PASSWORD with your actual proxy user credentials.

Utilizing the Backconnect Proxy for Geo-specific Requests

With HomeIP's backconnect proxy (pr.homeip.io:7777), you have the flexibility to tailor your requests based on geographic location, down to the specific country or city. This is achieved by simply adding specific parameters to your username. Additionally, this method seamlessly integrates session control to maintain the same proxy for multiple requests.

Sample Credentials

To illustrate, here's how you'd structure your credentials:

1. Basic Connection

username=USERNAME:PASSWORD

2. Targeting a Specific Country (e.g., France)

username=USERNAME+country=fr:PASSWORD

3. Targeting a Specific City (e.g., London, UK)

username=USERNAME+country=uk+state=england+city=london:PASSWORD

4. Implementing Session Control

username=USERNAME+session=YourUniqueSessionID:PASSWORD

Replace 'YourUniqueSessionID' with a unique identifier for session consistency.

Query parameters

Last updated