API OCR para documentos brasileiros: guia completo

O que é OCR de documentos e por que é importante?

OCR (Optical Character Recognition) é a tecnologia que transforma texto em imagens — como documentos escaneados, fotos e PDFs — em dados digitais editáveis e pesquisáveis. Para empresas brasileiras que lidam com grandes volumes de documentos, o OCR é a diferença entre processar centenas de documentos por dia ou ficar preso em digitação manual.

No Brasil, a digitalização de processos tem acelerado significativamente. Cartórios, fintechs, escritórios de advocacia e empresas de RH precisam extrair dados de documentos como as certidões de nascimento e de casamento em escala. O problema? A maioria das soluções de OCR genéricas não foi projetada para lidar com as particularidades dos documentos brasileiros.

Como o DocsOCR funciona

O DocsOCR é uma API REST especializada em documentos brasileiros, feita para os modelos oficiais das certidões de nascimento e de casamento.

Três motores de IA com fallback

O sistema utiliza três motores de IA com fallback automático:

Mini (Equilibrado): motor padrão, para alto volume
Large (Preciso): motor padrão, otimizado para a precisão na extração de campos
Fast (Rápido): o motor que a requisição pode pedir com "engine": "fast"; ele é tentado primeiro, pelo preço dele

Mini e Large são os motores padrão, que respondem toda requisição por padrão. Quando um motor falha com um documento, ou está indisponível, o sistema tenta automaticamente o próximo, sem intervenção manual. Se nenhum conseguir responder, a resposta vem com status 201, success: false e um errorCode, sem custo: envie de novo mais tarde.

Fluxo de processamento

Envio: Você envia a imagem da certidão via API (URL ou Base64)
Extração: Os motores de IA leem a certidão e extraem os campos
Resposta: os dados voltam em JSON estruturado, na mesma requisição

Custo de cada motor

Uma extração paga o preço do motor que a responde, sem nada a mais quando o sistema troca de motor porque um deles está indisponível. A lista de preços da API informa cada preço, por documento e por motor, em GET /documents/prices. A velocidade é escolha sua: a requisição pode pedir o motor fast com "engine": "fast" e, então, paga o preço do fast quando o fast responde. Se o fast não conseguir responder, um motor padrão responde, pelo preço padrão. E você paga só pelos dados extraídos: uma requisição recusada, ou que nenhum motor conseguiu atender, não custa nada.

A qualidade da imagem faz diferença. Uma foto reta, nítida e bem iluminada da página inteira dá os melhores resultados; fotos pequenas ou borradas podem perder acentos e dígitos.

Documentos suportados

Atualmente, o DocsOCR oferece extração completa para certidões de nascimento e de casamento brasileiras.

Da certidão de nascimento:

Nome completo do registrado
Data de nascimento
Local de nascimento (cidade e estado)
Nomes dos pais
Número do registro e matrícula
Nome do cartório emissor
Data de emissão
Dados complementares (avós, observações)

Da certidão de casamento:

Os dois cônjuges, na ordem em que a certidão os imprime: nomes, CPF, data de nascimento, nacionalidade, estado civil, naturalidade e genitores
O casamento: o tipo, a data da celebração, o regime de bens e a data do registro
A matrícula, o livro, a folha e o termo
As averbações e as anotações
O cartório emissor e a autenticação

Mais tipos de documentos em breve.

Primeiros passos com a API

Começar a usar o DocsOCR é simples:

1. Crie sua conta

Acesse o painel administrativo e crie uma conta gratuita. Você receberá créditos de boas-vindas para testar a API imediatamente — sem necessidade de cartão de crédito.

2. Gere uma chave de API

No painel, navegue até a seção de chaves de API e gere sua primeira chave. Guarde-a em local seguro.

3. Faça sua primeira chamada

Guarde a chave na variável de ambiente DOCSOCR_API_KEY e rode este exemplo em Python:

"""Your first call: extract the hosted sample certificate (fictitious data).

Needs the requests package and DOCSOCR_API_KEY in the environment.
"""
import os
import uuid

import requests

