Convertir PDF a Markdown en Python

# pip install requests
import requests, time
API = "https://pdf2md.dev/api/v2"
H = {"Authorization": "Bearer p2m_your_key"}
# 1) crear un trabajo desde una URL de PDF
r = requests.post(f"{API}/jobs", headers={**H, "Idempotency-Key": "report-2026-01"},
                  json={"url": "https://example.com/report.pdf"})
r.raise_for_status()
jid = r.json()["job_id"]
# 2) consultar hasta ready o error
while True:
    job = requests.get(f"{API}/jobs/{jid}", headers=H).json()
    if job["status"] in ("ready", "error"):
        break
    time.sleep(3)
if job["status"] == "error":
    raise SystemExit(f"conversion failed: {job.get('error_code')} {job.get('error_message')}")
# 3) descargar el Markdown
md = requests.get(f"{API}/jobs/{jid}/download", headers=H).text
if job.get("truncated"):
    print("nota: resultado parcial (alcanzó el límite de tiempo)")
open("report.md", "w").write(md)

Para convertir muchos PDF, crea un trabajo por archivo y consúltalos en paralelo hasta tu límite de espacios (3 en el plan gratuito, más en los de pago). Mantén un Idempotency-Key distinto por archivo para que los reintentos nunca dupliquen trabajo, y espera ante un 429 usando la cabecera Retry-After.

// Node 18+ (fetch global)
const API = "https://pdf2md.dev/api/v2";
const H = { Authorization: "Bearer p2m_your_key" };
let r = await fetch(`${API}/jobs`, { method: "POST",
  headers: { ...H, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://example.com/report.pdf" }) });
let { job_id } = await r.json();
let job;
do { await new Promise(s => setTimeout(s, 3000));
     job = await (await fetch(`${API}/jobs/${job_id}`, { headers: H })).json();
} while (!["ready", "error"].includes(job.status));
const md = await (await fetch(`${API}/jobs/${job_id}/download`, { headers: H })).text();