Este artículo es la parte de referencia de la comprobación de marcas: los endpoints, los parámetros y los campos. El flujo paso a paso para un vendedor que comprueba un nombre está en comprobar marcas antes de publicar.
Un límite se aplica a todo lo que sigue: una búsqueda por API es un filtro previo, no una autorización de uso. Devuelve registros de una base de datos. No juzga si dos marcas son confundibles y no sustituye a un abogado o agente de marcas.
Cuatro endpoints
| Endpoint | Ruta | Qué hace |
|---|---|---|
| Cobertura de datos | /v1/global/brand/range | Lista los códigos de oficina que usan los datos |
| Búsqueda de marcas | /v1/global/brand/list | Encuentra registros por texto, con filtros |
| Detalle de marca | /v1/global/brand/detail | Devuelve un registro completo, por su id |
| Estadísticas de marcas | /v1/global/brand/stats | Cuenta los registros coincidentes por oficina, estado, clase y más |
Cada llamada correcta consume una unidad de facturación.
Códigos de oficina
Toda consulta se acota con office. Los códigos son en su mayoría códigos de país de dos letras, con algunos que no son países:
| Código | Oficina |
|---|---|
US, JP, GB, DE, CA, AU… | Oficinas nacionales |
EM | La Unión Europea |
WO | Registros internacionales administrados por la OMPI |
El endpoint de cobertura devolvió unos 250 códigos cuando lo llamamos el 12 de octubre de 2026. Dos cosas que conviene saber sobre esa lista:
- Que un código figure en la lista no dice nada sobre su exhaustividad. Indica que el código es válido, no lo actualizados o completos que están los registros de esa oficina. Prueba una oficina con una marca que ya conozcas antes de fiarte de ella.
officeLabelllega en chino. Usa el códigoofficeen tu propio código y en tu interfaz.
Para un vendedor, las oficinas que importan son las que están detrás de los marketplaces en los que vende. Un nombre puede estar libre en US y ocupado en EM.
Filtros de búsqueda
text es el único parámetro obligatorio. Todo lo demás acota el resultado:
| Parámetro | Tipo | Uso |
|---|---|---|
text | String | Las palabras que se buscan |
office | Array | Uno o varios códigos de oficina |
status | Array | Estado del registro, como Registered o Pending |
niceClass | Array | Clases de productos y servicios, como números |
applicant | Array | Quién presentó la solicitud |
brandName | Array | Un nombre de marca exacto |
applicationYear, expiryYear | Array | Años, como cadenas |
order | Object | field y desc |
returnFields | String | Campos que se devuelven, separados por comas, para reducir la respuesta |
page, size | Integer | Paginación |
curl --request POST \
--url https://ecommercedataapi.com/v1/global/brand/list \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"office": ["US", "EM"],
"text": "AURORA",
"status": ["Registered", "Pending"],
"niceClass": [11],
"page": 1,
"size": 20
}'La búsqueda también acepta una imagen en imageBase64. No la hemos probado para este artículo, así que pruébala con un logotipo que conozcas antes de basarte en ella.
Por qué status necesita más de un valor
Cuenta primero y busca después. El endpoint de estadísticas muestra cómo se reparten los registros antes de que los recorras página a página:
curl --request POST \
--url https://ecommercedataapi.com/v1/global/brand/stats \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"office": ["US", "EM", "JP"],
"text": "AURORA",
"returnFields": "office,status,niceClass"
}'El 12 de octubre de 2026, esa petición devolvió 2.679 registros:
| Por oficina | Recuento | Por estado | Recuento |
|---|---|---|---|
US | 2.063 | Ended | 1.419 |
EM | 391 | Registered | 897 |
JP | 225 | Pending | 227 |
Expired | 136 |
De una sola llamada salen dos lecturas:
- Más de la mitad de los registros ya no están vigentes (
EndedoExpired). El número bruto de coincidencias exagera el obstáculo. - Filtrar solo por
Registeredoculta 227 solicitudes pendientes. Una solicitud pendiente puede convertirse en registro, así que una primera pasada debería incluirla.
Leer un registro
| Campo | Significado |
|---|---|
id | El identificador del registro. Envíalo como brandId al endpoint de detalle |
brandName | El texto de la marca |
applicant, applicantCountryCode | Quién presentó la solicitud y desde dónde |
applicationDate, applicationNumber | Cuándo se presentó y con qué número |
registrationNumber | Presente una vez registrada |
status, statusDate | Estado actual y cuándo cambió por última vez |
niceClass | Las clases que cubre la marca |
markFeature | El tipo de marca, como Combined para palabras más un diseño |
office, designatedCountries | La oficina y, en los registros internacionales, los países designados |
El endpoint de detalle añade las descripciones de productos y servicios, el historial de eventos y la fecha de vencimiento de un registro. Los números de clase se explican en clases de marcas para vendedores de Amazon.
Lo que la API no hace
No juzga la similitud. Una búsqueda de texto encuentra palabras coincidentes. Las marcas pueden entrar en conflicto por sonido, aspecto o significado sin compartir grafía.
No evalúa el conflicto de clases. Informa de qué clases cubre un registro. Si tus productos entran en conflicto es una cuestión jurídica.
Va por detrás de las oficinas. La publicación y la carga de datos llevan tiempo, así que una solicitud reciente puede no aparecer todavía.
No es el registro de marcas de un marketplace. El registro de marcas de Amazon tiene sus propios requisitos.
Preguntas frecuentes
¿Es una API oficial de una oficina de marcas? No. Es una búsqueda sobre registros de muchas oficinas a través de una sola interfaz. Cada oficina tiene además su propia herramienta de búsqueda, que sigue siendo la autoridad sobre su registro.
¿Cuántas llamadas requiere un nombre? Una llamada de estadísticas para ver el reparto, una búsqueda por cada conjunto de filtros y una llamada de detalle por cada registro que abras.
¿Puedo buscar en varias oficinas a la vez?
Sí. office es un array.
¿Dónde encaja entre las API relacionadas con Amazon? Es uno de los grupos de endpoints recogidos en las API de Amazon, explicadas, junto a productos, palabras clave y mercados.