GET login/users/:user id/clustering/features
(Difference between revisions)
Renato.neves (Talk | contribs) (Created page with "== Description == Returns user clustering features. <span style="color: red">Notice: this is an experimental feature and it's available only on staging environment.</span> ...") |
Renato.neves (Talk | contribs) (→Description) |
||
| Line 2: | Line 2: | ||
Returns user clustering features. | Returns user clustering features. | ||
| + | |||
| + | For each feature label defined in the rules, the clustering engine provides a value representing the user's interest likelihood for the given label. The highest likelihood can be used to classify the user with the respective label for the given feature. | ||
<span style="color: red">Notice: this is an experimental feature and it's available only on staging environment.</span> | <span style="color: red">Notice: this is an experimental feature and it's available only on staging environment.</span> | ||
Revision as of 02:03, 12 July 2015
Contents |
Description
Returns user clustering features.
For each feature label defined in the rules, the clustering engine provides a value representing the user's interest likelihood for the given label. The highest likelihood can be used to classify the user with the respective label for the given feature.
Notice: this is an experimental feature and it's available only on staging environment.
Resource URL
GET https://api.socialidnow.com/v1/marketing/login/users/:user_id/clustering/features
Parameters
URL Parameters
| user_id | required | user identifier. |
|---|
Authentication
This API requires Social Login App authentication. See Authentication.
Response
Response Status
| ok (200) | The request was successful. |
|---|---|
| unauthorized (401) | The authentication is wrong. See Authentication. |
| forbidden (403) | The login app has no permission to access this user. |
| not_found (404) | The user was not found. |
| internal_server_error (500) | An unknown error happened. |
Examples
Request
Returns the clustering rules from the login user 340:
curl -iX GET 'https://api.socialidnow.com/v1/marketing/login/users/340/clustering/features' \ -H 'Content-type: application/json' \ --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
Response
Response Headers
HTTP/1.1 200 Ok Status: 200
Response Body
Example of clustering features:
{
"features": {
"movies": {
"drama": 0.25,
"comedy": 0,
"sci-fi": 0.5,
"horror": 0,
"adventure": 0.25
},
"music": {
"rock": 0.73,
"pop": 0.09,
"blues": 0.18,
"pagode": 0
}
}
}
