POST

`products.brands`

Marcas ativas com produtos ativos, contagem por marca e ordenação alfabética.

Grupo: CatálogoRevisão: 2026-10-02Escopo recomendado: products.brands

Exemplos seguros e fictícios. O domínio example.invalid e a credencial demonstrativa abaixo não funcionam. Use o token real somente no servidor da sua integração e nunca o inclua em páginas públicas.

Parâmetros

Este método não exige parâmetros no corpo da requisição.

Exemplos fictícios

Os exemplos documentam o formato; eles não executam nenhuma operação.

Requisição

cURL demonstrativo

curl --request POST \
  'https://example.invalid/api/v1/CREDENCIAL_FICTICIA_SEM_VALOR/products.brands' \
  --header 'Content-Type: application/json' \
  --data '{}'

Corpo JSON

{}

Resposta HTTP 200

{
  "ok": true,
  "method": "products.brands",
  "result": {
    "marcas": [
      {
        "marca_id": "22222222-2222-4222-8222-222222222222",
        "marca": "Marca exemplo",
        "total": 1
      }
    ]
  }
}

Erros

Condições de erro específicas de products.brands
HTTP	Código	Condição
403	`TOKEN_NO_COMPANY`	Token sem empresa associada.

Consulte também os erros globais e limites.

Observações

Com Tiny conectado, considera apenas produtos de fonte tiny.
Marcas configuradas como ocultas não são devolvidas.
Use o campo marca, não marca_id, no filtro de products.list/search.