Skip to main content
GET
/
v1
/
states
curl -X GET https://api.gmproxys.com/v1/states \
  -H "X-API-Key: gm_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "residential",
    "countries": ["br"]
  }'

const response = await fetch("https://api.gmproxys.com/v1/states", {
  method: "GET",
  headers: {
    "X-API-Key": "gm_SUA_CHAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "residential",
    countries: ["br"],
  }),
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.gmproxys.com/v1/states",
    headers={
        "X-API-Key": "gm_SUA_CHAVE",
        "Content-Type": "application/json",
    },
    json={
        "type": "residential",
        "countries": ["br"],
    },
)

print(response.json())

[
  {
    "code": "acre",
    "name": "Acre",
    "count": 48
  },
  {
    "code": "alagoas",
    "name": "Alagoas",
    "count": 396
  },
  {
    "code": "amapa",
    "name": "Amapá",
    "count": 90
  },
  {
    "code": "amazonas",
    "name": "Amazonas",
    "count": 245
  }
]

{
  "success": false,
  "message": "Invalid API token."
}
Retorna a lista de estados disponíveis para o tipo de proxy e os países informados, junto com a quantidade de IPs em cada um.

​
Headers

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

​
Body

​
type
string
required
Tipo do proxy. Valores aceitos: datacenter ou residential.
​
countries
string[]
required
Array de códigos de países (ex.: ["br"]).

​
Resposta

Array de objetos com os estados disponíveis.
​
code
string
Código do estado.
​
name
string
Nome do estado.
​
count
integer
Quantidade de IPs disponíveis no estado.
curl -X GET https://api.gmproxys.com/v1/states \
  -H "X-API-Key: gm_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "residential",
    "countries": ["br"]
  }'

const response = await fetch("https://api.gmproxys.com/v1/states", {
  method: "GET",
  headers: {
    "X-API-Key": "gm_SUA_CHAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "residential",
    countries: ["br"],
  }),
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.gmproxys.com/v1/states",
    headers={
        "X-API-Key": "gm_SUA_CHAVE",
        "Content-Type": "application/json",
    },
    json={
        "type": "residential",
        "countries": ["br"],
    },
)

print(response.json())

[
  {
    "code": "acre",
    "name": "Acre",
    "count": 48
  },
  {
    "code": "alagoas",
    "name": "Alagoas",
    "count": 396
  },
  {
    "code": "amapa",
    "name": "Amapá",
    "count": 90
  },
  {
    "code": "amazonas",
    "name": "Amazonas",
    "count": 245
  }
]

{
  "success": false,
  "message": "Invalid API token."
}