Last 7 days, UTC

Average Latency
16ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
Query Authentication
 

projectId and secretKey parameters should be provided.


Authentication
Description
Parameter
String

Proejct Id

projectId

Required

String

Secret key for the project Id

secretKey

Required

Items

HTTP 200 : Item POST/items/{itemId}
						{
  "id": "item1",
  "title": "Item Title",
  "url": "http://test.com/item/item1",
  "thumbnailImageUrl": "http://test.com/item/item1/thumbnail.jpg",
  "tags": [
    "tag1",
    "tag2",
    "tag3"
  ]
}						
Create or replace a item

Create or replace a item


Test console
Description
Parameter
string

Id of item that needs to be fetched
Example: item1

itemId

Required

Request Body

  • string – Unauthorized

    HTTP 401
  • string – Invalid item

    HTTP 400
HTTP 200 : string DELETE/items/{itemId}
Delete a item

Delete a item


Test console
Description
Parameter
string

Id of item that needs to be fetched

itemId

Required

HTTP 200 : Item GET/items/{itemId}
						{
  "id": "item1",
  "title": "Item Title",
  "url": "http://test.com/item/item1",
  "thumbnailImageUrl": "http://test.com/item/item1/thumbnail.jpg",
  "tags": [
    "tag1",
    "tag2",
    "tag3"
  ]
}						
Find a item by Id

Find a item by Id


Test console
Description
Parameter
string

Id of item that needs to be fetched
Example: item1

itemId

Required

  • string – Unauthorized

    HTTP 401
  • string – The item not found

    HTTP 404

Recommendations

HTTP 200 : string GET/recommendations/{fromType}/{fromId}/{toType}
Get recommendations

Get recommendations


Test console
Description
Parameter
string

From type
Example: "user" or "item"

fromType

Required

string

From Id
Example: userId or itemId

fromId

Required

string

To type
Example: "user" or "item"

toType

Required

string

Id of user whom want to personalize
Example: userId

fromUserId

Optional

string

limit of recommendations
Example: 30

limit

Optional

  • string – Invalid parameters

    HTTP 401

Relations

HTTP 200 : string POST/relations/add/{fromType}/{fromId}/{relation}/{toType}/{toId}
Add a relation

Add a relation


Test console
Description
Parameter
string

From type
Example: "user" or "item"

fromType

Required

string

From Id
Example: userId or itemId

fromId

Required

string

Relation
Example: "like", "dislike", "view", "wishlist", "cart" or "purchase"

relation

Required

string

To type
Example: "user" or "item"

toType

Required

string

To Id
Example: userId or itemId

toId

Required

  • string – Unauthorized

    HTTP 401
  • string – Invalid parameters

    HTTP 400
HTTP 200 : string POST/relations/score/add/{fromType}/{fromId}/{score}/{toType}/{toId}
Add a score

Add a score


Test console
Description
Parameter
string

From type
Example: "user" or "item"

fromType

Required

string

From Id
Example: userId or itemId

fromId

Required

string

Number of a score like Star-rating score
Example: "1", "2", "5", "10", etc.

score

Required

string

To type
Example: "user" or "item"

toType

Required

string

To Id
Example: userId or itemId

toId

Required

  • string – Unauthorized

    HTTP 401
  • string – Invalid parameters

    HTTP 400
HTTP 200 : string POST/relations/set/{fromType}/{fromId}/{relation}/{toType}/{toId}
Set a relation

Set a relation


Test console
Description
Parameter
string

From type
Example: "user" or "item"

fromType

Required

string

From Id
Example: userId or itemId

fromId

Required

string

Relation
Example: "like", "dislike", "view", "wishlist", "cart" or "purchase"

relation

Required

string

To type
Example: "user" or "item"

toType

Required

string

To Id
Example: userId or itemId

toId

Required

  • string – Unauthorized

    HTTP 401
  • string – Invalid parameters

    HTTP 400
HTTP 200 : string POST/relations/score/set/{fromType}/{fromId}/{score}/{toType}/{toId}
Set a score

Set a score


Test console
Description
Parameter
string

From type
Example: "user" or "item"

fromType

Required

string

From Id
Example: userId or itemId

fromId

Required

string

Number of a score like Star-rating score
Example: "1", "2", "5", "10", etc.

score

Required

string

To type
Example: "user" or "item"

toType

Required

string

To Id
Example: userId or itemId

toId

Required

  • string – Unauthrozeid

    HTTP 401
  • string – Invalid parameters

    HTTP 400

Users

HTTP 200 : string POST/users/{userId}
Create or replace a user

Create or replace a user


Test console
Description
Parameter
string

Id of user that needs to be fetched

userId

Required

Request Body

  • string – Unauthorized

    HTTP 401
  • string – Invalid user

    HTTP 400
HTTP 200 : string DELETE/users/{userId}
Delete a user

Delete a user


Test console
Description
Parameter
string

Id of user that needs to be fetched
Example: user1

userId

Required

  • string – Unauthorized

    HTTP 401
HTTP 200 : User GET/users/{userId}
						{
  "id": "user1",
  "name": "John Doe",
  "email": "john@recom.io",
  "tags": "["tag1", "tag2", "tag3"]
}						
Find a user by Id

Find a user by Id


Test console
Description
Parameter
string

Id of user that needs to be fetched

userId

Required

  • string – Unauthorized

    HTTP 401
  • string – The user not found

    HTTP 404

Consume this API completely for free!


By joining the mashape API marketplace you can start using Recomio API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.