Server-side access to the full Epochal Stock image catalog

Live catalog snapshot

Stats are loaded from GET /stats when this docs site has a server-side API key configured. Without a key, labeled demo figures are shown so the layout still works locally.

Live from API

Built for design applications

The Developer Image API is a catalog and download surface for server-side integrations. Search titles, descriptions, and tags; pull metadata in bulk; then mint short-lived download URLs so secret keys never appear in browser history or access logs.

The single plan

There is exactly one commercial plan. There is no free tier, no per-image billing, and no video access in v1. All keys on an account share the same rate limit and concurrent-download lease.

Endpoint map

Authenticated catalog calls require Authorization: Bearer <key>. GET /health and binary download token URLs do not use the Bearer key.

How a request works

Every successful JSON response uses a data / meta envelope. Errors use a structured error object with a machine-readable code, human message, optional details, and a request_id. Keep X-Request-ID when you report issues.

Sample images from the catalog

A small newest-first sample via GET /images Live sample

Thumbnails and previews are for UI and review. Original filesystem paths are never exposed. See Downloads for original transfer details.

Quick request: search images

Store your key as EPOCHAL_API_KEY on the server. The examples below call GET /images with a simple text query. Full multi-language samples live on the Code Examples page.

curl -sS "https://epochalstock.com/api/v1/images?q=golden+forest&limit=10" \
  -H "Authorization: Bearer $EPOCHAL_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(
  "https://epochalstock.com/api/v1/images?q=golden+forest&limit=10",
  {
    headers: {
      Authorization: "Bearer " + process.env.EPOCHAL_API_KEY,
      Accept: "application/json",
    },
  }
);
if (!response.ok) {
  throw new Error(await response.text());
}
const body = await response.json();
console.log(body.data.total, body.data.images?.length, body.meta.request_id);

Problems the API solves

Practical product pain points you can address with the documented v1 catalog API— search, tags, batch metadata, original downloads, and stats—without inventing extra endpoints.

Apps you can build

Product blueprints that keep secrets on your backend: browser → your server → Epochal API. Each guide maps UI surfaces to real endpoints only.

Documentation map

Jump to the section you need. Each page is self-contained English developer documentation.