​
Description

This endpoint returns a list of recommended items for a given user, optionally using context-based logic to tailor results.

​
Request

Endpoint:

GET /recommendations?user_id=user-456&context_id=sports-homepage&quantity=5

Headers:

Authorization: Bearer <token>

​
Query Parameters

NameTypeRequiredDescription
user_idstringyesUnique identifier for the user
context_idstringnoOptional context logic for tailoring results
quantityintnoNumber of results to return (default: 5)

​
Response

200 OK

{
  "recommendations": [
    {
      "entity_id": "item-123",
      "score": 0.983,
      "metadata": {
        "name": "Nike Running Shoes",
        "brand": "Nike"
      }
    }
  ]
}

​
Notes

  • Recommendations are ordered by descending score.
  • Additional metadata is returned per item to aid in UI rendering.