ListingVideo is a JSON Structure definition published by Etsy, describing 6 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/json-structure/open-api-v3-listing-video-structure.json",
"name": "ListingVideo",
"description": "Reference urls and metadata for a video associated with a specific listing.",
"type": "object",
"properties": {
"video_id": {
"type": "int64",
"description": "The unique ID of a video associated with a listing.",
"minimum": 1,
"example": 1
},
"height": {
"type": "int32",
"description": "The video height dimension in pixels.",
"example": 1
},
"width": {
"type": "int32",
"description": "The video width dimension in pixels.",
"example": 1
},
"thumbnail_url": {
"type": "string",
"description": "The url of the video thumbnail.",
"example": "https://www.etsy.com/listing/123456789"
},
"video_url": {
"type": "string",
"description": "The url of the video file.",
"example": "https://www.etsy.com/listing/123456789"
},
"video_state": {
"type": "string",
"description": "The current state of a given video. Value is one of `active`, `inactive`, `deleted` or `flagged`.",
"enum": [
"active",
"inactive",
"deleted",
"flagged"
],
"default": "active",
"example": "active"
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.