Skip to main content
POST
/
v1
/
usage
curl -X GET https://api.gmproxys.com/v1/usage \
  -H "X-API-Key: gm_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "6712",
    "period": "day",
    "limit": 100,
    "offset": 0,
    "datetime_aggregate": "minute"
  }'
const response = await fetch("https://api.gmproxys.com/v1/usage", {
  method: "GET",
  headers: {
    "X-API-Key": "gm_SUA_CHAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    user_id: "6712",
    period: "day",
    limit: 100,
    offset: 0,
    datetime_aggregate: "minute",
  }),
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.gmproxys.com/v1/usage",
    headers={
        "X-API-Key": "gm_SUA_CHAVE",
        "Content-Type": "application/json",
    },
    json={
        "user_id": "6712",
        "period": "day",
        "limit": 100,
        "offset": 0,
        "datetime_aggregate": "minute",
    },
)

print(response.json())
{
  "usage": [
    {
      "host": null,
      "datetime": "2023-09-15 09:27:00 UTC",
      "requests": 0,
      "traffic": 0,
      "extra_traffic": "0 bytes",
      "status": "error",
      "message": "NO_HOST_CONNECTION"
    },
    {
      "host": "api.ipify.",
      "datetime": "2023-09-15 09:27:00 UTC",
      "requests": 1,
      "traffic": 0,
      "extra_traffic": "0 bytes",
      "status": "success",
      "message": null
    },
    {
      "host": "google.com",
      "datetime": "2023-09-15 09:25:00 UTC",
      "requests": 1,
      "traffic": "8.08 KB",
      "extra_traffic": "21.57 KB",
      "status": "success",
      "message": null
    },
    {
      "host": "api.ipify.org",
      "datetime": "2023-09-15 09:25:00 UTC",
      "requests": 3,
      "traffic": "20.41 KB",
      "extra_traffic": "600.8 KB",
      "status": "success",
      "message": null
    }
  ],
  "total_count": 4
}
{
  "success": false,
  "message": "Invalid API token."
}
{
  "success": false,
  "message": "Proxy user not found."
}
Retorna estatísticas de uso (requisições, tráfego, hosts acessados) de um usuário da proxy em um determinado período.

Headers

X-API-Key
string
required
Sua chave de API no formato gm_SUA_CHAVE.

Body

user_id
string
required
ID do usuário da proxy a ser consultado.
period
string
required
Período das estatísticas. Valores aceitos: day, week, month, 3months ou 6months.
limit
integer
default:"100"
Quantidade máxima de registros retornados.
offset
integer
default:"0"
Deslocamento para paginação.
datetime_aggregate
string
default:"minute"
Granularidade da agregação temporal. Valores aceitos: minute, hour ou day.

Resposta

usage
array
Lista de registros de uso do proxy.
total_count
integer
Total de registros disponíveis.
curl -X GET https://api.gmproxys.com/v1/usage \
  -H "X-API-Key: gm_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "6712",
    "period": "day",
    "limit": 100,
    "offset": 0,
    "datetime_aggregate": "minute"
  }'
const response = await fetch("https://api.gmproxys.com/v1/usage", {
  method: "GET",
  headers: {
    "X-API-Key": "gm_SUA_CHAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    user_id: "6712",
    period: "day",
    limit: 100,
    offset: 0,
    datetime_aggregate: "minute",
  }),
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.gmproxys.com/v1/usage",
    headers={
        "X-API-Key": "gm_SUA_CHAVE",
        "Content-Type": "application/json",
    },
    json={
        "user_id": "6712",
        "period": "day",
        "limit": 100,
        "offset": 0,
        "datetime_aggregate": "minute",
    },
)

print(response.json())
{
  "usage": [
    {
      "host": null,
      "datetime": "2023-09-15 09:27:00 UTC",
      "requests": 0,
      "traffic": 0,
      "extra_traffic": "0 bytes",
      "status": "error",
      "message": "NO_HOST_CONNECTION"
    },
    {
      "host": "api.ipify.",
      "datetime": "2023-09-15 09:27:00 UTC",
      "requests": 1,
      "traffic": 0,
      "extra_traffic": "0 bytes",
      "status": "success",
      "message": null
    },
    {
      "host": "google.com",
      "datetime": "2023-09-15 09:25:00 UTC",
      "requests": 1,
      "traffic": "8.08 KB",
      "extra_traffic": "21.57 KB",
      "status": "success",
      "message": null
    },
    {
      "host": "api.ipify.org",
      "datetime": "2023-09-15 09:25:00 UTC",
      "requests": 3,
      "traffic": "20.41 KB",
      "extra_traffic": "600.8 KB",
      "status": "success",
      "message": null
    }
  ],
  "total_count": 4
}
{
  "success": false,
  "message": "Invalid API token."
}
{
  "success": false,
  "message": "Proxy user not found."
}