Get Media

Get metadata for an uploaded media asset.

GET /v1/media/:id

Returns metadata for media you own.

Auth: Bearer API key (required)

Response 200

{
  "id": "media-uuid",
  "url": "https://cdn…",
  "content_type": "image/jpeg",
  "size_bytes": 1048576,
  "original_filename": "photo.jpg",
  "created_at": "2026-07-11T14:00:00.000Z"
}

Errors

HTTPCodeWhen
401invalid_api_keyMissing or invalid API key
404not_foundMedia not found

Full upload example (Python)

import requests, os

API = "https://api.social0.app"
KEY = os.environ["SOCIAL0_API_KEY"]
HEADERS = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# Step 1: presign
presign = requests.post(f"{API}/v1/media/presign", headers=HEADERS, json={
    "filename": "photo.jpg",
    "content_type": "image/jpeg",
    "size_bytes": 1048576,
}).json()

# Step 2: upload
with open("photo.jpg", "rb") as f:
    requests.put(presign["upload_url"], data=f, headers={"Content-Type": "image/jpeg"})

# Step 3: confirm
media = requests.post(f"{API}/v1/media/confirm", headers=HEADERS, json={
    "key": presign["key"],
    "storage_filename": presign["storage_filename"],
    "original_filename": "photo.jpg",
    "content_type": "image/jpeg",
    "size_bytes": 1048576,
}).json()

print(media["id"])  # Use in posts