1. Authorization

Every API request (except public endpoints) requires an authorization header.

Generate an API key in your dashboard and use it in the header:

authorization: key {api_key}

2. Profile

2.1 GET Balance

Returns the current account balance.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/client/balance
Authorization	✅ Required

Headers:

Header	Type	Required	Description
authorization	String	✅	key {api_key}

Response 200:

Field	Type	Description
balance	String	Current account balance

Example Request:

bash
curl -X GET https://api.gsocks.net/client/balance \
  -H "authorization: session eyJhbGciOiJIUzI1NiIsInR5cCI6..."
Example Response:
json
{
  "balance": "25.50"
}

3. Proxy

3.1 Understanding Proxy Types

Before working with the API, it is important to understand how different proxy types handle traffic:

Type (type value)	Description	Traffic Model	volume Unit
residential	Residential proxies (shared account traffic)	Shared across account	Gigabytes
dedicated-residential	Residential proxies (dedicated traffic per proxy)	Dedicated per proxy	Gigabytes
package-residential	Residential proxies tied to a package	Package-level	Gigabytes
mobile	Mobile proxies (shared account traffic)	Shared across account	Gigabytes
dedicated-mobile	Mobile proxies (dedicated traffic per proxy)	Dedicated per proxy	Gigabytes
new-datacenter	New datacenter proxies (shared account traffic)	Shared across account	Gigabytes
private	Private (individual IPv4) proxies	Unlimited traffic	Days

Key concept — shared vs. dedicated traffic:

For proxy types with shared traffic (residential, mobile, new-datacenter): you must first purchase traffic for your account using the Volume endpoints, and then create proxies that draw from that shared pool.
For proxy types with dedicated traffic (dedicated-residential, dedicated-mobile, private): traffic is allocated to each individual proxy at creation time.
For package types (package-residential): proxies are linked to a package (see the Residential Packages section).

3.2 Price Calculation

3.2.1 GET Final Proxy Price (with promo code)

Same as above, but takes into account the user's active promo code.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/final-price
Authorization	✅ Required

Query Parameters:

Field	Type	Required	Description
type	String	✅	Proxy type. Allowed values: mobile, datacenter, residential, private, dedicated-residential, package-residential
volume	Number	✅	Gigabytes (for residential/mobile/datacenter) or days (for private)
count	Number	No (default 1)	Number of proxies

Response 200:

Field	Type	Description
price	String	Final price (with discount applied)

Example Request:

bash
curl -X GET "https://api.gsocks.net/proxy/final-price?type=mobile&volume=2&count=3" \
  -H "authorization: session eyJhbGciOiJIUzI1NiIsInR5cCI6..."

4.3 Available Countries / Regions / Cities / ISPs

These endpoints let you discover available geo-targeting options before creating a proxy. The typical workflow is: Country → Region → City → ISP.

4.3.1 Private — Countries

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/private-countries
Authorization	Not required

Response 200:

Field	Type	Description
countries	Array	List of available countries for private proxies

Example:

bash
curl -X GET https://api.gsocks.net/proxy/private-countries

4.3.2 Datacenter — Countries

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/datacenter-countries
Authorization	Not required

Response 200:

Field	Type	Description
countries	Array	List of available countries for datacenter proxies

bash
curl -X GET https://api.gsocks.net/proxy/datacenter-countries

4.3.3 Residential — Countries

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-countries
Authorization	Not required

Response 200:

Field	Type	Description
countries	Array	List of available countries

bash
curl -X GET https://api.gsocks.net/proxy/residential-countries

4.3.4 Residential — Regions

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-regions
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country code or name

Response 200:

Field	Type	Description
regions	Array	List of regions

bash
curl -X GET "https://api.gsocks.net/proxy/residential-regions?country=US"

4.3.5 Residential — Cities

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-cities
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country
region	String	✅	Region

Response 200:

Field	Type	Description
cities	Array	List of cities

bash
curl -X GET "https://api.gsocks.net/proxy/residential-cities?country=US&region=California"

4.3.6 Residential — ISPs

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-isp
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country
region	String	✅	Region
city	String	✅	City

Response 200:

Field	Type	Description
isp	Array	List of internet service providers

