Você precisa informar a um gerente de produto até sexta-feira se um nome está livre para registro de marca e, se não, quais classes ainda estão disponíveis. Ao final deste guia, você será capaz de verificar a disponibilidade de marcas e obter detalhes sobre proprietários e marcas usando uma única chave de API do Zyla API Hub, integrá-la ao seu aplicativo, trabalho de CI ou pipeline de moderação, e retornar resultados acionáveis rapidamente.
O que esta API entrega e quando usá-la
A API de Pesquisa de Marcas no Zyla API Hub expõe três endpoints de leitura:
- Pesquisa: procure proprietários pelo nome ou código postal e recupere suas marcas registradas.
- Disponibilidade de Marca: verifique se uma palavra-chave está disponível e quais classes de Nice estão disponíveis ou ocupadas, com números de série relacionados.
- Pesquisa de Marca: pesquisa orientada por palavra-chave que retorna metadados de registro principais (status, proprietário, datas de depósito/registro, etc.).
Integrações típicas incluem triagem de marca antes do lançamento de um produto, moderação de listagens em marketplaces, portões de checkout para novos nomes de vendedores e auditorias internas para conflitos entre jurisdições e classes.
Começando no Zyla API Hub
Abra a página do marketplace da API e inscreva-se para obter sua chave. A autenticação é feita via Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Vá para a página Iniciar teste de 7 dias na API de Pesquisa de Marcas.
- Clique em Inscrever-se (ou Iniciar Teste Gratuito quando disponível) para obter uma chave de API.
- Use a mesma chave em qualquer API no Zyla API Hub. A cobrança é por assinatura + cota, não por chamada. Para esta primeira API, você pode começar com um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Endpoints que você chamará
1) Pesquisa
Método: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1236/search
O que faz: Pesquisa pelo nome do proprietário ou código postal e retorna detalhes sobre as marcas encontradas para esse proprietário. Proprietários duplicados podem aparecer quando o endereço de um proprietário muda.
A autenticação é necessária. Nenhum parâmetro de solicitação está documentado para este exemplo.
cURL (copiar-colar):
curl -s -X GET "https://zylalabs.com/api/1495/trademark-search-api/1236/search" \
-H "Authorization: Bearer YOUR_API_KEY"
Resposta JSON (exemplo 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"
}
]
}
]
}
O que você realmente usará: count para dimensionar seu conjunto de resultados; os campos de nome e endereço de cada proprietário para confirmar a identidade; e, sob marcas, a palavra-chave mais registration_number e serial_number para verificações posteriores ou vinculação de UI.
2) Disponibilidade de Marca
Método: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1237/trademark-availability
O que faz: Retorna se a palavra-chave dada está disponível e lista available_classes, unavailable_classes e serial_numbers relacionados. A autenticação é necessária. Nenhum parâmetro de solicitação está documentado para este exemplo.
Use isso quando você precisar de um sim/não e detalhamento de classes para direcionar decisões de produtos. Por exemplo, um serviço de nomeação pode bloquear a submissão se unavailable_classes se sobrepuser ao conjunto de classes-alvo.
3) Pesquisa de Marca
Método: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1238/trademark-search
O que faz: Pesquisa por palavra-chave que retorna nome da marca, números de série e registro, informações de status, detalhes do proprietário e datas de depósito/registro. A autenticação é necessária. O comportamento do SearchType é descrito em alto nível na listagem, incluindo um tipo “ativo” que exclui marcas mortas; consulte a página da API para detalhes dos parâmetros.
Use isso para detalhes mais ricos: status_label/código/definição, filing_date, registration_date e dados dos proprietários para construir uma página de perfil completa ou um painel interno em torno de uma marca candidata.
Código para copiar e colar
Exemplo em Python: chamar Pesquisa e extrair IDs de proprietário e marca
Este exemplo chama o endpoint de Pesquisa, depois imprime o proprietário e os números de série e registro da primeira marca. Ele usa o mesmo endpoint que o exemplo de cURL acima.
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 proprietários: {data.get('count')}")
for owner in data.get("items", []):
print("Proprietário:", 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("Endereço:", addr)
for tm in owner.get("trademarks", []):
print(" - Marca:", tm.get("keyword"))
print(" Registro #:", tm.get("registration_number"))
print(" Serial #:", tm.get("serial_number"))
Notas de implementação:
- Auth: sempre inclua Authorization: Bearer YOUR_API_KEY.
- Time outs: defina um tempo limite do lado do cliente apropriado para sua carga de trabalho.
- Nullables: alguns campos de endereço podem ser nulos; remova-os antes de juntar.
- Deduplicação: o endpoint de Pesquisa pode retornar proprietários duplicados quando os endereços mudam; dedupe por uma chave estável que você mantém (por exemplo, uma combinação de nome + números de série que você se importa).
Padrões práticos para verificações de disponibilidade
Quando você precisa de uma decisão de ir/não ir por classe, chame Disponibilidade de Marca e use:
- available: "sim" ou "não" para a palavra-chave geral.
- available_classes: lista de classes onde a marca ainda está disponível.
- unavailable_classes: lista onde existem conflitos.
- serial_numbers: números de série vinculados a registros ou depósitos conflitantes para auditoria ou links de UI.
Fluxo típico:
- Aceite uma palavra-chave de entrada de um formulário ou variável de CI.
- Chame trademark-availability e leia os arrays disponíveis e de classes.
- Se houver sobreposição entre classes-alvo e unavailable_classes, bloqueie ou avise; caso contrário, permita a reserva e persista uma decisão com timestamp.
- Opcionalmente, siga com a Pesquisa de Marca para reunir informações de status e proprietário para uma UI de rejeição/apelação.
Dicas de manuseio de resposta que economizam tempo
- Formatos de resposta: Pesquisa retorna um objeto raiz com contagem e itens; Disponibilidade de Marca retorna uma lista com palavra-chave, flags de disponibilidade, arrays de classes e serial_numbers; Pesquisa de Marca retorna contagem e itens com campos detalhados como status_label e proprietários.
- Cache: se sua UI permitir, faça cache por palavra-chave normalizada por curtos períodos para reduzir verificações repetidas em uma única sessão. Invalidar quando o usuário editar a marca.
- Auditoria: armazene serial_numbers de verificações de disponibilidade para que futuras revisões possam referenciar exatamente quais depósitos causaram um conflito no momento da decisão.
Construindo casos de uso em produção
- Portão de nomeação de produto: Durante a revisão do PRD, execute a disponibilidade para o nome candidato; se disponível for "não" ou classes-alvo se sobrepuserem a unavailable_classes, exija uma renomeação antes dos compromissos de design.
- Moderação de listagens em marketplaces: Na criação de vendedor ou loja, valide o nome da loja proposto; se surgirem conflitos, apresente uma razão de negação incluindo os primeiros números de série para demonstrar conflitos.
- Triagem do lado do domínio: Combine sua lógica de disponibilidade de domínio com a disponibilidade de marcas. Se um domínio estiver livre, mas a marca estiver registrada em sua classe de operação, bloqueie e sugira alternativas.
- Verificação de CI: Em um monorepo, analise uma alteração nos ativos de branding, extraia o nome exibido e chame a disponibilidade em uma Ação do GitHub para falhar a construção se conflitos existirem.
Chamando a API de agentes de IA via MCP
Se você orquestrar verificações a partir de ferramentas de desenvolvedor como Claude Code, Cursor ou Windsurf, você pode chamar os mesmos endpoints do Hub através do endpoint compatível com MCP do Zyla. Configure seu cliente para acessar o MCP e forneça sua chave de API conforme a configuração do MCP do seu cliente. O agente invocará as URLs do Hub documentadas acima usando seu cabeçalho de Autorização, para que seu código e fluxos de trabalho de agente permaneçam alinhados.
Considerações de teste e operacionais
- Normalização: Normalize palavras-chave (case, acentos, pontuação) em sua UI e suas chaves de cache para que os usuários não recebam respostas inconsistentes ao alternar o case.
- Proprietários duplicados: Espere duplicatas nos resultados de Pesquisa quando endereços históricos existirem; dedupe em sua camada de visualização.
- Orçamentos de latência: Verificações de frontend devem usar tempos limite curtos do lado do cliente e padrões de UI otimistas; triagem em lote no backend pode acomodar tempos limite mais longos.
- Cotas: A API de Pesquisa de Marcas usa assinatura + cota, não pagamento por chamada. Comece com o teste de 7 dias ou 50 solicitações, depois ajuste seu plano conforme necessário na página da API.
Referência: resumo dos endpoints
- Pesquisa (GET): https://zylalabs.com/api/1495/trademark-search-api/1236/search
- Disponibilidade de Marca (GET): https://zylalabs.com/api/1495/trademark-search-api/1237/trademark-availability
- Pesquisa de Marca (GET): https://zylalabs.com/api/1495/trademark-search-api/1238/trademark-search
Todos os endpoints requerem um cabeçalho Authorization: Bearer YOUR_API_KEY. Somente os campos e URLs acima estão documentados; se você precisar de filtros ou parâmetros adicionais, verifique a página do marketplace para atualizações.
FAQ
Como faço para autenticar?
Inclua Authorization: Bearer YOUR_API_KEY em cada cabeçalho de solicitação para as URLs do Hub.
Posso filtrar por classe ou jurisdição na solicitação?
A listagem pública acima não documenta parâmetros de solicitação para esses exemplos. Use os available_classes e unavailable_classes da resposta de Disponibilidade de Marca para decidir ações por classe, e verifique a página do marketplace da API para atualizações de parâmetros.
Quais campos me dizem se uma marca está “ativa” ou “morta”?
Use o endpoint de Pesquisa de Marca e leia status_label, status_code e status_definition na resposta. A listagem observa um SearchType “ativo” que exclui marcas mortas; consulte a página da API para detalhes.
Existem proprietários duplicados?
Sim. O endpoint de Pesquisa pode retornar entradas de proprietários duplicados, especialmente quando o proprietário mudou de endereço. Deduplica a jusante com base na sua lógica de negócios.
Qual é o modelo de preços?
As APIs Zyla usam assinatura + cota, não pagamento por chamada. Para esta API, você pode começar com um teste de 7 dias ou 50 solicitações. Veja a página do marketplace para planos e limites atuais.
Pronto para integrar isso ao seu aplicativo e enviar? Obtenha sua chave e comece com o teste de 7 dias na API de Pesquisa de Marcas. Uma conta desbloqueia milhares de APIs no Zyla API Hub com a mesma chave e modelo de assinatura.