PDF Text Watermark API

API ID 12964

Add professional text watermarks to any PDF document with full control over position, opacity, font size, color, and rotation. Stamp documents with CONFIDENTIAL, DRAFT, your brand name, or any custom text across every page. The watermark is rendered as selectable, high-quality text with Unicode support. Ideal for branding, copyright protection, document status marking, and legal workflows. Upload a PDF and receive a downloadable watermarked file.

Documentação da API

Endpoints

Requisição

Add a text watermark to a PDF. Attach the PDF in the file field and set the watermark text plus optional styling. Returns a JSON object with a downloadable URL to the watermarked PDF.

Endpoint ID: 25882
POST https://docs.zylalabs.com/api/12964/pdf+text+watermark+api/25882/add+text+watermark
PARÂMETROS DE ENTRADA

Add Text Watermark — Recursos do endpoint

Objeto Descrição
text Opcional REQUIRED. The watermark text stamped on every page (1-100 characters). Example: CONFIDENTIAL.
position Opcional Watermark position (optional, default 'center'). Options: center, top-left, top-right, bottom-left, bottom-right.
opacity Opcional Watermark transparency (optional, default '0.3'). 0.0 = invisible, 1.0 = fully solid.
font_size Opcional Font size in points (optional, default '24'). Allowed range: 8 to 72.
color Opcional Watermark color as a hex code (optional, default '#000000'). Example: #FF0000 for red.
rotation Opcional Rotation angle in degrees (optional, default '0'). Range -180 to 180. Use 45 for a diagonal stamp.
Corpo da requisição Obrigatório Arquivo binário

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

text
position
opacity
font_size
color
rotation
RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"url":"https://pub-6db99bab215e44889f46c4b2a619f8c5.r2.dev/watermarked/20260619/f977168b-1b94-4749-a97a-0e90c2cc6af3.pdf","watermark_type":"text","pages_watermarked":5,"processing_time":"673ms"}
Add Text Watermark — TRECHOS DE CÓDIGO

    curl --location 'https://zylalabs.com/api/12964/pdf+text+watermark+api/25882/add+text+watermark?text=CONFIDENTIAL BRO&rotation=Optional' \
    --header 'Content-Type: application/json' \ 
    --form 'image=@"FILE_PATH"'

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a PDF Text Watermark API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Preços simples e transparentes

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

(Economize 2 meses com cobrança anual 🎉)

🚀 Plano Empresarial
Volume personalizado

  • Limite de taxa personalizado
  • Gestão de equipes e acessos
  • Uptime garantido por SLA
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real
  • Segurança e conformidade empresarial
Contrato anual mínimo: USD 10.000

Empresas líderes confiam em nós

Visão Geral

The PDF Text Watermark API allows developers to add customizable text watermarks to PDF documents through a simple API request. Upload a PDF file, specify the watermark text, and configure its appearance using options such as position, opacity, font size, color, and rotation. The API processes the document and returns a downloadable version containing the watermark applied across all pages.

Watermarks can be used to identify document status, indicate ownership, display copyright notices, apply company branding, or mark documents for internal and external distribution. Common examples include "CONFIDENTIAL", "DRAFT", "INTERNAL USE ONLY", company names, project identifiers, legal notices, and other custom text labels.

The API supports configurable watermark placement, allowing text to appear in the center of the page or in one of the page corners. Opacity settings can be adjusted to ensure the watermark remains visible while preserving the readability of the original document. Rotation controls make it possible to create diagonal stamps commonly used for confidential and draft documents.

Watermark text is rendered directly into the PDF and supports Unicode characters, making it suitable for multiple languages and international document workflows. Font size and color can be customized to match branding requirements or document policies.

Common use cases include:

  • Marking confidential documents

  • Adding draft or review status indicators

  • Applying company branding to PDFs

  • Copyright and ownership labeling

  • Legal and compliance workflows

  • Contract and agreement management

  • Internal document distribution

  • Invoice and report identification

  • Educational and publishing platforms

  • Document archiving and record management

Features:

  • Add text watermarks to PDF documents

  • Apply watermarks across all pages

  • Custom watermark text

  • Adjustable position settings

  • Configurable opacity levels

  • Custom font size controls

  • Custom text color selection

  • Rotation angle support

  • Unicode character support

  • Downloadable PDF output

  • JSON response format

  • HTTPS-based API access

The API accepts PDF files as multipart form-data and returns structured JSON containing a download URL for the processed document. It can be integrated into document management systems, workflow automation platforms, web applications, mobile applications, business software, and file processing services that require PDF watermarking functionality.

PDF Text Watermark API FAQs

The Add Text Watermark endpoint returns a JSON object containing the success status of the operation, a URL to download the watermarked PDF, the type of watermark applied, the number of pages watermarked, and the processing time.

Os campos-chave nos dados de resposta incluem "success" (booleano), "url" (string), "watermark_type" (string), "pages_watermarked" (inteiro) e "processing_time" (string)

Users can customize their requests by specifying parameters such as the PDF file (as multipart form-data), watermark text, position, opacity, font size, color, and rotation angle.

The response data is organized in a structured JSON format, with key-value pairs that provide information about the success of the request, the downloadable URL, and details about the watermarking process.

Typical use cases include marking documents as "CONFIDENTIAL" or "DRAFT," applying company branding, labeling copyright information, and managing legal documents for compliance and distribution.

Os usuários podem utilizar os dados retornados verificando o campo "sucesso" para confirmar o sucesso da operação usando a "url" para baixar o PDF com marca d'água e analisando "páginas_marcadas" para insights de processamento

The endpoint provides information about the watermarking process, including the watermark text applied, the number of pages affected, and the time taken for processing, allowing users to track and manage their document workflows.

Data accuracy is maintained through robust processing algorithms that ensure the watermark is applied consistently across all pages, with customizable parameters allowing for precise control over appearance and placement.

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas