ForHosting KIT · PDF e documentos

Editar metadados de PDF

Esta ferramenta grava metadados novos em um PDF: título, autor, assunto, palavras-chave e outros campos. Você envia o arquivo e os valores desejados pela API e recebe o documento atualizado na hora. Serve para padronizar acervos inteiros, marcar a autoria dos seus materiais e entregar relatórios com cara de acabado.

● Estávelpor documentoUS$ 0,002

Executar — US$ 0,002 Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Um detalhe que muda a primeira impressão

Quando alguém abre seu PDF, o leitor mostra o título gravado nos metadados — e se o campo estiver vazio, mostra o nome do arquivo. Uma proposta comercial que aparece na aba do navegador como “documento_final_v3(2)” já começa perdendo. Gravar título, autor e assunto corretos é o tipo de acabamento que ninguém elogia, mas todo mundo nota quando falta. Também ajuda o documento a ser encontrado depois, dentro e fora da sua empresa.

Quais campos você pode gravar

Os campos clássicos do PDF: título (o que aparece na aba e nas buscas), autor (pessoa ou empresa responsável), assunto (uma linha descrevendo o conteúdo) e palavras-chave (termos que sistemas de gestão documental usam para indexar). Você define só os campos que quiser — os demais permanecem como estavam. O conteúdo visível do documento não muda: páginas, texto e imagens ficam intocados; a gravação acontece apenas na ficha interna do arquivo.

Gravação em série pela API

Para um acervo inteiro, o fluxo é o mesmo repetido: uma chamada por documento, cada uma com o arquivo e os valores a gravar. Um script simples percorre a pasta, monta os campos a partir da sua planilha de controle e envia. Em poucos minutos, mil PDFs saem com autor e título padronizados — tarefa que ninguém aguentaria fazer abrindo arquivo por arquivo em um editor.

Preço e limites

US$ 0,002 por chamada, com o preço publicado aqui — sem assinatura e sem surpresa na fatura. Cada arquivo pode ter até 25 MB e 200 páginas. Acentos e cedilha nos campos são respeitados: “Relatório de Gestão — 3º trimestre” é gravado exatamente assim. Se o seu fluxo grava centenas de documentos por dia, o custo continua sendo centavos de dólar.

Casos de uso

Padronizar relatórios logísticos

A Distribuidora Horizonte Verde S.A. gera dezenas de relatórios de rota por semana. Um script grava em cada PDF o título no padrão da empresa e o autor “Horizonte Verde — Logística”, e o GED interno passa a encontrar tudo pela busca.

Apostilas com autoria assinada

Uma plataforma de cursos preparatórios grava autor e palavras-chave em cada apostila antes de liberar o download. Quando o material circula por grupos de estudo, a origem continua identificada dentro do próprio arquivo.

Entregáveis de agência com acabamento

Uma agência de Porto Alegre entrega propostas e relatórios mensais em PDF. Antes do envio, o sistema grava o título correto e o nome da agência como autor — e o cliente nunca mais recebe um arquivo chamado “sem_titulo”.

Acervo digitalizado com ficha completa

Uma biblioteca municipal digitalizou seu acervo histórico. Com os metadados gravados a partir da planilha de catalogação, cada PDF carrega título e assunto oficiais — e o catálogo online se monta sozinho.

Perguntas frequentes

Os campos que já existem no arquivo são apagados?

Só mudam os campos que você enviar. Se o PDF já tem autor e você gravar apenas o título, o autor original permanece. Para limpar um campo, basta enviá-lo com valor vazio.

O conteúdo do documento muda em alguma coisa?

Não. Texto, imagens e layout ficam exatamente como estavam. A gravação acontece só na ficha interna do PDF — quem imprimir o documento antes e depois não verá nenhuma diferença.

Posso usar acentos, cedilha e travessão nos campos?

Pode. Os valores são gravados como você os enviar: “Ação de marketing — 1º semestre” sai com til, cedilha e ordinal intactos. Vale conferir no seu leitor de PDF, mas a codificação é preservada de ponta a ponta.

Qual é o custo para atualizar um acervo grande?

Cada documento é uma chamada de US$ 0,002. Um acervo de 5.000 PDFs custa US$ 10 no total. Não há mensalidade nem pacote mínimo: o preço por chamada é o publicado e pronto.

Vocês guardam os arquivos que eu enviar para edição?

O arquivo é processado para gravar os campos e devolvido; não fica armazenado para outros fins nem é compartilhado com terceiros. É o tratamento mínimo que a tarefa exige, em linha com a LGPD.

Dá para plugar isso no meu sistema de gestão de documentos?

Sim, esse é o uso típico: seu GED chama a API na entrada ou na saída dos documentos. Sem cadastro prévio — a compra é direta. Dúvidas de integração? Manda um e-mail ou chama no WhatsApp: responde uma pessoa de verdade, em espanhol ou inglês, e português é bem-vindo.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/pdf/metadata-write

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/pdf/metadata-write \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"pdf":"https://ejemplo.com/documento.pdf"}'

const res = await fetch("https://api.kit.forhosting.com/pdf/metadata-write", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/metadata-write",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/metadata-write", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"pdf":"https://ejemplo.com/documento.pdf"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/metadata-write", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "pdf": "https://ejemplo.com/documento.pdf"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.metadata_write",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_mb`	25
`max_pages`	200

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.
`413`	`input_too_large`	A entrada passou do tamanho máximo desta tarefa. Confira os limites publicados.

Ver a documentação completa do KIT →