# Puptra PDF Snapshot

> One-call URL-to-PDF and full-page screenshot API with Puppeteer's page.pdf()/page.screenshot() semantics — an alternative to running puppeteer yourself or the Browserless PDF API, without any headless-browser infrastructure.

An HTTP API at https://puptra-pdf-snapshot.saastemly.com, also an MCP server at https://puptra-pdf-snapshot.saastemly.com/mcp, paid per call: with x402 (USDC on Base; an unpaid call answers 402 Payment Required with the terms, which x402 clients pay automatically), or with prepaid credits or a monthly plan bought by card at https://puptra-pdf-snapshot.saastemly.com (send the API key as Authorization: Bearer <key>).

## Endpoints

- POST /v1/pdf ($0.005 per call; MCP tool "pdf"): Render a URL or HTML to PDF with Puppeteer's page.pdf() options (format letter by default, scale, margins, header/footer templates, printBackground, pageRanges).
- POST /v1/screenshot ($0.005 per call; MCP tool "screenshot"): Capture a PNG, JPEG or WebP screenshot with Puppeteer's page.screenshot() options (fullPage, clip, omitBackground, quality 0-100 for jpeg/webp only).
- POST /v1/snapshot ($0.005 per call; MCP tool "snapshot"): One call, several formats: rendered HTML content and a base64 screenshot (plus optional Markdown and accessibility tree), with the page's status and title.
- POST /v1/markdown ($0.005 per call; MCP tool "markdown"): The page's rendered content as Markdown.
- POST /v1/links ($0.005 per call; MCP tool "links"): Every link on the page as absolute URLs, with optional same-domain-only and visible-only filters.

## Examples

POST https://puptra-pdf-snapshot.saastemly.com/v1/pdf
```json
{
  "url": "https://example.com/",
  "pdfOptions": {
    "format": "a4",
    "printBackground": true
  },
  "gotoOptions": {
    "waitUntil": "networkidle0"
  }
}
```

POST https://puptra-pdf-snapshot.saastemly.com/v1/screenshot
```json
{
  "url": "https://example.com/",
  "screenshotOptions": {
    "fullPage": true,
    "type": "png"
  }
}
```

POST https://puptra-pdf-snapshot.saastemly.com/v1/snapshot
```json
{
  "url": "https://example.com/",
  "formats": [
    "content",
    "screenshot",
    "markdown"
  ]
}
```

POST https://puptra-pdf-snapshot.saastemly.com/v1/markdown
```json
{
  "url": "https://example.com/"
}
```

POST https://puptra-pdf-snapshot.saastemly.com/v1/links
```json
{
  "url": "https://example.com/",
  "excludeExternalLinks": true
}
```

## More

- [Pricing as JSON](https://puptra-pdf-snapshot.saastemly.com/v1/pricing)
- [MCP server](https://puptra-pdf-snapshot.saastemly.com/mcp): Streamable HTTP; add it to an MCP client with the header Authorization: Bearer <API key>
- [Home page](https://puptra-pdf-snapshot.saastemly.com/)