bash
curl -X GET "https://api.gsocks.net/proxy/residential-isp?country=US&region=California&city=Los%20Angeles"

4.3.7 Dedicated Residential — Countries

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/dedicated-residential-countries
Authorization	Not required

Response 200:

Field	Type	Description
countries	Array	List of countries

bash
curl -X GET https://api.gsocks.net/proxy/dedicated-residential-countries

4.3.8 Dedicated Residential — Cities

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/dedicated-residential-cities
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country

Response 200:

Field	Type	Description
cities	Array	List of cities

bash
curl -X GET "https://api.gsocks.net/proxy/dedicated-residential-cities?country=DE"

4.3.9 Dedicated Residential — ISPs

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/dedicated-residential-isp
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country
city	String	✅	City

Response 200:

Field	Type	Description
isp	Array	List of ISPs

bash
curl -X GET "https://api.gsocks.net/proxy/dedicated-residential-isp?country=DE&city=Berlin"

4.3.10 Mobile — Countries

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/mobile-countries
Authorization	Not required

Response 200:

Field	Type	Description
countries	Array	List of countries

bash
curl -X GET https://api.gsocks.net/proxy/mobile-countries

4.3.11 Mobile — Regions

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/mobile-regions
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country

Response 200:

Field	Type	Description
regions	Array	List of regions

bash
curl -X GET "https://api.gsocks.net/proxy/mobile-regions?country=US"

4.3.12 Mobile — Cities

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/mobile-cities
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country
region	String	✅	Region

Response 200:

Field	Type	Description
cities	Array	List of cities

bash
curl -X GET "https://api.gsocks.net/proxy/mobile-cities?country=US&region=California"

4.3.13 Mobile — ISPs

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/mobile-isp
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country
region	String	✅	Region
city	String	✅	City

Response 200:

Field	Type	Description
isp	Array	List of mobile ISPs

bash
curl -X GET "https://api.gsocks.net/proxy/mobile-isp?country=US&region=California&city=Los%20Angeles"

4.3.14 Dedicated Mobile — Countries

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/dedicated-mobile-countries
Authorization	Not required

Response 200:

Field	Type	Description
countries	Array	List of countries

bash
curl -X GET https://api.gsocks.net/proxy/dedicated-mobile-countries

4.3.15 Dedicated Mobile — Cities

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/dedicated-mobile-cities
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country

Response 200:

Field	Type	Description
cities	Array	List of cities

bash
curl -X GET "https://api.gsocks.net/proxy/dedicated-mobile-cities?country=US"

4.3.16 Dedicated Mobile — ISPs

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/dedicated-mobile-isp
Authorization	Not required

Query Parameters:

Field	Type	Required	Description
country	String	✅	Country
city	String	✅	City

Response 200:

Field	Type	Description
isp	Array	List of ISPs

bash
curl -X GET "https://api.gsocks.net/proxy/dedicated-mobile-isp?country=US&city=New%20York"

4.4 Traffic Volume Management

These endpoints are used for proxy types with shared account traffic (residential, mobile, datacenter). You must purchase traffic before creating proxies of these types.

4.4.1 Add Residential Traffic Volume

Purchases residential traffic for the account.

Parameter	Value
Method	POST
URL	https://api.gsocks.net/proxy/residential-volume
Authorization	✅ Required

Request Body (JSON):

Field	Type	Required	Description
volume	Number	✅	Volume in gigabytes

Response 200:

Field	Type	Description
message	String	"Success"

Example:

bash
curl -X POST https://api.gsocks.net/proxy/residential-volume \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{"volume": 10}'

4.4.2 GET Residential Traffic Volume

Returns the current residential traffic balance.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-volume
Authorization	✅ Required

Response 200:

Field	Type	Description
have_traffic	Boolean	Whether traffic is available (true / false)
rest_volume	String	Remaining traffic
volume	String	Total purchased traffic

Example:

bash
curl -X GET https://api.gsocks.net/proxy/residential-volume \
  -H "authorization: session eyJhbGci..."

Example Response:

json
{
  "have_traffic": true,
  "rest_volume": "7.35",
  "volume": "10.00"
}

4.4.3 Add Mobile Traffic Volume

