API de DomainCatcher: buscar, encargar y automatizar dominios

Autor: Leo Kobes Publicado: 22 de julio de 2026 Actualizado: 3 de agosto de 2026 Información de producto actualizada a: 3 de agosto de 2026

Nuevo · API REST · Automatización

La nueva API de DomainCatcher permite obtener y crear backorders, buscar dominios RGP y ReCatch, adquirir dominios ReCatch, registrar dominios .de libres y comprar dominios de la Domex. La interfaz está dirigida a inversores en dominios, publishers, equipos de SEO y desarrolladores que quieran automatizar procesos recurrentes de dominios.

La API es proporcionada técnica y contractualmente por DomainCatcher.com. deinrecatch.de explica los endpoints disponibles, los requisitos, las respuestas y las reglas de seguridad. La clave de API, el saldo, las compras y la gestión de dominios permanecen íntegramente en la cuenta de DomainCatcher.

Crear una clave de API en DomainCatcher Ver endpoints Sobre DomainCatcher

Tras iniciar sesión: Account → API. Enlace externo a DomainCatcher.com; allí se aplican los precios y condiciones actuales.

La API de un vistazo

¿Para quién está pensada la API?

La API no permite una gestión completa de dominios ni gestión de DNS; cubre específicamente los procesos de backorder, RGP, ReCatch, Free y Domex.

Requisitos para el acceso a la API

• Una cuenta de DomainCatcher activa.
• Un nivel de Tier que permita el acceso a la API.
• Clave de API desde: Account → API
• Saldo prepago de DC suficiente para acciones de pago.
• Autorización específica del endpoint.
• En compras Domex, un contacto estándar totalmente verificado.
• Almacenamiento seguro de la clave de API en el servidor.

Autenticación con clave de API

Cabecera preferida:

apiKey: DEIN_API_KEY

Otras formas aceptadas según la documentación:

X-Api-Key: DEIN_API_KEY
Authorization: Bearer DEIN_API_KEY

También se acepta técnicamente: auth_key en el cuerpo o en la query.

• No guardes nunca la clave de API en el frontend.
• No publiques nunca la clave de API en JavaScript de navegador disponible públicamente.
• No subas nunca la clave de API a Git.
• No muestres nunca la clave de API en capturas de pantalla.
• No transmitas nunca la clave de API a través de Google Analytics.
• No utilices nunca la clave de API como parámetro de URL en ejemplos visibles públicamente.
• No utilices claves de producción en código de demostración.
• Gestiona la clave en el servidor como variable de entorno.
• Renueva la clave en tu cuenta de DomainCatcher de inmediato si sospechas de su divulgación.

Formato JSON unificado

Todas las respuestas siguen, en general, este patrón:

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

• success muestra el éxito general.
• msg contiene un mensaje comprensible.
• data depende del endpoint.
• En caso de error, data.error puede contener un código de error específico.
• Una respuesta HTTP 201 puede iniciar un proceso posterior asíncrono.

Códigos de estado HTTP

No hay más códigos de estado documentados para estos endpoints.

Por qué hay que comprobar data.restricted

Los siguientes endpoints de listado pueden, con un Tier restringido o saldo insuficiente, entregar solo una vista previa o primera página: RGP, ReCatch, Free, Domex.

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

Una respuesta HTTP exitosa no significa automáticamente que se haya entregado la lista completa. Las aplicaciones deben evaluar data.restricted y no deben presentar una lista de muestra como el inventario completo.

Todos los endpoints documentados actualmente

GET /api3/backorder

Finalidad: Obtener los backorders del usuario autenticado.

Se requiere al menos un 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"}'

Datos de respuesta:

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

Los datos de ejemplo son marcadores de posición; no se muestran datos reales de clientes ni de pedidos.

POST /api3/backorder

Finalidad: Crear un nuevo backorder.

Parámetro obligatorio: domain

• solo .de
• el dominio debe estar en la RGP
• saldo suficiente
• el Tier debe permitir backorders
• no se puede superar el límite paralelo de backorders

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 posibles: 201 Created en caso de éxito, 400 Bad Request por problemas de dominio, RGP, saldo o límite, 403 Forbidden por falta de autorización de Tier.

GET /api3/rgp

Finalidad: Obtener dominios RGP para un periodo o mediante búsqueda libre.

Parámetro obligatorio: date

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

Para search: al menos tres caracteres, caracteres permitidos según la documentación, posibles diéresis alemanas y ß.

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"}'

Estructura de la respuesta:

{
  "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"
    }
  ]
}

Los campos de valoración (did, blv, age, tlc) no se interpretan libremente aquí, ya que su escala exacta no se especifica en la documentación disponible.

GET /api3/recatch

Finalidad: Obtener la lista ReCatch actual.

Parámetros (todos opcionales): search, limit, offset

Límite predeterminado: 100 · Límite máximo: 500. Con acceso restringido, la lista se reduce.

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}'

Estructura de la respuesta:

