API v1
Vidly REST API
Production-ready REST endpoints for videos, products, commerce and analytics. JSON over HTTPS, bearer-token auth.
Stable
OAuth 2.0
Edge runtime
Base URL
https://api.vidly.app/v1Auth header
Authorization: Bearer <token>Rate limit
1000 req / minuteVideos
GET
/v1/videosList published videos with filtersGET
/v1/videos/:idGet video details with attached productsPOST
/v1/videosCreate a new video (creator)PATCH
/v1/videos/:idUpdate video metadataDELETE
/v1/videos/:idDelete a videoPOST
/v1/videos/:id/eventsTrack view, click, conversionProducts
GET
/v1/productsBrowse marketplace catalogGET
/v1/products/:idGet product detailsPOST
/v1/productsCreate productPATCH
/v1/products/:idUpdate productDELETE
/v1/products/:idArchive productCreators
GET
/v1/creatorsList all creatorsGET
/v1/creators/:handlePublic creator profilePOST
/v1/creators/:id/followFollow / unfollowCommerce
GET
/v1/cartGet current cartPOST
/v1/cart/itemsAdd to cartPOST
/v1/checkoutCreate order from cartGET
/v1/ordersList user ordersAnalytics
GET
/v1/analytics/creator/:idViews, CTR, revenue rollupGET
/v1/analytics/video/:idPer-video performanceGET
/v1/analytics/platformGMV, top creators (admin)Example request
curl https://api.vidly.app/v1/videos/v1 \
-H "Authorization: Bearer sk_live_••••••••" \
-H "Content-Type: application/json"
{
"id": "v1",
"title": "My 3-step morning glow routine",
"creator": { "id": "c1", "handle": "@siennareed" },
"products": [
{ "id": "p1", "title": "Silk Glow Serum", "price": 48 }
],
"metrics": { "views": 12000, "clicks": 450, "ctr": 3.75, "revenue": 800 }
}