Specifying Session Lifetime

Specifying a custom session lifetime allows you to control the duration of your sticky sessions, ensuring that they remain active for only as long as you need them. This can help you optimize your usage of the proxy service, reducing wasted resources and improving performance.

To customize the lifetime for each request, you can use the following cURL command and append the parameter "lifetime-<lifetime>" to the username:

Request

GET
curl -x <username>-lifetime-<lifetime>:<password>@<service-name>.geonode.com:<port> http://ip-api.com/json

Parameters

  • Name
    service-name
    Type
    pay-as-you-go-residential
    Description

    (Required) The service name. Currently the only option is pay-as-you-go-residential.

  • Name
    lifetime
    Type
    integer
    Description

    The custom lifetime of your choice in minutes. The limits are 3 and 60.

  • Name
    port
    Type
    integer
    Description

    The target port number. 9***'s for rotating and 10***'s for sticky proxies.

Authentication (Basic Auth)

  • Name
    username
    Type
    string
    Description

    (Required) Your API username.

  • Name
    password
    Type
    string
    Description

    (Required) Your API password.

Expected Response

{
  "status": "success",
  "country": "United States",
  "countryCode": "US",
  "region": "NV",
  "regionName": "Nevada",
  "city": "Las Vegas",
  "zip": "89178",
  "lat": 35.9937,
  "lon": -115.2867,
  "timezone": "America/Los_Angeles",
  "isp": "Cox Communications Inc.",
  "org": "Cox Communications",
  "as": "AS22773 Cox Communications Inc.",
  "query": "68.224.236.135"
}