API da DomainCatcher: pesquisar, encomendar e automatizar domínios

Autor: Leo Kobes Publicado: 22 de julho de 2026 Atualizado: 3 de agosto de 2026 Informações de produto atualizadas em: 3 de agosto de 2026

Novo · API REST · Automação

A nova API da DomainCatcher permite obter e criar backorders, pesquisar domínios RGP e ReCatch, adquirir domínios ReCatch, registar domínios .de livres e comprar domínios da Domex. A interface destina-se a investidores em domínios, publishers, equipas de SEO e programadores que pretendem automatizar processos de domínios recorrentes.

A API é disponibilizada técnica e contratualmente pela DomainCatcher.com. O deinrecatch.de explica os endpoints disponíveis, os requisitos, as respostas e as regras de segurança. A chave de API, o saldo, as compras e a gestão de domínios permanecem inteiramente na conta DomainCatcher.

Criar uma chave de API na DomainCatcher Ver endpoints Sobre a DomainCatcher

Após o início de sessão: Account → API. Link externo para a DomainCatcher.com – aplicam-se os preços e condições atuais aí.

A API num relance

Para quem é a API?

A API não permite uma gestão completa de domínios nem gestão de DNS – cobre especificamente os processos de backorder, RGP, ReCatch, Free e Domex.

Requisitos para o acesso à API

• Uma conta DomainCatcher ativa.
• Um nível de Tier que permita acesso à API.
• Chave de API a partir de: Account → API
• Saldo pré-pago DC suficiente para ações pagas.
• Autorização específica do endpoint.
• Em compras Domex, um contacto padrão totalmente verificado.
• Armazenamento seguro da chave de API do lado do servidor.

Autenticação com chave de API

Cabeçalho preferido:

apiKey: DEIN_API_KEY

Outras formas aceites segundo a documentação:

X-Api-Key: DEIN_API_KEY
Authorization: Bearer DEIN_API_KEY

Também aceite tecnicamente: auth_key no corpo ou na query.

• Nunca guardar a chave de API no frontend.
• Nunca publicar a chave de API em JavaScript de navegador acessível publicamente.
• Nunca submeter a chave de API ao Git.
• Nunca mostrar a chave de API em capturas de ecrã.
• Nunca transmitir a chave de API através do Google Analytics.
• Nunca utilizar a chave de API como parâmetro de URL em exemplos publicamente visíveis.
• Não utilizar chaves de produção em código de demonstração.
• Gerir a chave do lado do servidor como variável de ambiente.
• Renovar a chave na conta DomainCatcher de imediato em caso de suspeita de divulgação.

Formato JSON uniforme

Todas as respostas seguem, em geral, este padrão:

{
  "success": true,
  "msg": "…",
  "data": {}
}

• success indica o sucesso geral.
• msg contém uma mensagem compreensível.
• data depende do endpoint.
• Em caso de erro, data.error pode conter um código de erro específico.
• Uma resposta HTTP 201 pode iniciar um processo assíncrono subsequente.

Códigos de estado HTTP

Não estão documentados outros códigos de estado para estes endpoints.

Por que data.restricted deve ser verificado

Os seguintes endpoints de listagem podem, em caso de Tier limitado ou saldo insuficiente, fornecer apenas uma amostra ou primeira página: RGP, ReCatch, Free, Domex.

{
  "restricted": true,
  "total": 245,
  "count": 10,
  "domains": []
}

Uma resposta HTTP bem-sucedida não significa automaticamente que a lista completa foi fornecida. As aplicações devem avaliar data.restricted e não podem apresentar uma lista de amostra como o conjunto completo.

Todos os endpoints atualmente documentados

GET /api3/backorder

Finalidade: Obter os backorders do utilizador autenticado.

É necessário pelo menos um parâmetro: domain, status

Valores de estado permitidos: pending, pending extended, successful, unsuccessful, user storno

curl -X GET \
  "https://api.domaincatcher.com/api3/backorder" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"pending"}'

Dados de resposta:

[
  {
    "domain": "dein-recatch.de",
    "order_date": "DATUM",
    "status": "pending",
    "drop_date": "DATUM"
  }
]

Os dados de exemplo são fictícios; não são apresentados dados reais de clientes ou encomendas.

POST /api3/backorder

Finalidade: Criar um novo backorder.

Parâmetro obrigatório: domain

• apenas .de
• o domínio tem de estar na RGP
• saldo suficiente
• o Tier tem de permitir backorders
• o limite paralelo de backorders não pode ser excedido

