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 is performed from a random IP:

curl -x -U "customer-USERNAME:PASSWORD"

Replace USERNAME and PASSWORD with your actual proxy user credentials.

Utilizing the Backconnect Proxy for Geo-specific Requests

With HomeIP's backconnect proxy (, 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


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


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


4. Implementing Session Control


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

Query parameters





Case insensitive country code in 2-letter 3166-1 alpha-2 format. For example, DE for Germany, GB for the United Kingdom, TH for Thailand.


Case insensitive city name in English. This parameter must be accompanied bycountry and state for better accuracy, for example, country=uk+state=england+city=london for London, United Kingdom.


Case insensitive US state name with us_ in the beginning, for example, country=us+state=texas.


Session ID to keep the same IP with upcoming queries. The session expires in 10 minutes. After that, a new IP address is assigned to that session ID. Random string, 0-9, and A-Z characters are supported.


The session time parameter keeps the same IP for a certain period. The maximum session time is 30 minutes.



Last updated