Pichr API Documentation
The Pichr API is a RESTful API built on Cloudflare Workers, providing fast, secure, and compliant image hosting services. This documentation covers authentication, endpoints, and integration patterns for building with Pichr.
API Overview
- Base URL:
https://api.pichr.io/api/v1 - Authentication: JWT Bearer tokens via Supabase Auth
- Format: JSON request and response bodies
- Rate Limiting: Enforced per plan tier
- Compliance: UK Online Safety Act 2023, GDPR-compliant
Key Features
🚀 Fast & Global
- Built on Cloudflare Workers Edge Network
- Sub-100ms response times globally
- Automatic image optimization and CDN delivery
🔒 Secure & Compliant
- UK Online Safety Act 2023 compliant
- Automated NSFW detection (Cloudflare AI)
- Content moderation with audit trails
- GDPR data protection and right to deletion
📊 Developer-Friendly
- RESTful design with predictable endpoints
- Comprehensive error messages
- Webhook support for async operations
- OpenAPI 3.0 specification
Quick Start
Get up and running in minutes:
- Sign up for a Pichr account
- Authenticate to get your JWT token
- Upload your first image via the API
- Retrieve and manage your images
Rate Limits
Rate limits vary by plan tier:
| Plan | Uploads/Hour | API Calls/Hour | Storage | Bandwidth |
|---|---|---|---|---|
| Anonymous | 5 | 100 | N/A | N/A |
| Free | 20 | 1,000 | 5 GB | 50 GB/month |
| Pro | 100 | 10,000 | 100 GB | 1 TB/month |
| Enterprise | 1,000 | 100,000 | 1 TB | 10 TB/month |
API Status
Check the API health and status:
curl https://api.pichr.io/healthNeed Help?
- Getting Started: Quick start guide
- Authentication: Auth flow documentation
- Endpoints: Complete endpoint reference
- Support: support@pichr.io
- Issues: Report bugs at GitHub
API Changelog
Stay updated with the latest API changes:
- v1.0.0 (Nov 2025): Initial public release
- Authentication endpoints
- File upload and management
- Album creation and organization
- Content moderation and reporting
- GDPR compliance features
Last updated: 13 November 2025