> ## 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 de la USPTO
> Marcas federales de EE. UU.: busca unas siete millones de solicitudes y registros por marca, titular, productos y servicios, clase, estado o fecha de radicación, y consulta cualquiera por su número de serie.
La Oficina de Patentes y Marcas de Estados Unidos (USPTO) lleva el registro federal de marcas: toda solicitud radicada desde 1884 y todo registro, con la marca, su estado, las fechas de su vida (radicación, publicación, registro, renovación, abandono o cancelación), las clases y los productos y servicios que cubre, los titulares y el abogado de registro. Croma conserva toda marca viva y toda marca radicada desde 2016 y las mantiene al día con el registro a diario, así que una búsqueda responde en milisegundos.
Busca por cualquier palabra de la marca, el nombre del titular o los productos y servicios, acotando por titular, estado, clase, país del titular, número de registro o fecha de radicación, o consulta una marca por su número de serie.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar marcas
`POST /us/uspto/trademarks-search/v1` Dataset
Una sola búsqueda sobre el registro, por las palabras de la marca, el titular o los productos y servicios, acotada por titular, estado, clase, país o fecha de radicación.
| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales a buscar en la marca, el nombre del titular o los productos y servicios, p. ej. `coffee`, `nintendo`. Deben aparecer todas. |
| `owner` | string | Nombre completo opcional del titular como está registrado, p. ej. `Nintendo of America Inc.`. Mayúsculas y puntuación no importan; usa `query` para parte de un nombre. |
| `status` | enum | Estado opcional: `live` (viva), `dead` (muerta), `registered` (viva y registrada) o `pending` (viva, aún sin registrar). |
| `international_class` | string | Clase de Niza opcional, del 1 al 45, p. ej. `9` (software, electrónica), `25` (ropa), `35` (servicios comerciales). |
| `owner_country` | string | País opcional de la dirección del titular como lo escribe el registro, p. ej. `UNITED STATES`, `COLOMBIA`, `MEXICO`. |
| `registration_number` | string | Número de registro opcional, p. ej. `7726306`. |
| `from_date` | string | Opcional: solo marcas radicadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo marcas radicadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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"
}'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la radicación más reciente a la más antigua. Cada marca incluye `serial_number` (el número de ocho dígitos asignado al radicar), `registration_number` (una vez registrada), `mark` (sus palabras), `mark_types[]` (`TRADEMARK`, `SERVICE MARK`...), `drawing_type`, `status_code` y `status` como los redacta la USPTO, `is_live` e `is_registered`, las fechas `filing_date`, `registration_date`, `publication_date`, `abandonment_date`, `cancellation_date`, `renewal_date`, `first_use_date` y `first_use_in_commerce_date`, `international_classes[]` (clases de Niza de tres dígitos, p. ej. `009`), `goods_and_services[]` (una entrada por clase; en la rara marca cuya lista pasa de 100.000 caracteres cada entrada se acorta, `goods_and_services_truncated` es true y `goods_and_services_url` enlaza la lista completa), `filing_basis[]` (`1a` uso en el comercio, `1b` intención de uso, `44d`, `44e`, `66a` Protocolo de Madrid), `register` (`PRINCIPAL` o `SUPPLEMENTAL`), `owner_names[]`, `owner_entity_type`, `owner_citizenship`, `owner_city`, `owner_state`, `owner_country`, `attorney_name`, `has_assignment` (hay una cesión o una garantía inscrita sobre la marca), `updated_at` (la última actualización de la USPTO) y `official_url` (la página de la marca en la USPTO). Los campos que el registro no indica vienen en null.
La copia contiene toda marca viva y toda marca radicada desde 2016, viva o muerta. Una marca radicada antes de 2016 que ya estaba abandonada o cancelada no se incluye.
## Una marca
`POST /us/uspto/trademark/v1` Dataset
| Campo | Tipo | Notas |
| - | - | - |
| `serial_number` | string | **Obligatorio.** El número de serie de ocho dígitos de la marca, p. ej. `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" }'
```
Devuelve `as_of`, `found`, `serial_number` y `trademark`. Cada marca incluye `serial_number` (el número de ocho dígitos asignado al radicar), `registration_number` (una vez registrada), `mark` (sus palabras), `mark_types[]` (`TRADEMARK`, `SERVICE MARK`...), `drawing_type`, `status_code` y `status` como los redacta la USPTO, `is_live` e `is_registered`, las fechas `filing_date`, `registration_date`, `publication_date`, `abandonment_date`, `cancellation_date`, `renewal_date`, `first_use_date` y `first_use_in_commerce_date`, `international_classes[]` (clases de Niza de tres dígitos, p. ej. `009`), `goods_and_services[]` (una entrada por clase; en la rara marca cuya lista pasa de 100.000 caracteres cada entrada se acorta, `goods_and_services_truncated` es true y `goods_and_services_url` enlaza la lista completa), `filing_basis[]` (`1a` uso en el comercio, `1b` intención de uso, `44d`, `44e`, `66a` Protocolo de Madrid), `register` (`PRINCIPAL` o `SUPPLEMENTAL`), `owner_names[]`, `owner_entity_type`, `owner_citizenship`, `owner_city`, `owner_state`, `owner_country`, `attorney_name`, `has_assignment` (hay una cesión o una garantía inscrita sobre la marca), `updated_at` (la última actualización de la USPTO) y `official_url` (la página de la marca en la USPTO). Los campos que el registro no indica vienen en null.
Un número de serie que la copia no contiene devuelve `found: false` con HTTP 200, no un error.
Fuente: United States Patent and Trademark Office. Obra del gobierno federal de EE. UU., de dominio público. Croma reorganiza los registros en los campos de arriba.
Esquemas, todos los campos de respuesta y un playground interactivo.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.