Skip to main content
GET
/
v1
/
cities
curl -X GET https://api.gmproxys.com/v1/city \
  -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/city", {
  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/city",
    headers={
        "X-API-Key": "gm_SUA_CHAVE",
        "Content-Type": "application/json",
    },
    json={
        "type": "residential",
        "countries": ["br"],
    },
)

print(response.json())

[
  {
    "code": "abadiadegoias",
    "name": "Abadia de Goiás",
    "count": 1
  },
  {
    "code": "abaete",
    "name": "Abaeté",
    "count": 6
  },
  {
    "code": "abaetetuba",
    "name": "Abaetetuba",
    "count": 22
  },
  {
    "code": "abaiara",
    "name": "Abaiara",
    "count": 1
  }
]

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

​
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 as cidades disponíveis.
​
code
string
Código da cidade.
​
name
string
Nome da cidade.
​
count
integer
Quantidade de IPs disponíveis na cidade.
curl -X GET https://api.gmproxys.com/v1/city \
  -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/city", {
  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/city",
    headers={
        "X-API-Key": "gm_SUA_CHAVE",
        "Content-Type": "application/json",
    },
    json={
        "type": "residential",
        "countries": ["br"],
    },
)

print(response.json())

[
  {
    "code": "abadiadegoias",
    "name": "Abadia de Goiás",
    "count": 1
  },
  {
    "code": "abaete",
    "name": "Abaeté",
    "count": 6
  },
  {
    "code": "abaetetuba",
    "name": "Abaetetuba",
    "count": 22
  },
  {
    "code": "abaiara",
    "name": "Abaiara",
    "count": 1
  }
]

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