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

Search for items

GET
https://api.recomms.ai/{database}/recomms/search-items
Recommendations
Search for items based on specified criteria.

Request

Path Params
database
string 
required
Query Params
search
string 
optional
JSON string of filters for search operations
relevance
string 
optional
JSON string of importance weights for search operations
pageSize
integer 
optional
Number of recommendations to return
Default:
5
page
integer 
optional
userId
string 
optional
ID of the user
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/search-items?search&relevance&pageSize&page&userId&businessRules'

Responses

🟢200OK
application/json
Successful operation
Body
array[string]
optional
List of item or user IDs matching the search criteria
Example
[
    "string"
]
🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
Modified at 2025-03-15 12:26:55
Previous
Predict scores for a batch of user-item combinations
Next
Search for users
Built with