Purchases mobile traffic for the account.

Parameter	Value
Method	POST
URL	https://api.gsocks.net/proxy/mobile-volume
Authorization	✅ Required

Request Body (JSON):

Field	Type	Required	Description
volume	Number	✅	Volume in gigabytes

Response 200:

Field	Type	Description
message	String	"Success"

bash
curl -X POST https://api.gsocks.net/proxy/mobile-volume \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{"volume": 5}'

4.4.4 GET Mobile Traffic Volume

Returns the current mobile traffic balance.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/mobile-volume
Authorization	✅ Required

Response 200:

Field	Type	Description
have_traffic	Boolean	Whether traffic is available
rest_volume	String	Remaining traffic
volume	String	Total purchased traffic

bash
curl -X GET https://api.gsocks.net/proxy/mobile-volume \
  -H "authorization: session eyJhbGci..."

4.4.5 Add Datacenter Traffic Volume

Purchases datacenter traffic for the account.

Parameter	Value
Method	POST
URL	https://api.gsocks.net/proxy/datacenter-volume
Authorization	✅ Required

Request Body (JSON):

Field	Type	Required	Description
volume	Number	✅	Volume in gigabytes

Response 200:

Field	Type	Description
message	String	"Success"

bash
curl -X POST https://api.gsocks.net/proxy/datacenter-volume \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{"volume": 20}'

4.4.6 GET Datacenter Traffic Volume

Returns the current datacenter traffic balance.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/datacenter-volume
Authorization	✅ Required

Response 200:

Field	Type	Description
have_traffic	Boolean	Whether traffic is available
rest_volume	String	Remaining traffic
volume	String	Total purchased traffic

bash
curl -X GET https://api.gsocks.net/proxy/datacenter-volume \
  -H "authorization: session eyJhbGci..."

4.5 Create Proxy

Create Proxy

Creates one or more proxies.

Parameter	Value
Method	POST
URL	https://api.gsocks.net/proxy/
Authorization	✅ Required

Request Body (JSON):

Field	Type	Required	Default	Description
type	String	✅	—	Proxy type. Allowed values: mobile, residential, private, datacenter, dedicated-residential, package-residential, dedicated-mobile, package-mobile, new-datacenter
volume	Number	✅	—	Gigabytes (for residential/mobile/datacenter types) or days (for private)
count	Number	No	1	Number of proxies to create
country	String	No	Any	Country
region	String	No	Any	Region
city	String	No	Any	City
isp	String	No	Any	Internet service provider
username	String	No	—	Username for proxy authentication
password	String	No	—	Password for proxy authentication
rotation	String	No	—	IP rotation type. Allowed values: request (new IP every request), link (change IP via link), 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 (auto-rotate every N minutes)
price	Number	No	—	If you calculate the price on your end, send it for verification
package_id	Number	No	—	Package ID (for package-residential and package-mobile types)

Response 200:

Field	Type	Description
message	String	"Success"
proxy	Object	Created proxy data

Example — Create 1 residential proxy (shared traffic) in the US with 10-minute rotation:

bash
curl -X POST https://api.gsocks.net/proxy/ \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "residential",
    "volume": 1,
    "count": 1,
    "country": "US",
    "rotation": "10",
    "username": "myuser",
    "password": "mypass123"
  }'

Example — Create 5 private proxies for 30 days in Germany:

bash
curl -X POST https://api.gsocks.net/proxy/ \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "private",
    "volume": 30,
    "count": 5,
    "country": "DE"
  }'

Example — Create a dedicated mobile proxy with 2 GB traffic:

bash
curl -X POST https://api.gsocks.net/proxy/ \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "dedicated-mobile",
    "volume": 2,
    "country": "US",
    "city": "New York",
    "rotation": "request"
  }'

4.6 GET Proxies

4.6.1 GET Some Proxies — Paginated List

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy
Authorization	✅ Required

Query Parameters:

Field	Type	Required	Default	Description
type	String	✅	—	Proxy type. Allowed values: mobile, residential, private, datacenter, dedicated-residential, package-residential, dedicated-mobile, package-mobile, new-datacenter
active	String	✅	—	Status filter. Allowed values: active, archived, all
limit	Number	No	10	Items per page
page	Number	No	1	Page number

