Documentación API

URL Base

Production:https://api.quickname.tech

Límites de uso

Máximo 3 solicitudes por hora por dirección IP. Si necesitas más, contáctanos.
Descripción del proyecto: 5 a 1024 caracteres

POST/v1/request/Crear solicitud

Crea una nueva solicitud de búsqueda de dominios. Después de la creación, la solicitud se pone en cola para procesamiento.

Cuerpo de la solicitud

Campo	Tipo	Descripción
user_description*	string	Descripción del proyecto (5-1024 caracteres). Cuanto más detallada, mejores sugerencias.
zones	string[]	Lista de zonas de dominio preferidas (ej., ["com", "io"]). Opcional.
domain_max_price	integer	Precio máximo del dominio en USD. Opcional.

Ejemplo de solicitud

curl -X POST https://api.quickname.tech/v1/request/ \
  -H "Content-Type: application/json" \
  -d '{
    "user_description": "Marketplace online de relojes vintage",
    "zones": ["com", "io", "tech"],
    "domain_max_price": 100
  }'

Respuesta 201 Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "Marketplace online de relojes vintage",
  "zones": ["com", "io", "tech"],
  "domain_max_price": 100,
  "status": "created",
  "results": [],
  "is_valid": true
}

GET/v1/request/{'{'}request_id{'}'}/Obtener estado de solicitud

Devuelve el estado actual de una solicitud de búsqueda de dominios, incluyendo el estado de procesamiento y los resultados.

Estados

created

processing

finished

error

Ejemplo de solicitud

curl https://api.quickname.tech/v1/request/123e4567-e89b-12d3-a456-426614174000/

Respuesta 200 OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "Marketplace online de relojes vintage",
  "zones": ["com", "io", "tech"],
  "status": "finished",
  "results": [
    {
      "domain": "techmarket.io",
      "price": 45,
      "availability": "available",
      "reasoning": "Combina 'tech' con 'market' para un marketplace tecnológico"
    }
  ],
  "is_valid": true
}

Campos de respuesta

Objeto Domain

Campo	Tipo	Descripción
domain	string	Nombre de dominio completo (ej., example.com)
price	integer \| null	Precio del dominio en USD. Puede ser null.
availability	string	Estado: available, unavailable o unknown
reasoning	string \| null	Explicación de la IA para esta sugerencia

Códigos de error

Código	Descripción
400	Error de validación — verifica el cuerpo de la solicitud
404	Solicitud no encontrada o expirada (24 horas)
422	Formato UUID inválido
429	Límite de solicitudes excedido (3 solicitudes/hora)
500	Error interno del servidor

Volver al inicio