Media API — upload, transform, deliver newsroom assets

Upload media

POST /v1/media
Content-Type: multipart/form-data

file=@/path/to/photo.jpg
caption="Mayor speaks at press conference"
credit="Sarah Khalifa / Desert News"

Supported formats

• Images: JPG, PNG, WebP, GIF, SVG (max 50 MB)
• Videos: MP4, MOV, WebM (max 5 GB on Pro, 50 GB on Enterprise)
• Documents: PDF, DOCX, XLSX (max 100 MB)
• Audio: MP3, WAV, OGG (max 1 GB)

Search the media library

GET /v1/media?q=mayor+budget&type=image&taken_after=2026-01-01

Searches across captions, credit, alt text, AI-generated tags, and EXIF metadata.

Embedding in articles

Reference media by ID inside the article body HTML:

<figure data-media-id="med_8a3f1c">
  <img src="https://cdn.journalify.app/med_8a3f1c.jpg" alt="..." />
  <figcaption>...</figcaption>
</figure>

Journalify rewrites the URLs at render time to serve the right size for the device + bandwidth.

Image transformations

Append query parameters to the CDN URL for on-the-fly transformations:

https://cdn.journalify.app/med_8a3f1c.jpg?w=1200&h=630&fit=crop&q=80