← Tabela Cutter

API do Tabela Cutter

Para bibliotecas e instituições que querem gerar o código Cutter-Sanborn automaticamente, por exemplo no gerador de ficha catalográfica. A API usa o mesmo gerador do site, com as mesmas regras (metodologia versão 1.0).

Consulta

GET https://www.tabelacutter.com/api/v1/cutter

Parâmetro	Obrigatório	O que é
`entrada`	Sim	Entrada principal: Sobrenome, Prenome do autor ou, sem autor, o título da obra.
`complemento`	Não	Título da obra, para a letra da obra no fim do código. Deixe em branco quando a entrada principal já for o título.
`formato`	Não	`texto` devolve só o código, em texto simples. Sem o parâmetro, a resposta vem em JSON.

Exemplo

curl "https://www.tabelacutter.com/api/v1/cutter?entrada=Saint-Exup%C3%A9ry%2C%20Antoine%20de&complemento=O%20pequeno%20pr%C3%ADncipe"

{
  "codigo": "S137p",
  "letra": "S",
  "numero": "137",
  "letraObra": "p",
  "entrada": "Saint-Exupéry, Antoine de",
  "complemento": "O pequeno príncipe",
  "entradaNormalizada": "SAINT EXUPERY, ANTOINE DE",
  "linhaUsada": { "parte": "Saint E", "numero": "137" },
  "linhaSeguinte": { "parte": "Saint F", "numero": "138" },
  "trilha": [
    { "etapa": "entrada", "regra": "nbr6033-3.1", "tipo": "norma", "texto": "Letras com acento ou sinal foram consideradas pela letra base." },
    { "etapa": "entrada", "regra": "conv-hifen", "tipo": "convencao", "texto": "O hífen foi tratado como separação de palavras." },
    { "etapa": "busca", "regra": "tabela-2", "tipo": "regra-tabela", "texto": "“SAINT EXUPERY, ANTOINE DE” não consta da tabela; vale a entrada imediatamente anterior, “Saint E” (137)." },
    { "etapa": "obra", "regra": "nbr6033-3.4", "tipo": "norma", "texto": "O artigo inicial “O” foi desconsiderado." },
    { "etapa": "obra", "regra": "tabela-5", "tipo": "regra-tabela", "texto": "Letra da obra “p”, de “pequeno”." }
  ],
  "avisos": [],
  "metodologia": { "versao": "1.0" },
  "referencia": "EVEN3. Tabela Cutter: gerador de código Cutter-Sanborn. ..."
}

Campos da resposta

codigo: o código completo. letra, numero e letraObra são as partes dele.
entradaNormalizada: a entrada como foi comparada com a tabela (sem acento, em maiúsculas, número por extenso).
linhaUsada e linhaSeguinte: a linha da tabela que deu o número e a que vem depois.
trilha: cada regra aplicada, com o tipo: regra-tabela (instruções da própria tabela), norma (ABNT), pratica (prática de notação de autor) ou convencao (convenção da Even3 para pontos sem regra escrita).
avisos: pontos para conferir, como entrada que parece nome em ordem direta.
referencia: referência da ferramenta em ABNT, com a data da consulta.

Planilhas

Google Planilhas, com a entrada na célula A2:

=IMPORTDATA("https://www.tabelacutter.com/api/v1/cutter?formato=texto&entrada=" & ENCODEURL(A2))

Excel para Windows:

=WEBSERVICE("https://www.tabelacutter.com/api/v1/cutter?formato=texto&entrada=" & ENCODEURL(A2))

JavaScript e Python

const resposta = await fetch("https://www.tabelacutter.com/api/v1/cutter?" +
  new URLSearchParams({ entrada: "Silva, José", complemento: "A conferência" }));
const { codigo } = await resposta.json();   // "S586c"

import requests
resposta = requests.get("https://www.tabelacutter.com/api/v1/cutter",
                        params={"entrada": "Silva, José", "complemento": "A conferência"})
print(resposta.json()["codigo"])   # S586c

Erros e limites

400: entrada ausente, com mais de 300 caracteres, sem letra de A a Z no início ou começando por número cujo gênero muda o código (2: dois ou duas) ou por algarismo romano, que precisam vir por extenso. A resposta traz erro e campo.
429: mais de 60 consultas por minuto do mesmo endereço IP. Espere um minuto e tente de novo.
500: falha temporária do serviço.

A API é gratuita e não exige chave. As consultas são registradas pela Even3 para acompanhar o uso do serviço.

Contrato

Descrição no formato OpenAPI 3: /api/v1/openapi.json.

Como citar

EVEN3. Tabela Cutter: gerador de código Cutter-Sanborn. Versão 1.0. Recife, 2026. Disponível em: https://www.tabelacutter.com. Acesso em: 25 out. 2026.