Formatos de saída

Os arquivos de informações de domínio e de alterações semanais estão no formato JSON Lines (.jsonl) — um registro JSON por linha. O arquivo de nomes de domínio é um CSV (.csv) de coluna única com uma linha de cabeçalho “domainName”. Todos os arquivos de feed de dados são compactados com zstd (Zstandard).

Arquivos de informações de domínio

  • Dados incluídos: um registro de domínio enriquecido por domínio. Se um campo estiver ocultado ou ausente no registro atual do WHOIS ou do RDAP, ele será preenchido com o valor mais recente disponível nos registros históricos do WHOIS.
  • Formato do nome do arquivo: domain_info.%date%.weekly.jsonl.zst
  • Exemplo: domain_info.sample.weekly.jsonl.zst

Cada registro é composto pelo nome de domínio, pela seção de dados com os campos de registro do domínio e cinco seções de contato. Cada campo é um objeto que contém o valor do campo, a data em que foi confirmado pela última vez pelo nosso sistema e um indicador que mostra se o valor foi restaurado a partir de registros históricos por estar vazio ou ocultado no registro ativo atual.

{
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-03-22T20:15:53+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-03-22T20:15:53.197Z", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "John Doe", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "organization", "fieldValue": "Example Inc.", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephoneExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "fax", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "faxExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [ ... ]
}

Estrutura do registro

nomeDoDomínio

O nome de domínio associado.

dados

Os campos do registro do domínio (datas, servidores de nomes, registrador, status). Uma matriz de objetos de campo (consulte “Estrutura do objeto de campo” abaixo).

contato do registrante

Contém as informações de contato do registrante. Uma matriz de objetos de campo.

contato administrativo

Contém informações de contato administrativo. A estrutura é a mesma do campo registrantContact.

contato técnico

Contém informações de contato técnico. A estrutura é a mesma do campo registrantContact.

contato para cobrança

Contém informações de contato para fins de cobrança. A estrutura é a mesma do campo registrantContact.

zoneContact

Contém informações de contato da zona. A estrutura é a mesma do campo registrantContact.

Estrutura do objeto de campo

Cada campo nas seções de dados e de contatos é um objeto com as seguintes chaves:

nomeDoCampo

O nome do campo (consulte as listas de campos abaixo).

valorDoCampo

O valor mais informativo disponível para o campo. Obtido do registro atual do WHOIS/RDAP quando definido nesse registro; caso contrário, recuperado do registro histórico mais recente do WHOIS que o continha. Uma string vazia ou nulo, caso nenhum valor tenha sido registrado anteriormente.

dataDaAuditoria

A data em que o valor do campo foi confirmado ou registrado pela última vez pelo nosso sistema, no formato ISO 8601.

isEmptyOrRedactedNow

verdadeiro se o campo estiver vazio ou ocultado no registro ativo atual — o que significa que o valor exibido foi restaurado a partir de dados históricos do WHOIS. falso se o valor vier do registro atual.

Campos da seção de dados

createdDateISO8601

A data em que o domínio foi registrado, no formato ISO 8601.

dataDeAtualizaçãoISO8601

A data da última atualização do registro do domínio, no formato ISO 8601.

dataDeVencimentoISO8601

A data de vencimento do registro do domínio, no formato ISO 8601.

createdDateRaw

A data em que o registro WHOIS do domínio foi criado inicialmente, no formato bruto.

dataDeAtualizaçãoBruta

A última data em que o registro WHOIS do domínio foi atualizado, em formato bruto.

expiresDateRaw

A data de vencimento do registro WHOIS do domínio, em formato bruto.

servidores de nomes

Os servidores de nomes do domínio, separados por “|”.

whoisServer

O servidor WHOIS do qual o registro foi obtido.

nome do registrador

Nome do registrador

status

O(s) código(s) de status do domínio. Consulte https://www.icann.org/resources/pages/epp-status-codes-2014-06-16-en

Campos das seções de contato

Todas as cinco seções de contato (registrantContact, administrativeContact, technicalContact, billingContact, zoneContact) compartilham a mesma lista de campos:

nome

O nome do contato.

organização

A organização do contato.

rua

O endereço do contato.

cidade

A cidade do contato.

estado

O estado ou região do contato.

código postal

O código postal do contato.

país

O país do contato.

e-mail

O endereço de e-mail do contato.

telefone

O número de telefone do contato.

telephoneExt

O ramal telefônico do contato.

fax

O número de fax do contato.

faxExt

O ramal de fax do contato.

Arquivos de nomes de domínio

  • Dados incluídos: a lista completa de nomes de domínio abrangidos pelo feed de dados, sem seus registros de cadastro.
  • Formato do nome do arquivo: nomes_de_domínio.%data%.semanal.csv.zst
  • Exemplo de nome de arquivo: domain_names.2026-07-13.weekly.csv.zst
  • Exemplo: domain_names.sample.weekly.csv.zst
  • Formato: CSV em coluna única — uma linha de cabeçalho com o nome “domainName”, seguida por um nome de domínio por linha.
nomeDoDomínio
example.com
example.net
example.org
...

Arquivos de alterações semanais

  • Dados incluídos: os domínios cujos registros foram adicionados ou atualizados durante a semana.
  • Formato do nome do arquivo: domain_info.%data%.semanal.diff.jsonl.zst
  • Exemplo de nome de arquivo: domain_info.2026-07-13.weekly.diff.jsonl.zst
  • Exemplo: domain_info.sample.weekly.diff.jsonl.zst

Cada linha é um registro com a mesma estrutura dos arquivos de informações de domínio (a seção de dados e as cinco seções de contato), precedida por duas chaves: changeType, que indica o motivo pelo qual o domínio está presente no arquivo, e domainName.

{
  "changeType": "updated",
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2024-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2025-09-26T07:58:15+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2024-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2025-09-26T07:58:15Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "organization", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephoneExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "fax", "fieldValue": "13105555678", "auditDate": "2024-07-02T21:01:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "faxExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [
    {"fieldName": "name", "fieldValue": null, "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": true},
    ...
  ]
}

Descrição do campo de saída

changeType

Por que o domínio aparece no arquivo de alterações desta semana. Uma das seguintes razões:

  • adicionado — o domínio foi visto pela primeira vez nesta semana.
  • atualizado — o domínio já era conhecido antes desta semana, e seu registro foi alterado durante a semana.
nomeDoDomínio

O nome de domínio associado.

data,
registrantContact,
administrativeContact,
technicalContact,
billingContact,
zoneContact

Da mesma forma que nos arquivos de informações do domínio — consulte “Estrutura do registro” e “Estrutura do objeto de campo” acima. Um campo que esteja ausente no registro ativo atual e não tenha nenhum valor histórico possui um valor de campo (fieldValue) nulo, com o atributo isEmptyOrRedactedNow definido como true.