Docs

Open Pravatar delivers pre-generated synthetic assets with structured search and stable URLs.

Everything in Open Pravatar is created offline, reviewed, tagged, and served with cache-friendly endpoints. Search is the product. Generation is an internal pipeline.

Search an asset

GET /api/search?q=woman+wearing+glasses+japan

Filter by use case

GET /api/search?use_case=support&country=US

Fetch the manifest

GET /manifest/ast_tokyo_glasses_portrait

Pick deterministically

GET /pick/alex-cho?country=JP&preset=editorial-dark

Embed directly

<img src="http://www.openpravatar.com/library/ast_tokyo_glasses_portrait/original.png" alt="Woman wearing glasses in Tokyo" width="1536" height="1024" />

Caching notes

Image endpoints should be treated as immutable variants. Manifest and search responses can use strong ETags plus edge cache TTLs. Because assets are pre-generated and IDs are stable, Open Pravatar is naturally CDN-friendly.