Dados abertos, uso simples

API de cidades e fusos

Um endpoint estático, sem chave de API e sem servidor: cidades com coordenadas, país e fuso IANA. Ideal para autocomplete, datas em calendários e relógios embutidos.

Endpoint

GET https://relogiomundial.com.br/api/cidades.json

Grátis · usos de teste ilimitados

curl

curl https://relogiomundial.com.br/api/cidades.json \
  | python3 -c "import sys,json; d=json.load(sys.stdin); \
print(len(d['cities']), 'cidades', '—', d['cities'][0]['name'])"

JavaScript / fetch

const endpoints = await fetch('https://relogiomundial.com.br/api/cidades.json').then(r => r.json());
for (const city of endpoints.cities) {
  if (city.countryCode === 'BR') {
    console.log(city.name, city.timezone);
  }
}

TypeScript (tipos)

// /api/cidades.json — tipos sugeridos (inferir com zod ou manter manual)
export interface CityRecord {
  slug: string;
  name: string;
  nameEn: string;
  country: string;
  countryCode: string;
  admin1?: string;
  timezone: string;
  lat: number;
  lon: number;
  population?: number;
  isCapital: boolean;
  region: 'Americas' | 'Europe' | 'AsiaPacific' | 'MideastAfrica';
}

Grátis para começar

Cache HTTP de 1 ano (rápido e barato)
JSON estático gerado no build
Amplo para autocomplete e lookups simples

Para necessidades maiores

Precisa de dados por estado/município brasileiro, fusos detalhados ano a ano, horários de feriados ou um contrato de nível de serviço? Montamos um pacote de dados sob medida.

Solicitar dados sob medida

Também para desenvolvedores

O widget de relógio mundial é uma alternativa sem código, com iframe pronto. E o plano Widget white-label (R$ 99/mês) remove a marca e libera domínios extras.

Dados factuais de domínio público (coordenadas, país, fuso IANA). Não usamos estes dados como fonte de precisão atômica — veja Sobre os dados.