Create a New Sticky Session

Our residential proxy service offers a feature that allows you to set and control sticky sessions by adding a custom Session ID via the username in your curl commands. This means that you can now hold multiple sticky sessions on the same port, whereas previously one port equaled one session.

By using username

Request

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

Parameters

  • Name
    username
    Type
    string
    Description

    Your API username.

  • Name
    password
    Type
    string
    Description

    Your API password.

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

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

  • Name
    port
    Type
    integer
    Description

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

Expected Response

{
  "status": "success",
  "country": "Mexico",
  "countryCode": "MX",
  "region": "JAL",
  "regionName": "Jalisco",
  "city": "Zapopan",
  "zip": "45138",
  "lat": 20.7495,
  "lon": -103.4651,
  "timezone": "America/Mexico_City",
  "isp": "Total Play Telecomunicaciones SA De CV",
  "org": "Total Play Telecomunicaciones SA De CV",
  "as": "AS17072 TOTAL PLAY TELECOMUNICACIONES SA DE CV",
  "query": "189.203.103.225"
}

By adding a custom Session ID

Request

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

Parameters

  • Name
    username
    Type
    string
    Description

    (Required) Your API username.

  • Name
    custom-session-id
    Type
    integer
    Description

    (Required) The custom session id of your choice.

  • Name
    password
    Type
    string
    Description

    (Required) Your API password.

  • 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
    port
    Type
    integer
    Description

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

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"
}