{
  "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 es el número total, count el número de entradas devueltas, offset y limit sirven para la paginación, restricted indica una vista limitada.

POST /api3/recatch

Finalidad: Adquirir un dominio ReCatch.

Parámetro obligatorio: domain

Requisitos: dominio .de, el dominio debe estar en el estado ReCatch/RGP correcto, saldo prepago suficiente, autorización de Tier correspondiente, acceso a la 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"}'

Respuesta:

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

pending: true significa que la reserva o el procesamiento técnico aún está en curso. No debe mostrarse prematuramente un éxito definitivo.

GET /api3/free

Finalidad: Obtener dominios que ya han sido eliminados y que, en principio, pueden volver a registrarse.

Parámetros opcionales: search, date, limit, offset

Valores de fecha: dropToday, drop-1

Búsqueda con comodines según la documentación: un * inicial busca sufijos, un * final busca prefijos, un asterisco en medio del término de búsqueda se rechaza.

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 respuesta: date, restricted, total, offset, limit, count, domains, freeId

Un dominio en la lista Free no es una garantía permanente de disponibilidad. Antes del registro real se comprueba de nuevo la disponibilidad.

POST /api3/free

Finalidad: Registrar de nuevo un dominio de la lista Free.

Parámetro obligatorio: domain

Requisitos: solo .de, el dominio debe seguir en la lista Free, el dominio debe seguir disponible en el registro, saldo suficiente, contacto adecuado y verificado cuando el proceso lo requiera.

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"}'

Datos de éxito:

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

El registro se procesa de forma asíncrona a través del gestor de tareas. 201 Created significa que el proceso se ha creado; el estado final del dominio debe comprobarse después. Ningún dominio se presenta aquí como realmente libre.

GET /api3/domex

Finalidad: Obtener las ofertas actuales de Domex.

Parámetros opcionales: search, tld, provider, minPrice, maxPrice, limit, offset

Valores de provider: all, domex, user

Lógica de precios: price es el precio válido para el usuario, is_netto indica si este precio se muestra sin IVA, price_netto es siempre el precio sin IVA. No se asume de forma genérica si los precios son con o sin 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 respuesta relevantes: domain, tld, type, price, price_netto, is_netto, provider, did, blv, age, tlc, domainId, is_own_domain

domainId es el ID único y preferido para la compra posterior en Domex.

POST /api3/domex

Finalidad: Comprar un dominio de la Domex.

Parámetro obligatorio: uno de los dos: domain o domain_id (se prefiere 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: el dominio debe seguir ofreciéndose activamente, el dominio no puede pertenecer al propio comprador, saldo suficiente, contacto estándar totalmente verificado, el dominio no puede estar ya vendido o en procesamiento.

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

nis2 se devuelve con 403 Forbidden; otros errores documentados pueden aparecer en data.error. Aquí no se añaden códigos de error propios.

Particularidad técnica de las solicitudes GET

La documentación disponible muestra varias solicitudes GET con cuerpo JSON. Algunos clientes HTTP, bibliotecas de navegador, proxies o cachés tratan de forma distinta las solicitudes GET con cuerpo. Utiliza por ello la forma de solicitud documentada por DomainCatcher y prueba la biblioteca HTTP del servidor que elijas. Aquí no se inventa ninguna transmisión alternativa de parámetros que no esté documentada oficialmente.

Por este motivo, esta página evita deliberadamente ejemplos de fetch() de navegador con cuerpo GET, ya que esto no está permitido o no es fiable según la implementación. Los ejemplos preferidos son cURL y PHP cURL del lado del servidor.

¿Qué se puede automatizar con la API?

Más información: Evaluar un dominio · Comprobar backlinks · Comprobar el historial del dominio · Comprobación de marcas · Checklist de ReCatch

Gestión de errores para integraciones

• Comprobar el código de estado HTTP.
• Comprobar success.
• Registrar msg.
• Comprobar data.error.
• Comprobar restricted en las listas.
• En procesos asíncronos, guardar pending o los IDs.
• No repetir a ciegas una solicitud de compra.
• En caso de errores de red, usar backoff.
• En caso de 401, no escribir la clave de API en registros.
• En caso de 400, no reenviar automáticamente de forma indefinida.
• En caso de 403, comprobar el estado del Tier o del contacto.
• En caso de 500, no arriesgar compras múltiples mediante reintentos agresivos.

Aquí no se indica una frecuencia de reintento concreta como requisito oficial de la API, mientras no haya un límite de solicitudes documentado.

Proteger la clave de API y las acciones de compra

• Usa la clave de API solo en el servidor.
• Guarda los secretos como variables de entorno.
• Separa los sistemas de producción y de prueba.
• Limpia los encabezados de autenticación de los registros.
• No automatices acciones de compra sin una comprobación de plausibilidad.
• Normaliza el nombre de dominio antes de las llamadas POST.
• Permite solo .de donde el endpoint lo exija.
• Vuelve a comprobar el precio y el dominio justo antes de la compra.
• No supongas idempotencia si no está documentada.
• No reintentes a ciegas solicitudes fallidas.
• Vigila el saldo y la autorización de Tier.
• Realiza las compras de Domex preferentemente con domain_id.
• Sustituye la clave de API de inmediato si sospechas de su divulgación.
• No escribas nunca una respuesta de la API sin filtrar en HTML público.

Preguntas frecuentes sobre la API de DomainCatcher

Más información

Sobre DomainCatcher · ¿Qué es ReCatch? · Backorder · RGP y dominios libres · Domex · Relación económica · Directrices editoriales · Privacidad