Response 200:

Field	Type	Description
proxies	Array	List of proxies
count	Number	Total count

Example:

bash
curl -X GET "https://api.gsocks.net/proxy?type=residential&active=active&limit=20&page=1" \
  -H "authorization: session eyJhbGci..."

4.6.2 GET One Proxy — Single Proxy by ID

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Proxy ID

Query Parameters:

Field	Type	Required	Description
type	String	✅	Proxy type (same allowed values as above)

Response 200:

Field	Type	Description
proxy	Object	Proxy object

Example:

bash
curl -X GET "https://api.gsocks.net/proxy/12345?type=residential" \
  -H "authorization: session eyJhbGci..."

4.7 GET Proxy List (Text Export)

These endpoints return a ready-to-use text list of proxies (e.g. host:port:user:pass) for importing into software.

4.7.1 Residential Proxy List by ID

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-proxy-list/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Proxy ID

Query Parameters:

Field	Type	Required	Description
br	Boolean	No	Use HTML <br> as line separator

Response 200:

Field	Type	Description
List	String	Text proxy list

Note about domains: By default, the list uses the domain residential.gsocks.net (servers located in the USA). If you are in Europe, you can use eu.residential.gsocks.net instead. You can also use us.residential.gsocks.net, which is the same as the default domain.

Example:

bash
curl -X GET "https://api.gsocks.net/proxy/residential-proxy-list/12345" \
  -H "authorization: session eyJhbGci..."

4.7.2 Residential Proxy List by Username

Does not require authorization — accessed by the proxy list username.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-proxy-list-pseudo/:username
Authorization	Not required

URL Parameters:

Field	Type	Required	Description
username	String	✅	Proxy list username

Query Parameters:

Field	Type	Required	Description
br	Boolean	No	Use HTML <br> as line separator

Response 200:

Field	Type	Description
List	String	Text proxy list

bash
curl -X GET "https://api.gsocks.net/proxy/residential-proxy-list-pseudo/myuser123"

4.7.3 Mobile Proxy List by ID

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/mobile-proxy-list/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Proxy ID

Query Parameters:

Field	Type	Required	Description
br	Boolean	No	Use HTML <br> as line separator

Response 200:

Field	Type	Description
List	String	Text proxy list

bash
curl -X GET "https://api.gsocks.net/proxy/mobile-proxy-list/12345" \
  -H "authorization: session eyJhbGci..."

4.7.4 Mobile Proxy List by Username

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/mobile-proxy-list-pseudo/:username
Authorization	Not required

URL Parameters:

Field	Type	Required	Description
username	String	✅	Proxy list username

Query Parameters:

Field	Type	Required	Description
br	Boolean	No	Use HTML <br> as line separator

Response 200:

Field	Type	Description
List	String	Text proxy list

bash
curl -X GET "https://api.gsocks.net/proxy/mobile-proxy-list-pseudo/myuser123"

4.8 Update Proxy

Update Proxy — Change Proxy Settings

Parameter	Value
Method	PUT
URL	https://api.gsocks.net/proxy/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Proxy ID

Request Body (JSON):

Field	Type	Required	Applicable to	Description
type	String	✅	All	Proxy type. Allowed: mobile, residential, datacenter, dedicated-residential, package-residential, dedicated-mobile, package-mobile
country	String	✅	mobile, residential, dedicated-residential, package-residential, dedicated-mobile, package-mobile	Country
region	String	✅	Same as country	Region
city	String	✅	Same as country	City
isp	String	✅	Same as country	ISP
rotation	String	✅	residential, dedicated-residential, mobile, datacenter, package-residential, dedicated-mobile, package-mobile	Rotation type. Allowed values: request, link, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60

Response 200:

Field	Type	Description
message	String	"Success"

Example — Change country and rotation:

bash
curl -X PUT https://api.gsocks.net/proxy/12345 \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "residential",
    "country": "DE",
    "region": "Any",
    "city": "Any",
    "isp": "Any",
    "rotation": "30"
  }'

4.9 Renew Proxy

Renewal Proxy — Extend Proxy Duration or Traffic

