> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Marcas da USPTO
> Marcas federais dos EUA: busque cerca de sete milhões de pedidos e registros por marca, titular, produtos e serviços, classe, situação ou data de depósito, e consulte qualquer um pelo número de série.
O Escritório de Patentes e Marcas dos Estados Unidos (USPTO) mantém o registro federal de marcas: todo pedido depositado desde 1884 e todo registro, com a marca, sua situação, as datas da sua vida (depósito, publicação, registro, renovação, abandono ou cancelamento), as classes e os produtos e serviços que cobre, os titulares e o advogado constituído. A Croma mantém toda marca ativa e toda marca depositada desde 2016 e as atualiza com o registro diariamente, então uma busca responde em milissegundos.
Busque por qualquer palavra da marca, o nome do titular ou os produtos e serviços, restringindo por titular, situação, classe, país do titular, número de registro ou data de depósito, ou consulte uma marca pelo número de série.
A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
## Buscar marcas
`POST /us/uspto/trademarks-search/v1` Dataset
Uma única busca sobre o registro, pelas palavras da marca, o titular ou os produtos e serviços, restringida por titular, situação, classe, país ou data de depósito.
| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais a buscar na marca, no nome do titular ou nos produtos e serviços, p. ex. `coffee`, `nintendo`. Todas devem aparecer. |
| `owner` | string | Nome completo opcional do titular como registrado, p. ex. `Nintendo of America Inc.`. Maiúsculas e pontuação não importam; use `query` para parte de um nome. |
| `status` | enum | Situação opcional: `live` (ativa), `dead` (extinta), `registered` (ativa e registrada) ou `pending` (ativa, ainda não registrada). |
| `international_class` | string | Classe de Nice opcional, de 1 a 45, p. ex. `9` (software, eletrônicos), `25` (vestuário), `35` (serviços comerciais). |
| `owner_country` | string | País opcional do endereço do titular como o registro o escreve, p. ex. `UNITED STATES`, `COLOMBIA`, `MEXICO`. |
| `registration_number` | string | Número de registro opcional, p. ex. `7726306`. |
| `from_date` | string | Opcional: só marcas depositadas nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só marcas depositadas nesta data ou antes, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `20`. |
```bash theme={"dark"}
curl https://api.croma.run/us/uspto/trademarks-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "nintendo",
"status": "registered",
"international_class": "9"
}'
```
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, do depósito mais recente ao mais antigo. Cada marca traz `serial_number` (o número de oito dígitos atribuído no depósito), `registration_number` (uma vez registrada), `mark` (suas palavras), `mark_types[]` (`TRADEMARK`, `SERVICE MARK`...), `drawing_type`, `status_code` e `status` como a USPTO os redige, `is_live` e `is_registered`, as datas `filing_date`, `registration_date`, `publication_date`, `abandonment_date`, `cancellation_date`, `renewal_date`, `first_use_date` e `first_use_in_commerce_date`, `international_classes[]` (classes de Nice com três dígitos, p. ex. `009`), `goods_and_services[]` (uma entrada por classe; na rara marca cuja lista passa de 100.000 caracteres cada entrada é encurtada, `goods_and_services_truncated` é true e `goods_and_services_url` aponta para a lista completa), `filing_basis[]` (`1a` uso no comércio, `1b` intenção de uso, `44d`, `44e`, `66a` Protocolo de Madri), `register` (`PRINCIPAL` ou `SUPPLEMENTAL`), `owner_names[]`, `owner_entity_type`, `owner_citizenship`, `owner_city`, `owner_state`, `owner_country`, `attorney_name`, `has_assignment` (há uma cessão ou uma garantia registrada sobre a marca), `updated_at` (a última atualização da USPTO) e `official_url` (a página da marca na USPTO). Os campos que o registro não indica vêm como null.
A cópia contém toda marca ativa e toda marca depositada desde 2016, ativa ou extinta. Uma marca depositada antes de 2016 que já estava abandonada ou cancelada não está incluída.
## Uma marca
`POST /us/uspto/trademark/v1` Dataset
| Campo | Tipo | Notas |
| - | - | - |
| `serial_number` | string | **Obrigatório.** O número de série de oito dígitos da marca, p. ex. `79392077`. |
```bash theme={"dark"}
curl https://api.croma.run/us/uspto/trademark/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "serial_number": "79392077" }'
```
Retorna `as_of`, `found`, `serial_number` e `trademark`. Cada marca traz `serial_number` (o número de oito dígitos atribuído no depósito), `registration_number` (uma vez registrada), `mark` (suas palavras), `mark_types[]` (`TRADEMARK`, `SERVICE MARK`...), `drawing_type`, `status_code` e `status` como a USPTO os redige, `is_live` e `is_registered`, as datas `filing_date`, `registration_date`, `publication_date`, `abandonment_date`, `cancellation_date`, `renewal_date`, `first_use_date` e `first_use_in_commerce_date`, `international_classes[]` (classes de Nice com três dígitos, p. ex. `009`), `goods_and_services[]` (uma entrada por classe; na rara marca cuja lista passa de 100.000 caracteres cada entrada é encurtada, `goods_and_services_truncated` é true e `goods_and_services_url` aponta para a lista completa), `filing_basis[]` (`1a` uso no comércio, `1b` intenção de uso, `44d`, `44e`, `66a` Protocolo de Madri), `register` (`PRINCIPAL` ou `SUPPLEMENTAL`), `owner_names[]`, `owner_entity_type`, `owner_citizenship`, `owner_city`, `owner_state`, `owner_country`, `attorney_name`, `has_assignment` (há uma cessão ou uma garantia registrada sobre a marca), `updated_at` (a última atualização da USPTO) e `official_url` (a página da marca na USPTO). Os campos que o registro não indica vêm como null.
Um número de série que a cópia não contém retorna `found: false` com HTTP 200, não um erro.
Fonte: United States Patent and Trademark Office. Obra do governo federal dos EUA, em domínio público. A Croma reorganiza os registros nos campos acima.
Esquemas, todos os campos de resposta e um playground interativo.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.