Necesitas informar a un gerente de producto antes del viernes si un nombre está libre para ser registrado como marca y, si no, qué clases aún están disponibles. Al final de esta guía, podrás verificar la disponibilidad de marcas registradas y obtener detalles sobre el propietario y la marca utilizando una sola clave API de Zyla API Hub, integrarla en tu aplicación, trabajo de CI o pipeline de moderación, y devolver resultados procesables rápidamente.
Lo que esta API ofrece y cuándo usarla
La API de Búsqueda de Marcas Registradas en Zyla API Hub expone tres endpoints de lectura:
- Búsqueda: busca propietarios por nombre o código postal y recupera sus marcas registradas.
- Disponibilidad de Marca: verifica si una palabra clave está disponible y qué clases de Niza están disponibles o tomadas, con números de serie relacionados.
- Búsqueda de Marca: búsqueda impulsada por palabras clave que devuelve metadatos de registro básicos (estado, propietario, fechas de presentación/registro, etc.).
Las integraciones típicas incluyen la revisión de marcas antes del lanzamiento de un producto, moderación de listados en mercados, controles de pago para nuevos nombres de vendedores y auditorías internas para conflictos entre jurisdicciones y clases.
Comenzando en Zyla API Hub
Abre la página del mercado de la API y suscríbete para obtener tu clave. La autenticación es a través de Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Ve a la página de Iniciar prueba de 7 días en la API de Búsqueda de Marcas Registradas.
- Haz clic en Suscribirse (o Iniciar Prueba Gratuita cuando esté disponible) para obtener una clave API.
- Usa la misma clave en cualquier API de Zyla API Hub. La facturación es por suscripción + cuota, no por llamada. Para esta primera API, puedes comenzar con una prueba de 7 días o 50 solicitudes. Consulta la página de la API para las opciones de acceso y precios actuales.
Endpoints que llamarás
1) Búsqueda
Método: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1236/search
Qué hace: Busca por nombre del propietario o código postal y devuelve detalles sobre las marcas registradas encontradas para ese propietario. Los propietarios duplicados pueden aparecer cuando la dirección de un propietario ha cambiado.
Se requiere autenticación. No se documentan parámetros de solicitud para este ejemplo.
cURL (copiar-pegar):
curl -s -X GET "https://zylalabs.com/api/1495/trademark-search-api/1236/search" \
-H "Authorization: Bearer YOUR_API_KEY"
Respuesta JSON (ejemplo oficial):
{
"count": 1,
"items": [
{
"name": "VIAJO.COM INC.",
"address1": "4225 Executive Square, Suite 325",
"address2": null,
"city": "La Jolla",
"state": "CA",
"country": "US",
"postcode": "92037",
"trademarks": [
{
"keyword": "CLICK Y VIAJA",
"registration_number": "2847107",
"serial_number": "75928638"
}
]
}
]
}
Lo que realmente usarás: count para dimensionar tu conjunto de resultados; los campos de nombre y dirección de cada propietario para confirmar la identidad; y, bajo trademarks, la palabra clave más registration_number y serial_number para verificaciones posteriores o enlaces de UI.
2) Disponibilidad de Marca
Método: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1237/trademark-availability
Qué hace: Devuelve si la palabra clave dada está disponible y lista available_classes, unavailable_classes y serial_numbers relacionados. Se requiere autenticación. No se documentan parámetros de solicitud para este ejemplo.
Usa esto cuando necesites un sí/no y desglose de clases para impulsar decisiones de producto. Por ejemplo, un servicio de nombres podría bloquear la presentación si unavailable_classes se superpone con el conjunto de clases objetivo.
3) Búsqueda de Marca
Método: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1238/trademark-search
Qué hace: Búsqueda por palabra clave que devuelve el nombre de la marca, números de serie y registro, información de estado, detalles del propietario y fechas de presentación/registro. Se requiere autenticación. El comportamiento de SearchType se describe a un alto nivel en la lista, incluyendo un tipo “activo” que excluye marcas muertas; consulta la página de la API para detalles específicos de parámetros.
Usa esto para obtener detalles más ricos: status_label/código/definición, filing_date, registration_date y datos de propietarios para construir una página de perfil completa o un dashboard interno alrededor de una marca candidata.
Código para copiar y pegar
Ejemplo en Python: llamar a Búsqueda y extraer IDs de propietario y marca
Este ejemplo llama al endpoint de Búsqueda, luego imprime el propietario y los números de serie y registro de la primera marca. Utiliza el mismo endpoint que el ejemplo de cURL anterior.
import os
import requests
API_KEY = os.environ.get("ZylaApiKey", "YOUR_API_KEY")
url = "https://zylalabs.com/api/1495/trademark-search-api/1236/search"
headers = {
"Authorization": f"Bearer {API_KEY}",
}
resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
print(f"Total de propietarios: {data.get('count')}")
for owner in data.get("items", []):
print("Propietario:", owner.get("name"))
addr = ", ".join(filter(None, [
owner.get("address1"),
owner.get("address2"),
owner.get("city"),
owner.get("state"),
owner.get("postcode"),
owner.get("country"),
]))
print("Dirección:", addr)
for tm in owner.get("trademarks", []):
print(" - Marca:", tm.get("keyword"))
print(" Número de registro:", tm.get("registration_number"))
print(" Número de serie:", tm.get("serial_number"))
Notas de implementación:
- Auth: siempre incluye Authorization: Bearer YOUR_API_KEY.
- Time outs: establece un tiempo de espera del lado del cliente apropiado para tu carga de trabajo.
- Nullables: algunos campos de dirección pueden ser nulos; elimínalos antes de unir.
- Deduplicación: el endpoint de Búsqueda puede devolver propietarios duplicados cuando las direcciones cambian; deduplica por una clave estable que mantengas (por ejemplo, una combinación de nombre + números de serie que te interesen).
Patrones prácticos para verificaciones de disponibilidad
Cuando necesites una decisión de ir/no ir por clase, llama a Disponibilidad de Marca y usa:
- available: "sí" o "no" para la palabra clave en general.
- available_classes: lista de clases donde la marca aún está disponible.
- unavailable_classes: lista donde existen conflictos.
- serial_numbers: números de serie vinculados a registros o presentaciones conflictivas para auditorías o enlaces de UI.
Flujo típico:
- Acepta una palabra clave de entrada de un formulario o variable de CI.
- Llama a trademark-availability y lee las matrices de available y class.
- Si existe superposición entre clases objetivo y unavailable_classes, bloquea o advierte; de lo contrario, permite la reserva y persiste una decisión con marca de tiempo.
- Opcionalmente, sigue con Búsqueda de Marca para recopilar información de estado y propietario para una UI de desestimación/apelación.
Consejos para manejar respuestas que ahorran tiempo
- Formas de respuesta: Búsqueda devuelve un objeto raíz con count e items; Disponibilidad de Marca devuelve una lista con palabra clave, banderas de disponibilidad, matrices de clase y serial_numbers; Búsqueda de Marca devuelve count e items con campos detallados como status_label y owners.
- Cacheo: si tu UI lo permite, almacena en caché por palabra clave normalizada por períodos cortos para reducir verificaciones repetidas en una sola sesión. Invalida cuando el usuario edita la marca.
- Auditoría: almacena serial_numbers de verificaciones de disponibilidad para que futuras revisiones puedan referirse exactamente a qué presentaciones causaron un conflicto en el momento de la decisión.
Construyendo casos de uso en producción
- Control de nombres de productos: Durante la revisión de PRD, ejecuta disponibilidad para el nombre candidato; si available es "no" o las clases objetivo se intersectan con unavailable_classes, requiere un cambio de nombre antes de los compromisos de diseño.
- Moderación de listados en mercados: Al crear un vendedor o tienda, valida el nombre de tienda propuesto; si surgen conflictos, presenta una razón de denegación incluyendo los primeros números de serie para demostrar conflictos.
- Clasificación del lado del dominio: Combina tu lógica de disponibilidad de dominio con disponibilidad de marcas. Si un dominio está libre pero la marca está tomada en tu clase operativa, bloquea y aconseja alternativas.
- Verificación de CI: En un monorepo, analiza un cambio en los activos de marca, extrae el nombre mostrado y llama a disponibilidad en una Acción de GitHub para fallar la construcción si existen conflictos.
Llamando a la API desde agentes de IA a través de MCP
Si orquestas verificaciones desde herramientas de desarrollador como Claude Code, Cursor o Windsurf, puedes llamar a los mismos endpoints del Hub a través del endpoint compatible con MCP de Zyla. Configura tu cliente para acceder al servicio MCP y proporciona tu clave API según la configuración de MCP de tu cliente. El agente invocará las URL del Hub documentadas anteriormente utilizando tu encabezado de Autorización, por lo que tu código y flujos de trabajo de agentes se mantendrán alineados.
Consideraciones de pruebas y operativas
- Normalización: Normaliza palabras clave (mayúsculas, acentos, puntuación) en tu UI y tus claves de caché para que los usuarios no obtengan respuestas inconsistentes al alternar mayúsculas.
- Duplicados de propietarios: Espera duplicados en los resultados de Búsqueda cuando existan direcciones históricas; deduplica en tu capa de vista.
- Presupuestos de latencia: Las verificaciones del frontend deben usar tiempos de espera cortos del lado del cliente y patrones de UI optimistas; la revisión por lotes en el backend puede acomodar tiempos de espera más largos.
- Cuotas: La API de Búsqueda de Marcas Registradas utiliza suscripción + cuota, no pago por llamada. Comienza con la prueba de 7 días o 50 solicitudes, luego ajusta tu plan según sea necesario en la página de la API.
Referencia: resumen de endpoints
- Búsqueda (GET): https://zylalabs.com/api/1495/trademark-search-api/1236/search
- Disponibilidad de Marca (GET): https://zylalabs.com/api/1495/trademark-search-api/1237/trademark-availability
- Búsqueda de Marca (GET): https://zylalabs.com/api/1495/trademark-search-api/1238/trademark-search
Todos los endpoints requieren un encabezado Authorization: Bearer YOUR_API_KEY. Solo los campos y URLs anteriores están documentados; si necesitas filtros o parámetros adicionales, consulta la página del mercado para actualizaciones.
FAQ
¿Cómo me autentico?
Incluye Authorization: Bearer YOUR_API_KEY en cada encabezado de solicitud a las URL del Hub.
¿Puedo filtrar por clase o jurisdicción en la solicitud?
La lista pública anterior no documenta parámetros de solicitud para estos ejemplos. Usa las available_classes y unavailable_classes de la respuesta de Disponibilidad de Marca para decidir acciones por clase, y consulta la página del mercado de la API para actualizaciones de parámetros.
¿Qué campos me indican si una marca está “activa” o “muerta”?
Usa el endpoint de Búsqueda de Marca y lee status_label, status_code y status_definition en la respuesta. La lista menciona un tipo de SearchType “activo” que excluye marcas muertas; consulta la página de la API para detalles específicos.
¿Hay propietarios duplicados?
Sí. El endpoint de Búsqueda puede devolver entradas de propietarios duplicados, especialmente cuando el propietario ha cambiado de dirección. Deduplica a nivel de negocio según tu lógica.
¿Cuál es el modelo de precios?
Las APIs de Zyla utilizan suscripción + cuota, no pago por llamada. Para esta API puedes comenzar con una prueba de 7 días o 50 solicitudes. Consulta la página del mercado para planes y límites actuales.
¿Listo para integrar esto en tu aplicación y lanzarlo? Obtén tu clave y comienza con la prueba de 7 días en la API de Búsqueda de Marcas Registradas. Una cuenta desbloquea miles de APIs en Zyla API Hub con la misma clave y modelo de suscripción.