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"
]
}