Photo96

Photo96 API & Agent Documentation

Free, keyless public endpoints, OpenAPI 3.1 schemas, Streamable HTTP MCP servers, WebMCP browser tools, and stateless sandbox validation for Photo96.

Zero-signup public surface

Every endpoint documented here is read-only or stateless and requires no API key, no OAuth login, and no credit card. Paid keepsake creation always happens directly in the user's browser at photo96.com/#create through Polar.

OpenAPI 3.1 & Catalog

Machine-readable schema for all public endpoints, typed errors, pagination, and headers.

Open /openapi.json · RFC 9727 catalog

Dual MCP Servers

Connect Claude, Cursor, or ChatGPT to our Product MCP (with interactive ui:// keepsake preview) and Docs MCP.

Product card · Docs card

Sandbox & Demo

Validate photo/video specs without creating orders, or test scanning with our live public demo keepsake.

Open Sandbox guide · Try live demo

Public REST & NLWeb Endpoints

Method & PathOperation IDPurpose
GET /v1/pricinggetPhoto96PricingOne-time USD price ($9.99), supported formats, upload caps, and digital scope.
GET /v1/pageslistPhoto96PagesCursor-paginated list of public Photo96 pages and Markdown twins (?limit=&cursor=).
GET /v1/occasionslistPhoto96OccasionsWedding, family, baby, friend, and memorial occasion pages and gift guides.
POST /v1/validate-mediavalidatePhoto96MediaStateless sandbox check for photo/video format, size, codec, and keepsake note.
GET / POST /ask (/v1/ask)askPhoto96PostNLWeb v0.55 natural-language search returning JSON or SSE (prefer.streaming: true).

Quickstart examples

curl -s https://photo96.com/v1/pricing

curl -s "https://photo96.com/v1/pages?limit=5"

curl -s -X POST https://photo96.com/v1/validate-media \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: check-123" \
  -d '{"photo_format":"jpg","photo_size_mb":8,"video_format":"mp4","video_size_mb":42,"video_codec":"h264","sandbox":true}'

MCP Servers & MCP Apps

Both servers use Streamable HTTP (protocol versions 2025-11-25, 2025-06-18, 2025-03-26) with no auth header required:

{
  "mcpServers": {
    "photo96": { "type": "streamable-http", "url": "https://photo96.com/mcp" },
    "photo96-docs": { "type": "streamable-http", "url": "https://photo96.com/docs/mcp" }
  }
}

Versioning, Rate Limits, Idempotency & Errors

Sandbox & Test Environment

All public endpoints can be exercised freely without credentials or billing side effects. Use "sandbox": true on POST /v1/validate-media for integration tests and point any phone browser at our live public demo scanner (https://photo96.com/p/KpGcB7eH) to verify camera playback.