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.
Dual MCP Servers
Connect Claude, Cursor, or ChatGPT to our Product MCP (with interactive ui:// keepsake preview) and Docs MCP.
Sandbox & Demo
Validate photo/video specs without creating orders, or test scanning with our live public demo keepsake.
Public REST & NLWeb Endpoints
| Method & Path | Operation ID | Purpose |
|---|---|---|
GET /v1/pricing | getPhoto96Pricing | One-time USD price ($9.99), supported formats, upload caps, and digital scope. |
GET /v1/pages | listPhoto96Pages | Cursor-paginated list of public Photo96 pages and Markdown twins (?limit=&cursor=). |
GET /v1/occasions | listPhoto96Occasions | Wedding, family, baby, friend, and memorial occasion pages and gift guides. |
POST /v1/validate-media | validatePhoto96Media | Stateless sandbox check for photo/video format, size, codec, and keepsake note. |
GET / POST /ask (/v1/ask) | askPhoto96Post | NLWeb 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:
- Product MCP (
https://photo96.com/mcp):get_pricing_and_limits,validate_media_specs,search_gift_ideas,get_order_recovery_guide, andpreview_playable_photo(rendersui://photo96/keepsake-preview). - Docs MCP (
https://photo96.com/docs/mcp):search_docs,get_docs_page, andlist_docs_pages.
{
"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
- Versioning: URL-versioned (
/v1/...) withX-API-Version: 2026-11-01. Any breaking retirement provides at least 90 days notice via RFC 8594DeprecationandSunsetheaders. - Rate limits: Responses include
RateLimit,RateLimit-Limit,RateLimit-Remaining, andRateLimit-Resetheaders (andRetry-Afteron HTTP 429). - Idempotency: Pass an optional
Idempotency-Keyheader onPOST /v1/validate-media,POST /v1/ask, andPOST /askfor safe retries. - Typed errors: All 4xx/5xx responses return JSON
{"error":{"code","message","hint","request_id"}}matchingErrorResponsein /openapi.json.
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.