Parameter	Value
Method	POST
URL	https://api.gsocks.net/proxy/renewal
Authorization	✅ Required

Request Body (JSON):

Field	Type	Required	Description
type	String	✅	Proxy type. Allowed: mobile, private, datacenter, dedicated-residential, dedicated-mobile, package-mobile
volume	Number	✅	Gigabytes (for residential/mobile/datacenter) or days (for private)
ids	Number[]	✅	Array of proxy IDs to renew
price	Number	No	Price for verification (if calculated on your end)

Response 200:

Field	Type	Description
message	String	"Success"

Example — Renew 2 private proxies for 30 days:

bash
curl -X POST https://api.gsocks.net/proxy/renewal \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "private",
    "volume": 30,
    "ids": [12345, 12346]
  }'

4.10 Traffic Logs

4.10.1 Residential Traffic Log by Username

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-traffic-log-by-username
Authorization	✅ Required

Query Parameters:

Field	Type	Required	Default	Description
username	String	✅	—	Proxy list username
period	String	No	all	Time period. Allowed values: daily, weekly, monthly, all

Response 200:

Field	Type	Description
Log	Array	Traffic log entries

bash

curl -X GET "https://api.gsocks.net/proxy/residential-traffic-log-by-username?username=myuser&period=daily" \
  -H "authorization: session eyJhbGci..."

4.10.2 Residential Traffic Log by Account

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-traffic-log-by-account
Authorization	✅ Required

Query Parameters:

Field	Type	Required	Default	Description
period	String	No	all	Time period. Allowed values: daily, weekly, monthly, all

Response 200:

Field	Type	Description
Log	Array	Traffic log entries

bash

curl -X GET "https://api.gsocks.net/proxy/residential-traffic-log-by-account?period=weekly" \
  -H "authorization: session eyJhbGci..."

4.11 Nodes Info

GET Residential Nodes Info

Returns information about residential proxy nodes.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-nodes-info
Authorization	Not required

Response 200:

Field	Type	Description
nodes	Object	Residential nodes information

bash
curl -X GET https://api.gsocks.net/proxy/residential-nodes-info

4.12 Residential Packages

Packages allow you to create a set of residential proxies grouped under a shared traffic pool with a single username/password pair.

4.12.1 Create Residential Package

Parameter	Value
Method	POST
URL	https://api.gsocks.net/proxy/residential-package
Authorization	✅ Required

Request Body (JSON):

Field	Type	Required	Description
username	String	✅	Username for the package
password	String	✅	Password for the package

Response 200:

Field	Type	Description
message	String	"Success"
package	Object	Created package data

bash
curl -X POST https://api.gsocks.net/proxy/residential-package \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "username": "pack_user1",
    "password": "pack_pass123"
  }'

4.12.2 GET Some Residential Packages — Paginated List

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-package
Authorization	✅ Required

Query Parameters:

Field	Type	Required	Default	Description
limit	Number	No	10	Items per page
page	Number	No	1	Page number

Response 200:

Field	Type	Description
packages	Array	List of packages
count	Number	Total count

bash
curl -X GET "https://api.gsocks.net/proxy/residential-package?limit=5&page=1" \
  -H "authorization: session eyJhbGci..."

4.12.3 GET One Residential Package

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-package/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Package ID

Response 200:

Field	Type	Description
package	Object	Package data

bash
curl -X GET "https://api.gsocks.net/proxy/residential-package/789" \
  -H "authorization: session eyJhbGci..."

4.12.4 Update Residential Package

Parameter	Value
Method	PUT
URL	https://api.gsocks.net/residential-package/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Package ID

Request Body (JSON):

Field	Type	Required	Description
username	String	✅	New username
password	String	✅	New password

Response 200:

Field	Type	Description
message	String	"Success"
package	Object	Updated package data

bash
curl -X PUT https://api.gsocks.net/residential-package/789 \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "username": "new_user",
    "password": "new_pass456"
  }'

4.12.5 Renewal Residential Package

Parameter	Value
Method	POST
URL	https://api.gsocks.net/proxy/residential-package/renewal/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Package ID

Request Body (JSON):

Field	Type	Required	Description
volume	Number	✅	Traffic volume in GB to add

Response 200:

