{"openapi":"3.0.0","info":{"title":"Rosetta PDF API","version":"2.0.0","description":"PDF extraction API for digital documents. Parse to markdown (pdf to markdown), extract structured fields (pdf data extraction), split sections, and ask questions. Native MCP server for Cursor and Claude. No OCR — embedded text layer only.","contact":{"url":"https://rosettafolio.com/docs"}},"externalDocs":{"description":"Agent-friendly API reference (llms-full.txt)","url":"https://rosettafolio.com/llms-full.txt"},"servers":[{"url":"https://rosettafolio.com","description":"Production"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key from Rosetta dashboard"}}},"paths":{"/api/v2/parse":{"post":{"summary":"Parse PDF to markdown/JSON","description":"PDF text extraction for digital PDFs. Returns docId for downstream extract/split/ask calls.","tags":["Core"],"security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"url":{"type":"string","format":"uri"},"quality":{"type":"string","enum":["standard","advanced"]},"lang_list":{"type":"string","example":"[\"en\"]"},"llm":{"type":"string","enum":["true","false"]}}}}}},"responses":{"200":{"description":"Parsed markdown, contents, docId, pageCount"}}}},"/api/v2/extract":{"post":{"summary":"Extract structured data with JSON schema","description":"PDF data extraction using a JSON Schema for field definitions.","tags":["Core"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Extracted structured data"}}}},"/api/v2/split":{"post":{"summary":"Split document into sections","tags":["Core"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Section splits with page ranges"}}}},"/api/v2/ask":{"post":{"summary":"Ask questions across documents","tags":["Core"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Natural-language answer"}}}},"/api/v2/credit-usage":{"get":{"summary":"Get credit usage","tags":["Utility"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Credits used, limit, plan"}}}}}}