Validate media URL

Check if a media URL is accessible and return metadata (content type, file size) plus per-platform size limit comparisons.

Performs a HEAD request (with GET fallback) to detect content type and size. Rejects private/localhost URLs for SSRF protection.

Platform limits are sourced from each platform's actual upload constraints.

POST /v1/tools/validate/media

Check if a media URL is accessible and return metadata (content type, file size) plus per-platform size limit comparisons.

Performs a HEAD request (with GET fallback) to detect content type and size. Rejects private/localhost URLs for SSRF protection.

Platform limits are sourced from each platform's actual upload constraints.

Request body

Content-Type: application/json

• url (string) required — Public media URL to validate

Responses

200 — Media validation result

• valid (boolean)
• url (string)
• error (string) — Error message if valid is false
• contentType (string)
• size (integer) — File size in bytes
• sizeFormatted (string)
• type (string) (enum: image, video, unknown)
• platformLimits (object) — Per-platform size limit comparison (only present when size and type are known)