DocX API

DocxAPI — gere arquivos .docx formatados direto do n8n com uma requisição HTTP

Índice

Se você usa n8n pra automação, já deve ter esbarrado nesse problema: seu workflow coleta dados, processa, roteia tudo bonito… mas na hora de gerar um documento formatado pra enviar pro cliente, quebra tudo.

Google Docs API? OAuth complexo, tabelas que perdem formatação, estilos que quebram silenciosamente entre versões. Converter HTML pra DOCX? Imagens somem, headers desaparecem, fontes resetam. Copiar e colar do n8n pra um template Word? Aí a automação perdeu o sentido.

Construí o DocxAPI pra resolver isso. É uma API REST que recebe Markdown, HTML ou JSON e devolve um .docx formatado. Um endpoint. Uma requisição. Um documento pronto.

50 documentos por mês no plano gratuito. Sem cartão de crédito.

O que é

DocxAPI é um serviço que converte conteúdo textual em arquivos .docx com formatação profissional: headings, tabelas, negrito, itálico, listas, imagens — tudo renderizado corretamente.

  • Endpoint: POST https://api.searchops.io/v1/generate
  • Input: Markdown, HTML ou JSON estruturado
  • Output: arquivo .docx (binário, base64 ou URL de download)
  • Tempo médio: < 2 segundos

O backend usa Pandoc como engine de conversão. Você não precisa saber nada sobre Pandoc — só manda o conteúdo e recebe o documento.

1. Criar conta e obter a API key

  1. Acesse https://api.searchops.io/
  2. Faça login com Google
  3. No painel, clique em “+ Create new API Key”
  4. Informe um label (ex: “Meu n8n”) e o domínio da sua instância n8n
  5. Copie a key gerada (sk_live_...) — ela só aparece uma vez

2. Configurar no n8n

Adicione um nó HTTP Request no seu workflow:

CampoValor
MethodPOST
URLhttps://api.searchops.io/v1/generate
Headerx-api-key: sua key sk_live_...
Body typeJSON
ResponseFile

Parâmetros do body

ParâmetroObrigatórioValoresDescrição
inputSimmarkdown, html, jsonFormato do conteúdo enviado
contentSimstringO conteúdo a ser convertido
formatNãofile, base64, urlComo receber o documento (default: base64)

3. Formatos de resposta

formatO que retornaQuando usar
fileBinário .docx direton8n com response “File” → encaminhar para Drive, email, etc.
urlLink de download (válido 24h)Compartilhar via mensagem, webhook, etc.
base64JSON com o arquivo em base64Processamento programático

Para n8n, o ideal é "format": "file" com a opção de resposta do nó configurada como File.

4. Exemplo prático — Markdown para .docx

Body enviado no HTTP Request:

{
  "input": "markdown",
  "content": "# Relatório Mensal\n\n## Resumo\n\nFaturamento total: **R$ 62.250**\n\n| Mês | Receita |\n|-----|--------|\n| Jan | R$ 21.000 |\n| Fev | R$ 19.000 |\n| Mar | R$ 22.250 |\n\n### Observações\n\n- Meta atingida em todos os meses\n- Crescimento de **12%** vs trimestre anterior",
  "format": "file"
}

O que gera: um .docx com heading, tabela formatada, negrito e lista. Pronto pra abrir no Google Docs ou Word.

5. Exemplo com HTML

Se o seu workflow já renderiza conteúdo em HTML (relatórios, propostas, emails), manda direto:

{
  "input": "html",
  "content": "<h1>Proposta Comercial</h1><p>Prezado cliente,</p><p>Segue nossa proposta para o projeto <strong>XYZ</strong>.</p><table><tr><th>Item</th><th>Valor</th></tr><tr><td>Desenvolvimento</td><td>R$ 15.000</td></tr><tr><td>Manutenção</td><td>R$ 2.000/mês</td></tr></table>",
  "format": "file"
}

Estilos, tabelas e formatação são preservados na conversão.

6. Nó pronto pra colar no n8n

No painel do DocxAPI (api.searchops.io/dashboard), na seção Quick Start, aba n8n, tem um botão “Copy ready-to-paste node”.

Ele copia o JSON do nó já configurado com sua API key. Basta colar no canvas do n8n com Ctrl+V.

Sem configurar nada manualmente.

7. Fluxo típico no n8n

[Trigger] → [Processar dados] → [HTTP Request: DocxAPI] → [Google Drive / Email / Webhook]

O nó DocxAPI recebe o Markdown ou HTML do nó anterior via expressão (ex: {{ $json.conteudo }}) e devolve o .docx como arquivo binário. Dali pra frente, qualquer nó que aceite arquivo funciona: Google Drive, Gmail, Telegram, Webhook, etc.

Casos de uso reais

  • Relatório SEO mensal — workflow puxa dados do Search Console, monta o relatório em Markdown, gera o .docx e envia pro Drive do cliente
  • Contrato de serviço — cliente preenche formulário, n8n monta o contrato com os dados e gera o documento pronto pra assinatura
  • Conteúdo de IA para aprovação — agente gera texto em Markdown, DocxAPI converte pra .docx formatado que o cliente pode revisar com tracked changes
  • Documentação técnica — políticas de segurança, checklists de compliance, guias de onboarding

8. Teste rápido via cURL

Se quiser testar antes de montar o workflow:

curl -X POST https://api.searchops.io/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_live_sua_key_aqui" \
  -d '{"input":"markdown","content":"# Teste\n\nFuncionou!","format":"file"}' \
  --output teste.docx

Se gerar o arquivo teste.docx, está tudo funcionando.

Pricing

PlanoPreçoDocs/mês
Free$050
Starter$9/mês200
Pro$29/mês1.000
Agency$59/mês3.000

Também tem a opção de comprar créditos avulsos ($0.05/doc) sem assinar plano.

Todos os planos incluem todos os formatos de input e todas as opções de formatação. A diferença é o volume.

DocxAPI é um produto da SearchOps, agência brasileira especializada em SEO, automação e ferramentas para desenvolvedores.