{"uid":"cap_pwJ4rGhgDjhP4q0rHoSRQ","slug":"pdf-form-topology-analyzer-05cdad72","name":"PDF Form Topology Analyzer","description":"Private PDF preflight and authorized-video intelligence APIs paid per call with x402 USDC on Base.","url":"https://x402.bakdupoffroad.com/v1/document/form-topology","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pdfBase64":{"type":"string","description":"A base64-encoded PDF, up to the service's advertised decoded-size limit. Customer text is never returned or retained.","contentEncoding":"base64","contentMediaType":"application/pdf"}}},"responseSchema":{"type":"json","example":{"jobId":"00000000-0000-4000-8000-000000000000","result":{"formType":"AcroForm","topology":{"fieldCount":12,"hasAcroForm":true,"fieldTypeCounts":{"text":8,"button":3,"signature":1},"widgetPageCount":2,"needsAppearances":false,"signatureFieldCount":1},"pageCount":2,"limitations":["field names and values are deliberately omitted"],"sourceSha256":"0000000000000000000000000000000000000000000000000000000000000000","schemaVersion":"1"},"economics":{"netMicroUsd":25000,"energyMicroUsd":0,"revenueMicroUsd":25000,"platformFeeMicroUsd":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xWDZc2oQDFVZEyhqgaMG_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a base64-encoded PDF to extract form structure metadata including field counts, types, and AcroForm topology — without returning or retaining field content.","exampleAgentPrompt":"Can you analyze the form structure of this PDF and tell me how many fields it has, what types they are, and whether it has any signature fields — here's the file as a base64 string: [base64data]","exampleUseCases":[{"title":"PDF form automation preflight","prompt":"Before I pipe this PDF into my form-filling workflow, can you check its form topology — specifically how many fields it has, whether it's an AcroForm, and if there are any signature fields I need to handle separately? Here's the base64 PDF."},{"title":"Signature field detection for compliance","prompt":"I need to know if this contract PDF has signature fields and how many — can you analyze its form topology and tell me the signature field count and form type without reading the actual content?"},{"title":"Document pipeline field-type audit","prompt":"I'm getting PDFs from multiple vendors and need to categorize them by form complexity. Can you analyze this PDF's form structure and give me a breakdown of field types like text, button, and signature fields, plus the total field count?"}],"resultDescription":"Returns a JSON object containing: a job ID, form type (e.g. AcroForm), topology details (total field count, hasAcroForm flag, per-type field counts, widget page count, needsAppearances flag, signature field count), total page count, a SHA-256 hash of the source PDF, schema version, and economics metadata (net cost in micro-USD). Field names and values are deliberately omitted for privacy.","failureModes":["Invalid or malformed base64 input returns a parsing error","PDF exceeds the service's advertised decoded-size limit, resulting in rejection","Non-PDF file encoded as base64 may return an unsupported format error","Payment failure or insufficient USDC balance returns HTTP 402","PDF with no form fields returns topology with fieldCount of 0 and hasAcroForm false","Network timeout on large PDF uploads"],"whenToPreferThis":"Choose this endpoint when you need a privacy-safe structural summary of a PDF form — field counts and types — without any risk of field value leakage. Ideal for preflight checks before automated form-filling pipelines, compliance audits requiring signature field detection, or document triage workflows that need to categorize PDFs by form complexity. Prefer this over full PDF parsers when you explicitly do NOT want field content returned or retained, and when per-call micropayment via x402/USDC on Base is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T15:26:16.612Z","isFirstParty":false}