Record an interaction

POST

https://api.recomms.ai/{database}/interactions

Record a new interaction between a user and an item. Supported interaction types:

detailviews: Record time spent viewing an item

purchases: Record a purchase of an item

ratings: Record a user's rating of an item

cartadditions: Record adding an item to the cart

bookmarks: Record bookmarking an item

viewportions: Record the portion of an item viewed

Request

Path Params

Body Params application/json

Example

{
    "user_id": "string",
    "item_id": "string",
    "action": "detailviews",
    "timestamp": 0,
    "cascadeCreate": true,
    "duration": 0,
    "price": 0,
    "amount": 0,
    "rating": -1,
    "portion": 0
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.recomms.ai//interactions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_id": "string",
    "item_id": "string",
    "action": "detailviews",
    "timestamp": 0,
    "cascadeCreate": true,
    "duration": 0,
    "price": 0,
    "amount": 0,
    "rating": -1,
    "portion": 0
}'

Responses

🟢200OK

application/json

Successful operation

Body

Example

{
    "status": "success",
    "timestamp": 0
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-03-13 16:59:32

Reset users

Get interactions