curl -X POST \
  "https://api.domaincatcher.com/api3/backorder" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"dein-recatch.de"}'

Resultados possíveis: 201 Created em caso de sucesso, 400 Bad Request por problemas de domínio, RGP, saldo ou limite, 403 Forbidden por falta de autorização de Tier.

GET /api3/rgp

Finalidade: Obter domínios RGP para um período ou através de pesquisa livre.

Parâmetro obrigatório: date

Valores permitidos: drop_in_30_days, drop_in_29_days, drop_in_2_days, drop_in_1_day, search

Para search: pelo menos três caracteres, caracteres permitidos segundo a documentação, possíveis trémas alemãs e ß.

curl -X GET \
  "https://api.domaincatcher.com/api3/rgp" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"drop_in_1_day"}'

Estrutura da resposta:

{
  "date": "drop_in_1_day",
  "restricted": false,
  "domains": [
    {
      "domain": "dein-recatch.de",
      "tld": "de",
      "drop_at": "DATUM",
      "did": "WERT",
      "blv": "WERT",
      "age": "WERT",
      "tlc": "WERT"
    }
  ]
}

Os campos de avaliação (did, blv, age, tlc) não são aqui livremente interpretados, uma vez que a sua escala exata não está especificada na documentação disponibilizada.

GET /api3/recatch

Finalidade: Obter a lista ReCatch atual.

Parâmetros (todos opcionais): search, limit, offset

Limite padrão: 100 · Limite máximo: 500. Em caso de acesso restrito, a lista é reduzida.

curl -X GET \
  "https://api.domaincatcher.com/api3/recatch" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"recatch","limit":100,"offset":0}'

Estrutura da resposta:

{
  "restricted": false,
  "total": 1,
  "offset": 0,
  "limit": 100,
  "count": 1,
  "domains": [
    {
      "domain": "dein-recatch.de",
      "tld": "de",
      "drop_at": "DATUM",
      "did": "WERT",
      "blv": "WERT",
      "age": "WERT",
      "tlc": "WERT",
      "recatchId": "WERT"
    }
  ]
}

total é o número total, count o número de entradas fornecidas, offset e limit servem para a paginação, restricted indica uma vista limitada.

POST /api3/recatch

Finalidade: Adquirir um domínio ReCatch.

Parâmetro obrigatório: domain

Requisitos: domínio .de, o domínio tem de estar no estado ReCatch/RGP correto, saldo pré-pago suficiente, autorização de Tier correspondente, acesso à API.

curl -X POST \
  "https://api.domaincatcher.com/api3/recatch" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"dein-recatch.de"}'

Resposta:

{
  "success": true,
  "msg": "Meldung",
  "data": {
    "pending": true
  }
}

pending: true significa que a reserva ou o processamento técnico ainda está em curso. Não deve ser apresentado prematuramente um sucesso definitivo.

GET /api3/free

Finalidade: Obter domínios já eliminados que, em princípio, podem ser novamente registados.

Parâmetros opcionais: search, date, limit, offset

Valores de data: dropToday, drop-1

Pesquisa com carateres universais segundo a documentação: um * inicial pesquisa sufixos, um * final pesquisa prefixos, um asterisco no meio do termo de pesquisa é rejeitado.

curl -X GET \
  "https://api.domaincatcher.com/api3/free" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"dropToday","limit":100,"offset":0}'

Campos de resposta: date, restricted, total, offset, limit, count, domains, freeId

Um domínio na lista Free não constitui uma garantia permanente de disponibilidade. Antes do registo efetivo, a disponibilidade é novamente verificada.

POST /api3/free

Finalidade: Registar novamente um domínio da lista Free.

Parâmetro obrigatório: domain

Requisitos: apenas .de, o domínio ainda tem de constar da lista Free, o domínio ainda tem de estar disponível no registry, saldo suficiente, contacto adequado e verificado sempre que necessário para o processo.

curl -X POST \
  "https://api.domaincatcher.com/api3/free" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"DOMAIN-AUS-DER-FREE-LISTE.de"}'

Dados de sucesso:

{
  "domain": "DOMAIN-AUS-DER-FREE-LISTE.de",
  "taskmanager_id": 123,
  "domain_id": 456,
  "netto": "BETRAG",
  "msg": "Meldung"
}