response = requests.post(
    "https://api.docsocr.com/api/v1/documents/birth-certificate",
    headers={"Authorization": f"Bearer {os.environ['DOCSOCR_API_KEY']}"},
    json={
        "imageType": "url",
        "imageUrl": "https://docsocr.com/samples/certidao-nascimento-exemplo.jpg",
        "requestId": str(uuid.uuid4()),  # one id per document
    },
    timeout=120,  # above the API's 90 s extraction budget
)
answer = response.json()
if response.status_code != 201 or not answer["success"]:
    raise SystemExit(f"{response.status_code} {answer.get('errorCode', '')} {answer.get('message') or answer.get('error')}")
print(answer["data"]["dados_pessoais"]["nome_completo"])

Ou com cURL:

#!/usr/bin/env bash
# Your first call: extract the hosted sample certificate (fictitious data).
# Needs DOCSOCR_API_KEY in the environment; create a key in the panel.
set -euo pipefail

REQUEST_ID="first-call-$(date +%s)-$RANDOM" # one id per document

# The API answers within 90 s
curl -sS --max-time 120 https://api.docsocr.com/api/v1/documents/birth-certificate \
  -H "Authorization: Bearer $DOCSOCR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<EOF
{
  "imageType": "url",
  "imageUrl": "https://docsocr.com/samples/certidao-nascimento-exemplo.jpg",
  "requestId": "$REQUEST_ID"
}
EOF

A resposta inclui todos os campos extraídos em formato JSON estruturado, pronto para ser integrado ao seu sistema.

Os exemplos usam uma certidão fictícia que hospedamos para testes. Para os seus documentos, troque a URL ou envie a imagem em Base64. Cada requisição leva o seu próprio requestId. Os mesmos exemplos, e mais cinco (arquivo local, resizeImage, motor fast, erros e preços), estão na documentação, em seis linguagens.

Formatos aceitos

O DocsOCR aceita os seguintes formatos de arquivo:

PDF* — documentos digitais ou escaneados
JPG/JPEG — fotos e digitalizações
PNG — imagens com ou sem transparência
WebP — imagens compactadas, comuns na web e em celulares Android
GIF — imagens estáticas

*Lemos apenas a primeira página do PDF.

O tamanho máximo por arquivo é de 10 MB. Você pode enviar o documento como URL pública ou codificado em Base64 no corpo da requisição.

Nosso padrão de imagem é de 1344 a 2048 px no lado maior, onde a extração lê melhor. Uma imagem fora dele é recusada sem custo ou, se a requisição usar resizeImage: true, redimensionada do nosso lado pelo preço do redimensionamento (veja a lista de preços), o que soma um pouco de tempo à resposta. Para a resposta mais rápida e barata, redimensione antes de enviar: uma foto de celular com 2048 px no lado maior é suficiente.

Se a imagem não puder ser usada, ou se a URL não puder ser baixada, a API responde com o código HTTP 422, um errorCode que informa a causa (por exemplo IMAGE_TOO_LARGE) e uma mensagem que explica a causa e como corrigir: por exemplo, usar um link público e direto para o arquivo ou enviar a imagem em Base64. Para receber as mensagens em português, envie o cabeçalho Accept-Language: pt-BR.

Preços e créditos gratuitos

O DocsOCR utiliza um modelo de créditos pay-as-you-go:

Cada extração que retorna dados custa o preço do motor que a responde, como informa a lista de preços; uma requisição recusada, ou que nenhum motor conseguiu atender, é gratuita
Contas novas recebem créditos gratuitos para testar com documentos reais
Não é necessário cartão de crédito para começar
Planos mensais e anuais disponíveis, com descontos progressivos por volume

O modelo pay-as-you-go garante que você pague apenas pelo que usar, sem custos fixos elevados ou surpresas na fatura.

Segurança e conformidade

A segurança dos dados é prioridade máxima:

LGPD, GDPR e CCPA: 100% compatível com as principais legislações de proteção de dados
Processamento em tempo real: Imagens de documentos não são armazenadas após a extração
Criptografia TLS: Toda comunicação é criptografada em trânsito
Chaves de API por workspace: você pode revogar uma chave a qualquer momento no painel

Próximos passos

Pronto para automatizar o processamento de documentos na sua empresa?

Crie sua conta gratuita e receba créditos de boas-vindas
Explore a documentação interativa e os exemplos em seis linguagens
Teste com documentos reais usando os créditos gratuitos
Integre ao seu sistema e comece a escalar

O DocsOCR foi construído para empresas brasileiras que precisam de OCR que simplesmente funciona. Sem configuração complexa, sem projetos longos de integração — apenas uma API simples que transforma documentos em dados estruturados.