Editar metadatos de un PDF
Nos envía un PDF y los campos que quiere, y esta tarea reescribe sus propiedades de documento, título, autor, asunto y palabras clave, sin tocar una sola página del contenido. Está pensada para ese momento en que el archivo está bien, pero sus metadatos están mal, vacíos o delatan el nombre de un autor anterior.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El problema que resuelve
Casi todo PDF lleva un diccionario de información: ese pequeño bloque de propiedades que aparece en el panel de Propiedades del documento y que buscadores, gestores de activos digitales y herramientas de e-discovery leen primero. En la práctica esos campos son un desorden. Un contrato exportado desde un procesador de texto sigue mostrando el autor de la plantilla. Un informe generado por un script no tiene título, así que los sistemas lo archivan por su nombre de archivo. Un documento a punto de publicarse aún nombra a quien lo redactó. La api editar metadatos pdf existe para corregir todo eso de forma programática, campo por campo o de una sola vez, para que el documento se presente como usted quiere.
Cómo funciona la llamada
Hace un POST con el documento y los campos objetivo a /pdf/metadata-write. Como reescribir un PDF es trabajo real, el endpoint es asíncrono: devuelve de inmediato un task_id y luego el archivo terminado llega a su webhook o por un enlace firmado válido durante veinticuatro horas. Usted elige qué campos tocar; lo que no incluya se conserva tal cual. Las páginas, las fuentes y los formularios quedan intactos, así que recibe el mismo PDF con una identidad corregida.
Una nota sobre el formato
El PDF guarda los metadatos en dos lugares: el clásico diccionario de información del documento, que viene de los años noventa, y un paquete XMP, un bloque XML que Adobe introdujo en los 2000 y que las herramientas modernas prefieren cada vez más. Cuando solo se actualiza uno, los lectores discrepan sobre quién es el autor. Esta tarea mantiene coherentes las propiedades estándar para que no termine con un archivo que muestra un título en la vista previa del navegador y otro en el lector de escritorio.
Pensada para flujos automáticos
Es una tarea que dispara y olvida dentro de un proceso mayor. Estampe una autoría consistente cuando los documentos salen de su CMS, normalice títulos en un archivo migrado o borre nombres personales antes de publicar en la web abierta. Como cada solicitud se cobra por documento a un precio publicado, procesar miles de archivos es predecible. Las tareas fallidas se reintentan tres veces con espera y, si aun así fallan, nunca se cobran.
Acceso y privacidad
Ejecutar la tarea requiere saldo prepago; una solicitud sin él devuelve 402 en lugar de encolarse en silencio. Ese control es intencional: mantiene la cola rápida y libre de abuso. Sus archivos viven solo lo necesario para procesarse y entregarse, se eliminan tras la ventana de retención y nunca se usan para entrenar ningún modelo.
Qué puede hacer con ella
Ordenar un archivo migrado
Mueve una década de PDFs a un nuevo gestor documental y la mitad tiene títulos vacíos o duplicados. Un solo lote por esta tarea asigna un título con sentido a cada uno para que se indexen y ordenen bien.
Estampar autoría en informes generados
Su plataforma genera estados de cuenta mensuales desde una plantilla que deja vacío el campo de autor. Conecte la llamada de metadata-write al paso de exportación para que cada archivo lleve su empresa como autor y un título descriptivo con fecha.
Quitar nombres personales antes de publicar
Un documento está listo para el sitio público pero aún nombra en el campo autor al empleado que lo redactó. La API lo reemplaza por su marca antes de que el archivo salga de su flujo.
Mejorar la búsqueda con palabras clave
Una biblioteca de investigación quiere que sus PDFs aparezcan en las búsquedas internas correctas. Escribir keywords curadas en los metadatos de cada documento permite que el buscador los ordene por tema y no solo por nombre de archivo.
Preguntas frecuentes
¿Cómo edito los metadatos de un PDF con una API?
Haga un POST con el documento y los campos que quiera, como título, autor, asunto y keywords, a /pdf/metadata-write. La api editar metadatos pdf devuelve un task_id y entrega el archivo reescrito a su webhook o a un enlace firmado.
¿Hay plan gratis o prueba gratuita?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Qué campos de metadatos puedo fijar?
Las propiedades estándar del documento: título, autor, asunto y keywords, junto con el productor y las marcas de creación o modificación. Cualquier campo que no incluya queda tal como estaba en el original.
¿Cambia el contenido de las páginas?
No. Solo se reescriben los metadatos. Las páginas, fuentes, diseño y campos de formulario vuelven idénticos; solo cambian las propiedades que identifican al documento.
¿Puedo actualizar miles de PDFs en lote?
Sí. Cada archivo es su propia solicitud asíncrona con precio por documento, así que puede encolar lotes grandes y recibir cada resultado por separado a medida que termina. No hay penalización por lote.
¿Qué pasa con mi archivo después de procesarlo?
Se entrega por webhook firmado o por un enlace válido durante veinticuatro horas, y luego se elimina tras la ventana de retención. Sus documentos nunca se usan para entrenar ningún modelo.
¿Me cobran si la tarea falla?
Nunca. Una tarea fallida se reintenta tres veces con espera; si aun así no puede completarse, recibe un error claro y ningún cargo por esa solicitud.
¿Borrar el nombre del autor anonimiza del todo el PDF?
Limpia los campos de autor y keywords de los metadatos, que es donde más se filtran los nombres. No altera el texto dentro de las páginas, así que combínelo con una redacción de contenido si el cuerpo también nombra a la persona.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/pdf/metadata-write \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"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['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" => '{"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)Ejemplo de solicitud
{
"pdf": "https://ejemplo.com/documento.pdf"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.metadata_write",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 200 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
413 | input_too_large | El archivo supera el límite de tamaño. |