O registo é processado de forma assíncrona através do gestor de tarefas. 201 Created significa que o processo foi criado; o estado final do domínio deve ser verificado posteriormente. Nenhum domínio é aqui apresentado como efetivamente livre.

GET /api3/domex

Finalidade: Obter as ofertas Domex atuais.

Parâmetros opcionais: search, tld, provider, minPrice, maxPrice, limit, offset

Valores de provider: all, domex, user

Lógica de preços: price é o preço válido para o utilizador, is_netto indica se este preço é apresentado sem IVA, price_netto é sempre o preço sem IVA. Não é feita qualquer suposição geral quanto a preços com ou sem IVA.

curl -X GET \
  "https://api.domaincatcher.com/api3/domex" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"burger","provider":"domex","limit":100,"offset":0}'

Campos de resposta relevantes: domain, tld, type, price, price_netto, is_netto, provider, did, blv, age, tlc, domainId, is_own_domain

domainId é o ID único e preferencial para a subsequente compra Domex.

POST /api3/domex

Finalidade: Comprar um domínio da Domex.

Parâmetro obrigatório: um de dois – domain ou domain_id (preferencialmente domain_id).

curl -X POST \
  "https://api.domaincatcher.com/api3/domex" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain_id":12345}'

Requisitos: o domínio tem de continuar a ser oferecido ativamente, o domínio não pode pertencer ao próprio comprador, saldo suficiente, contacto padrão totalmente verificado, o domínio não pode já estar vendido ou em processamento.

Códigos de erro documentados: not_found, own_domain, no_money, not_available, selling, billing_failed, nis2

nis2 é devolvido com 403 Forbidden; outros erros documentados podem surgir em data.error. Não são aqui acrescentados códigos de erro próprios.

Particularidade técnica dos pedidos GET

A documentação disponibilizada mostra vários pedidos GET com corpo JSON. Alguns clientes HTTP, bibliotecas de navegador, proxies ou caches tratam de forma diferente os pedidos GET com corpo. Utilize por isso a forma de pedido documentada pela DomainCatcher e teste a biblioteca HTTP do lado do servidor escolhida. Não é aqui inventada nenhuma transmissão alternativa de parâmetros que não esteja oficialmente documentada.

Por este motivo, esta página evita deliberadamente exemplos de fetch() de navegador com corpo GET, uma vez que isso não é permitido, ou não é fiável, consoante a implementação. Os exemplos preferidos são cURL e PHP cURL do lado do servidor.

O que pode ser automatizado com a API?

Para saber mais: Avaliar um domínio · Verificar backlinks · Verificar o histórico do domínio · Verificação de marcas · Checklist ReCatch

Tratamento de erros para integrações

• Verificar o código de estado HTTP.
• Verificar success.
• Registar msg.
• Verificar data.error.
• Verificar restricted em listas.
• Em processos assíncronos, guardar pending ou os IDs.
• Não repetir cegamente um pedido de compra.
• Em caso de erros de rede, utilizar backoff.
• Em caso de 401, não escrever a chave de API em registos.
• Em caso de 400, não reenviar automaticamente de forma indefinida.
• Em caso de 403, verificar o estado do Tier ou do contacto.
• Em caso de 500, não arriscar compras múltiplas através de repetições agressivas.

Não é aqui indicada uma frequência concreta de repetição como requisito oficial da API, enquanto não estiver documentado um limite de taxa.

Proteger a chave de API e as ações de compra

• Utilizar a chave de API apenas do lado do servidor.
• Guardar segredos como variáveis de ambiente.
• Separar sistemas de produção e de teste.
• Limpar os cabeçalhos de autenticação dos registos.
• Não automatizar ações de compra sem verificação de plausibilidade.
• Normalizar o nome do domínio antes das chamadas POST.
• Permitir apenas .de onde o endpoint o exigir.
• Verificar novamente o preço e o domínio imediatamente antes da compra.
• Não presumir idempotência caso não esteja documentada.
• Não repetir cegamente pedidos falhados.
• Monitorizar o saldo e a autorização de Tier.
• Realizar compras Domex preferencialmente com domain_id.
• Substituir imediatamente a chave de API em caso de suspeita de divulgação.
• Nunca escrever uma resposta da API sem filtragem em HTML público.

Perguntas frequentes sobre a API da DomainCatcher

Para saber mais

Sobre a DomainCatcher · O que é o ReCatch? · Backorder · RGP e domínios livres · Domex · Relação económica · Diretrizes editoriais · Privacidade