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 top items

GET
https://api.recomms.ai/{database}/recomms/top-items
Recommendations
Retrieve a list of top items, optionally filtered.

Request

Path Params
database
string 
required
Query Params
filters
string 
optional
JSON string of filters for search operations
pageSize
integer 
optional
Number of recommendations to return
Default:
5
page
integer 
optional
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.

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/top-items?filters&pageSize&page&businessRules'

Responses

🟢200OK
application/json
Successful operation
Body
array[string]
optional
List of top item IDs
Example
[
  "string"
]
🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
Modified at 2025-03-15 12:27:12
Previous
Search for users
Built with