Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Validate

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

Request body

urlstring uri required

Public media URL to validate

Example request

{
  "url": "https://example.com/image.jpg"
}

Response

Media validation result

validboolean
urlstring uri
errorstring

Error message if valid is false

contentTypestring
sizeinteger nullable

File size in bytes

sizeFormattedstring
type'image' | 'video' | 'unknown'
platformLimitsobject

Per-platform size limit comparison (only present when size and type are known)

Example response

{
  "contentType": "image/jpeg",
  "sizeFormatted": "245 KB",
  "platformLimits": {
    "instagram": {
      "limit": 8388608,
      "limitFormatted": "8.0 MB",
      "withinLimit": true
    },
    "twitter": {
      "limit": 5242880,
      "limitFormatted": "5.0 MB",
      "withinLimit": true
    },
    "bluesky": {
      "limit": 1000000,
      "limitFormatted": "977 KB",
      "withinLimit": true
    }
  }
}