Netflix Recommendations: API Design

Step 4: API Design

We will use a REST API for client interactions.

1. Get Home Feed

• GET /v1/recommendations/home
• Parameters: user_id (from auth token), device_type (Mobile/TV).
• Response:

{
  "rows": [
    {
      "type": "continue_watching",
      "title": "Continue Watching for Jane",
      "items": [ { "video_id": "vid_123", "progress_sec": 450, "thumbnail": "..." } ]
    },
    {
      "type": "top_picks",
      "title": "Top Picks for You",
      "items": [ { "video_id": "vid_555", "match_score": 0.98 } ]
    }
  ]
}

2. Record User Event