Recomms AI
  1. Recommendations
Recomms AI
  • Documentation
  • Recomms AI SDK
  • Items
    • Create an item
      POST
    • Update an item
      PATCH
    • Get items
      GET
    • Get item by ID
      GET
    • Delete item
      DELETE
    • Get item side info
      GET
    • Create item side info
      POST
    • Delete item side info
      DELETE
    • Reset items
      POST
  • Users
    • Create a user
      POST
    • Update a user
      PATCH
    • Get users
      GET
    • Get user by ID
      GET
    • Delete user
      DELETE
    • Get user side info
      GET
    • Create user side info
      POST
    • Delete user side info
      DELETE
    • Reset users
      POST
  • Interactions
    • Record an interaction
    • Get interactions
    • Delete an interaction
    • Record multiple interactions
    • Reset interactions
  • Business Rules
    • Create a new business rule
    • List business rules
    • Get business rule by ID
    • Update business rule
    • Delete business rule
  • Recommendations
    • Get item recommendations for a user
      GET
    • Get user recommendations for an item
      GET
    • Get similar users
      GET
    • Predict scores for user-item pairs
      GET
    • Predict scores for a batch of user-item combinations
      GET
    • Search for items
      GET
    • Search for users
      GET
    • Get top items
      GET
  1. Recommendations

Get item recommendations for a user

GET
https://api.recomms.ai/{database}/recomms/items-to-user
Recommendations
Retrieve a list of recommended items for a specific user.

Request

Path Params
database
string 
required
Query Params
userId
string 
optional
ID of the user
pageSize
integer 
optional
Number of recommendations to return
page
integer 
optional
targetItemId
string 
optional
The recommendations will reference a specific itemId. For active series, content following the targetItemId will be suggested.
businessRules
string 
optional
List of businessRules ids, [{"id":"1"},{"id":"2","value":"500"}]
The "value" property should only be used for dynamic parameters in the business rules list.
seriesEnabled
boolean 
optional
default "true"

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.recomms.ai//recomms/items-to-user?userId&pageSize&page&targetItemId&businessRules&seriesEnabled'

Responses

🟢200OK
application/json
Successful operation
Body
array[string]
optional
List of recommended item IDs for a user
Example
[
  "string"
]
🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
Modified at 2025-03-16 16:38:57
Previous
Delete business rule
Next
Get user recommendations for an item
Built with