Session Control

With HomeIP, it's easy to maintain a consistent IP address across multiple requests. This can be particularly useful when you need continuity in your tasks.

To achieve this, use the session parameter. Simply add it after your username and pair it with a unique alphanumeric string that you generate.

Example: To maintain a consistent IP address, your authorization might look like this: username=USERNAME+session=12345. Every request with this specific session ID will use the same IP.

Remember, you can replace 12345 with any random alphanumeric combination to create a new session.

By default, when you establish a session using HomeIP, it remains active for 10 minutes. However, if there's no activity for 60 seconds (i.e., no new requests), the session will expire, and a new IP address will be automatically assigned for subsequent requests.

Let's say you initiate a query using the session ID session=12345. HomeIP assigns the IP address 1.1.1.1 to this session. As you continue sending requests with the same session ID (provided that the IP remains online), all your requests will route through 1.1.1.1.

However, if you pause and don't send any requests for over 60 seconds or if 1.1.1.1 goes offline, HomeIP will provide a new proxy IP for your next request. So, a subsequent query using session=12345 might then route through, say, 1.1.1.2.

Credentials list example:

Example represents a list of credentials that establish different sessions.

username=USERNAME+session=12345:PASSWORD
username=USERNAME+session=12346:PASSWORD
username=USERNAME+session=12347:PASSWORD
username=USERNAME+session=12348:PASSWORD
username=USERNAME+session=12349:PASSWORD

Code example

In this example we are using German IP with session=12345 in the username with the first request. All following requests will keep the same German IP with further queries:

curl -x pr.oxylabs.io:7777 -U "username=USERNAME+country=de+session=12345:PASSWORD" http://ip.homeip.io

Rotation time

In HomeIP, the rotation parameter is used in conjunction with session to give users control over the duration of their session. By default, a session remains active for 10 minutes, but with session, you can customize this duration, ranging from 1 minute to a maximum of 30 minutes.

Important Note: Setting a session time doesn't guarantee completion of all your queries within that window. The session will expire once the set time elapses, regardless of pending queries.

Sample Credentials:

Here's an illustration of how you can format your credentials to establish different sessions with varied durations:

  • For a 5-minute session: username=USERNAME+session=12345+rotation=300:PASSWORD

  • For a 12-minute session: username=USERNAME+session=12346+rotation=720:PASSWORD

  • For the maximum 30-minute session: username=USERNAME+session=12347+rotation=1800:PASSWORD

  • For a 6-minute session: username=USERNAME+session=12347+rotation=360:PASSWORD

  • For a 16-minute session: username=USERNAME+session=12348+rotation=960:PASSWORD

Code example

We chose the same German IP as in the previous example, this time we are adding sessionstring and rotation parameter for 7 minutes:

curl -x pr.oxylabs.io:7777 -U "username=USERNAME+country=DE+session=abcde12345+rotation=420:PASSWORD" http://ip.homeip.io

Last updated