Open API v3: Multiple active listing videos returned by GET endpoint but only latest video is rendered on Etsy Web/App Listing UI

[FatihG34]

Confirmation

• I confirm this post does NOT contain sensitive data for my account.

Question / discussion

Open API v3: Multiple active listing videos returned by GET endpoint but only latest video is rendered on Etsy Web/App Listing UI

Environment & Context

• API Version: Etsy Open API v3
• Endpoints Affected:
  • POST /v3/application/shops/{shop_id}/listings/{listing_id}/videos
  • GET /v3/application/listings/{listing_id}/videos
  • GET /v3/application/shops/{shop_id}/listings/{listing_id}?includes=Videos
• OAuth Scopes: listings_w, listings_r

---

Issue Summary

When uploading multiple videos to an Etsy listing via Open API v3 (POST /v3/application/shops/{shop_id}/listings/{listing_id}/videos), the API successfully accepts each video and returns a 201 Created status with video_state: "active". Furthermore, calling GET /v3/application/listings/{listing_id}/videos confirms that both videos exist in the API database with count: 2 and state active.

However, on the Etsy Web UI (Seller Dashboard & Buyer Listing Page), only the most recently uploaded video is rendered. The previously uploaded video is hidden/overwritten on the listing display, despite remaining active in the API response.

In contrast, uploading multiple videos manually via the Etsy Seller Web UI displays all videos correctly on the listing.

---

Steps to Reproduce

1. Create a listing via API or Web UI (e.g. Draft state).
2. Upload Video 1 via API:
   POST /v3/application/shops/{shop_id}/listings/{listing_id}/videos
   • Received Response: video_id: 11111, video_state: "active".
3. Upload Video 2 via API:
   POST /v3/application/shops/{shop_id}/listings/{listing_id}/videos
   • Received Response: video_id: 22222, video_state: "active".
4. Fetch listing videos via API:
   GET /v3/application/listings/{listing_id}/videos
   • Received Response: count: 2 with both video_id: 11111 and 22222 marked as active.
5. Open the listing on Etsy Seller App, Etsy Seller Web Manager, or Public Buyer View.

---

Expected Behavior

Both uploaded videos (video_id: 11111 and video_id: 22222) should be rendered and visible in the listing's media carousel on the Etsy Web & Mobile interfaces, matching the API state (count: 2, video_state: "active") and aligning with the multi-video functionality available directly in the Etsy Seller Web Dashboard.

---

Actual Behavior

Only Video 2 (video_id: 22222, the last uploaded video) is displayed on the Etsy Web/App UI. Video 1 (video_id: 11111) disappears from the listing page display, even though the API continues to return count: 2 with both videos active.

---

Sample Code & API Responses

1. Upload Video 1 Response (201 Created):

{
  "video_id": 11111,
  "height": 1080,
  "width": 1080,
  "thumbnail_url": "https://i.etsystatic.com/video/11111_thumb.jpg",
  "video_url": "https://v.etsystatic.com/video/11111.mp4",
  "video_state": "active"
}

2. Upload Video 2 Response (201 Created):

{
  "video_id": 22222,
  "height": 1080,
  "width": 1080,
  "thumbnail_url": "https://i.etsystatic.com/video/22222_thumb.jpg",
  "video_url": "https://v.etsystatic.com/video/22222.mp4",
  "video_state": "active"
}

3. GET /v3/application/listings/{listing_id}/videos Response (200 OK):

{
  "count": 2,
  "results": [
    {
      "video_id": 11111,
      "height": 1080,
      "width": 1080,
      "thumbnail_url": "https://i.etsystatic.com/video/11111_thumb.jpg",
      "video_url": "https://v.etsystatic.com/video/11111.mp4",
      "video_state": "active"
    },
    {
      "video_id": 22222,
      "height": 1080,
      "width": 1080,
      "thumbnail_url": "https://i.etsystatic.com/video/22222_thumb.jpg",
      "video_url": "https://v.etsystatic.com/video/22222.mp4",
      "video_state": "active"
    }
  ]
}

Note: Despite count: 2 above, Etsy Web UI only renders video_id: 22222.

---

Impact

Sellers and integration platforms using Etsy Open API v3 are unable to programmatically sync multiple listing videos. Uploading additional videos via API causes previous active videos to be hidden on the public storefront, creating a disparity between API state and Web UI presentation.

---

Proposed Resolution / Request

Please sync the Open API v3 video association rendering logic with the Etsy Web/App Listing renderer so that all video_state: "active" videos associated with a listing are displayed in the listing media gallery.

[JackySw]

Did you find any solution or workaround yet?

[FatihG34]

Not yet