Statistics

Get user traffic stats

get

Authorizations

userBearerAuth

AuthorizationstringRequired

Bearer authentication with sentinel token for users.

You can use the following command to get the bearer token:

curl -d '{"username":"<username>", "password":"<password>"}' -H "Content-Type: application/json" -X POST -s https://api.goproxies.com/api/v1/login | jq -r '.token'

Substitute <username> and <password> with your credentials.

Query parameters

countrystringOptional

Filter by country

start_atstring · date-timeOptional

Filter by start date

Default: end of current day

end_atstring · date-timeOptional

Filter by end date

Default: start of the current month

usernamestringOptional

Filter by username of subuser.

Responses

200

OK

application/json

bytesnumberRequired

default

unexpected error

application/json

get/api/v1/stats/traffic

HTTPcURLJavaScriptPython

GET /api/v1/stats/traffic HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "bytes": 1,
  "filter": {
    "country": "text",
    "start_at": "2026-07-14T06:36:07.105Z",
    "end_at": "2026-07-14T06:36:07.105Z",
    "username": "text"
  }
}

Get user traffic stats history

get

Authorizations

userBearerAuth

AuthorizationstringRequired

Bearer authentication with sentinel token for users.

You can use the following command to get the bearer token:

curl -d '{"username":"<username>", "password":"<password>"}' -H "Content-Type: application/json" -X POST -s https://api.goproxies.com/api/v1/login | jq -r '.token'

Substitute <username> and <password> with your credentials.

Query parameters

countrystringOptional

Filter by country

start_atstring · date-timeOptional

Filter by start date

Default: end of current day

end_atstring · date-timeOptional

Filter by end date

Default: start of the current month

intervalstring · enumOptional

Group history into values by given interval

Possible values:

usernamestringOptional

Filter by username of subuser.

Responses

200

OK

application/json

default

unexpected error

application/json

get/api/v1/stats/traffic/history

HTTPcURLJavaScriptPython

GET /api/v1/stats/traffic/history HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "values": [],
  "filter": {
    "country": "text",
    "start_at": "2026-07-14T06:36:07.105Z",
    "end_at": "2026-07-14T06:36:07.105Z",
    "interval": "hour",
    "username": "text"
  }
}

Get user requests history

get

Authorizations

userBearerAuth

AuthorizationstringRequired

Bearer authentication with sentinel token for users.

You can use the following command to get the bearer token:

curl -d '{"username":"<username>", "password":"<password>"}' -H "Content-Type: application/json" -X POST -s https://api.goproxies.com/api/v1/login | jq -r '.token'

Substitute <username> and <password> with your credentials.

Query parameters

countrystringOptional

Filter by country

start_atstring · date-timeOptional

Filter by start date

Default: end of current day

end_atstring · date-timeOptional

Filter by end date

Default: start of the current month

intervalstring · enumOptional

Group history into values by given interval

Possible values:

usernamestringOptional

Filter by username of subuser.

statusintegerOptional

Filter by request status

status_notintegerOptional

Filter by request status not equal to

Responses

200

OK

application/json

default

unexpected error

application/json

get/api/v1/stats/requests/history

HTTPcURLJavaScriptPython

GET /api/v1/stats/requests/history HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "values": [],
  "filter": {
    "country": "text",
    "start_at": "2026-07-14T06:36:07.105Z",
    "end_at": "2026-07-14T06:36:07.105Z",
    "interval": "hour",
    "username": "text",
    "status": 1,
    "status_not": 1
  }
}

Get countries used in traffic

get

Get list of countries used in traffic statistics (in country code in 2-letter 3166-1 alpha-2 format).

Authorizations

userBearerAuth

AuthorizationstringRequired

Bearer authentication with sentinel token for users.

You can use the following command to get the bearer token:

curl -d '{"username":"<username>", "password":"<password>"}' -H "Content-Type: application/json" -X POST -s https://api.goproxies.com/api/v1/login | jq -r '.token'

Substitute <username> and <password> with your credentials.

Responses

200

OK

application/json

countriesstring[]Required

default

unexpected error

application/json

get/api/v1/stats/countries

HTTPcURLJavaScriptPython

GET /api/v1/stats/countries HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "countries": [
    "text"
  ]
}