{"slug":"etsy-open-api","name":"Etsy Open API","host":"openapi.etsy.com","site":"https://etsy.com","category":"commerce","docsUrl":null,"sources":[{"kind":"changelog","url":"https://github.com/etsy/open-api/discussions/categories/announcements"},{"kind":"openapi","url":"https://www.etsy.com/openapi/generated/oas/3.0.0.json"},{"kind":"archive","url":"https://github.com/etsy/open-api/discussions/1415"},{"kind":"archive","url":"https://github.com/etsy/open-api/discussions/1760"},{"kind":"archive","url":"https://github.com/etsy/open-api/discussions/920"}],"url":"https://www.okapi.bot/providers/etsy-open-api/","json":"https://www.okapi.bot/api/v1/providers/etsy-open-api.json","breakingChanges":[{"slug":"post-v3-application-shops-listings-videos-changes-a-new-video-is-added-beside","api":"etsy-open-api","title":"POST /v3/application/shops/{}/listings/{}/videos changes: a new video is added beside the existing one instead of replacing it","kind":"behaviour_change","outcome":"fails","model":null,"announcedAt":"2026-09-03","effectiveAt":"2026-10-21","scope":null,"calls":["POST /v3/application/shops/{}/listings/{}/videos"],"method":"POST","path":"/v3/application/shops/{}/listings/{}/videos","source":{"url":"https://github.com/etsy/open-api/discussions/1760","kind":"archive"},"quote":"Uploading or associating a video no longer replaces the listing's existing video. A listing can now have up to 2 active videos.","migration":"Stop sending is_multi_video; when a listing already has 2 videos, delete one before adding another and handle 409 responses.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:42:34.838Z","updatedAt":"2026-10-23T10:42:34.838Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/etsy-open-api/breaking-changes/post-v3-application-shops-listings-videos-changes-a-new-video-is-added-beside/"},{"slug":"get-v3-application-shops-listings-images-stops-working-2","api":"etsy-open-api","title":"GET /v3/application/shops/{}/listings/{}/images stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2025-04-17","effectiveAt":"2025-07-24","scope":null,"calls":["GET /v3/application/shops/{}/listings/{}/images"],"method":"GET","path":"/v3/application/shops/{}/listings/{}/images","source":{"url":"https://github.com/etsy/open-api/discussions/1415","kind":"archive"},"quote":"Starting July 24, 2025 all requests to these endpoints will return a 301 Moved Permanently response code with additional information in the request header and body pointing to the current, corresponding endpoint.","migration":"Call getListingImages at GET /v3/application/listings/{listing_id}/images.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:42:28.819Z","updatedAt":"2026-10-23T10:42:28.819Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/etsy-open-api/breaking-changes/get-v3-application-shops-listings-images-stops-working-2/"},{"slug":"get-v3-application-shops-listings-images-stops-working","api":"etsy-open-api","title":"GET /v3/application/shops/{}/listings/{}/images/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2025-04-17","effectiveAt":"2025-07-24","scope":null,"calls":["GET /v3/application/shops/{}/listings/{}/images/{}"],"method":"GET","path":"/v3/application/shops/{}/listings/{}/images/{}","source":{"url":"https://github.com/etsy/open-api/discussions/1415","kind":"archive"},"quote":"Starting July 24, 2025 all requests to these endpoints will return a 301 Moved Permanently response code with additional information in the request header and body pointing to the current, corresponding endpoint.","migration":"Call getListingImage at GET /v3/application/listings/{listing_id}/images/{listing_image_id}.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:42:28.819Z","updatedAt":"2026-10-23T10:42:28.819Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/etsy-open-api/breaking-changes/get-v3-application-shops-listings-images-stops-working/"},{"slug":"put-v3-application-shops-listings-stops-working","api":"etsy-open-api","title":"PUT /v3/application/shops/{}/listings/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2025-04-17","effectiveAt":"2025-07-24","scope":null,"calls":["PUT /v3/application/shops/{}/listings/{}"],"method":"PUT","path":"/v3/application/shops/{}/listings/{}","source":{"url":"https://github.com/etsy/open-api/discussions/1415","kind":"archive"},"quote":"Starting July 24, 2025 all requests to these endpoints will return a 301 Moved Permanently response code with additional information in the request header and body pointing to the current, corresponding endpoint.","migration":"Call updateListing with PATCH /v3/application/shops/{shop_id}/listings/{listing_id}.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:42:28.819Z","updatedAt":"2026-10-23T10:42:28.819Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/etsy-open-api/breaking-changes/put-v3-application-shops-listings-stops-working/"},{"slug":"api-version-open-api-v2-stops-working","api":"etsy-open-api","title":"API version Open API v2 stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2023-04-03","scope":null,"calls":["/v2/*"],"method":null,"path":"/v2/*","source":{"url":"https://github.com/etsy/open-api/discussions/920","kind":"archive"},"quote":"As of Monday, April 3, 2023 v2 will be turned off and any requests to v2 endpoints will fail.","migration":"Use Open API v3 (/v3/application/...) with OAuth 2.0 tokens and an x-api-key header.","migrationChange":null,"needsDecision":"Open API v3 has other endpoints and needs OAuth 2.0 authorization from every connected shop again.","text":null,"publishedAt":"2026-10-23T10:42:26.954Z","updatedAt":"2026-10-23T10:42:26.954Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/etsy-open-api/breaking-changes/api-version-open-api-v2-stops-working/"}]}