# FreePlaceholder.com

> Free placeholder image and avatar API. No signup required.

## API Documentation

- [Full Documentation](https://freeplaceholder.com/docs): Complete API reference and framework guides
- [Getting Started](https://freeplaceholder.com/docs/getting-started): Overview of all endpoints and parameters
- [API Reference](https://freeplaceholder.com/docs/api-reference): Detailed endpoint documentation

## Framework Guides

- [React](https://freeplaceholder.com/docs/react): Using FreePlaceholder.com with React
- [Next.js](https://freeplaceholder.com/docs/nextjs): Using FreePlaceholder.com with Next.js
- [Vue.js](https://freeplaceholder.com/docs/vue): Using FreePlaceholder.com with Vue.js
- [Nuxt](https://freeplaceholder.com/docs/nuxt): Using FreePlaceholder.com with Nuxt
- [Svelte](https://freeplaceholder.com/docs/svelte): Using FreePlaceholder.com with Svelte
- [Laravel](https://freeplaceholder.com/docs/laravel): Using FreePlaceholder.com with Laravel

## Quick Reference

- Placeholder: `https://freeplaceholder.com/{width}x{height}[.svg|.png|.jpg|.webp]`
- With colors: `https://freeplaceholder.com/{width}x{height}/{bg_hex}/{fg_hex}`
- Snippet (OG): `https://freeplaceholder.com/snippet[.svg|.png|.jpg|.jpeg|.webp]` — default 1200×630 PNG; query `title`, `subtitle`, `cta`, `logo` (HTTPS raster URL), `width`, `height`, plus same styling params as placeholders
- Avatar: `https://freeplaceholder.com/avatar/{name}[.svg|.png|.jpg|.webp]`
- Query params: `text`, `fontSize`, `bg`, `fg`, `format`, `size` (avatar only)

## Features

- No signup or API key required
- Deterministic color hashing from URL path
- WCAG AA contrast compliance for auto-generated colors
- Formats: SVG (default), PNG, JPEG, WebP
- Aggressive CDN caching (1 year, immutable)
- Max image size: 4096x4096, max avatar: 1024x1024

## Contact

- Website: https://twentymileswest.com
- Service by Twenty Miles West, LLC