Skip to main content

FreeToolGetSafeZonesResponse

Approximate: platforms do not publish official overlay sizes for organic posts, and the UI varies by device and app version. The boxes come from each platform's guidance for vertical video ads.

platformstring
labelstring

Platform name.

widthinteger
heightinteger
unsafe_areas object[]

Areas the app's UI usually covers, in frame pixels from the top-left corner. Edges are scaled from 1080 × 1920 and rounded to the nearest pixel (halves up), so neighbouring boxes stay edge to edge.

  • Array [
  • namestring

    Possible values: [top_bar, caption_area, left_edge, right_edge, action_rail]

    labelstring
    xinteger
    yinteger
    winteger
    hinteger
  • ]
  • safe_area object

    A box clear of every unsafe area: keep text, faces and logos inside it.

    xinteger
    yinteger
    winteger
    hinteger
    source object

    Where the numbers come from.

    labelstring
    urlstring
    basisstring

    How the numbers were derived from the source.

    last_verifiedstring

    Date the sources were last checked (YYYY-MM-DD).

    caveatstring
    warningsstring[]

    Set when the frame is not 9:16, so the boxes are stretched.

    FreeToolGetSafeZonesResponse
    {
    "platform": "string",
    "label": "string",
    "width": 0,
    "height": 0,
    "unsafe_areas": [
    {
    "name": "top_bar",
    "label": "string",
    "x": 0,
    "y": 0,
    "w": 0,
    "h": 0
    }
    ],
    "safe_area": {
    "x": 0,
    "y": 0,
    "w": 0,
    "h": 0
    },
    "source": {
    "label": "string",
    "url": "string",
    "basis": "string"
    },
    "last_verified": "string",
    "caveat": "string",
    "warnings": [
    "string"
    ]
    }