Field	Type	Description
message	String	"Success"
package	Object	Updated package data

bash
curl -X POST https://api.gsocks.net/proxy/residential-package/renewal/789 \
  -H "authorization: session eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{"volume": 10}'

4.12.6 Delete Residential Package

Parameter	Value
Method	DELETE
URL	https://api.gsocks.net/proxy/residential-package/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Package ID

Response 200:

Field	Type	Description
message	String	"Success"

bash
curl -X DELETE "https://api.gsocks.net/proxy/residential-package/789" \
  -H "authorization: session eyJhbGci..."

4.12.7 GET Residential Proxies by Package

Returns proxies that belong to a specific package.

Parameter	Value
Method	GET
URL	https://api.gsocks.net/proxy/residential-by-package/:id
Authorization	✅ Required

URL Parameters:

Field	Type	Required	Description
id	Number	✅	Package ID

Query Parameters:

Field	Type	Required	Default	Description
limit	Number	No	10	Items per page
page	Number	No	1	Page number

Response 200:

Field	Type	Description
packages	Array	List of proxies in the package
count	Number	Total count

bash
curl -X GET "https://api.gsocks.net/proxy/residential-by-package/789?limit=20&page=1" \
  -H "authorization: session eyJhbGci..."

Quick Reference: Rotation Values

rotation Value	Behavior
request	New IP on every HTTP request
link	Change IP manually via a special link
5 through 60	Automatically rotate IP every N minutes

Quick Reference: Proxy Types and volume Meaning

Type	volume Represents	Example
residential, mobile, datacenter, dedicated-residential, dedicated-mobile, new-datacenter, package-residential, package-mobile	Gigabytes of traffic	"volume": 5 = 5 GB
private	Rental days	"volume": 30 = 30 days

API Documentation

1. Authorization

2. Profile

2.1 GET Balance

3. Proxy

3.1 Understanding Proxy Types

3.2 Price Calculation

3.2.1 GET Final Proxy Price (with promo code)

4.3 Available Countries / Regions / Cities / ISPs

4.3.1 Private — Countries

4.3.2 Datacenter — Countries

4.3.3 Residential — Countries

4.3.4 Residential — Regions

4.3.5 Residential — Cities

4.3.6 Residential — ISPs

4.3.7 Dedicated Residential — Countries

4.3.8 Dedicated Residential — Cities

4.3.9 Dedicated Residential — ISPs

4.3.10 Mobile — Countries

4.3.11 Mobile — Regions

4.3.12 Mobile — Cities

4.3.13 Mobile — ISPs

4.3.14 Dedicated Mobile — Countries

4.3.15 Dedicated Mobile — Cities

4.3.16 Dedicated Mobile — ISPs

4.4 Traffic Volume Management

4.4.1 Add Residential Traffic Volume

4.4.2 GET Residential Traffic Volume

4.4.3 Add Mobile Traffic Volume

4.4.4 GET Mobile Traffic Volume

4.4.5 Add Datacenter Traffic Volume

4.4.6 GET Datacenter Traffic Volume

4.5 Create Proxy

Create Proxy

4.6 GET Proxies

4.6.1 GET Some Proxies — Paginated List

4.6.2 GET One Proxy — Single Proxy by ID

4.7 GET Proxy List (Text Export)

4.7.1 Residential Proxy List by ID

4.7.2 Residential Proxy List by Username

4.7.3 Mobile Proxy List by ID

4.7.4 Mobile Proxy List by Username

4.8 Update Proxy

Update Proxy — Change Proxy Settings

4.9 Renew Proxy

Renewal Proxy — Extend Proxy Duration or Traffic

4.10 Traffic Logs

4.10.1 Residential Traffic Log by Username

4.10.2 Residential Traffic Log by Account

4.11 Nodes Info

GET Residential Nodes Info

4.12 Residential Packages

4.12.1 Create Residential Package

4.12.2 GET Some Residential Packages — Paginated List

4.12.3 GET One Residential Package

4.12.4 Update Residential Package

4.12.5 Renewal Residential Package

4.12.6 Delete Residential Package

4.12.7 GET Residential Proxies by Package

Quick Reference: Rotation Values

Quick Reference: Proxy Types and volume Meaning