Create or find one or more Products. If you want to create multiple Products you need to use products param. This param is an Array of hashes which contain params described below (see examples).

Supported Formats

json

Params

Param name Description
internal_id
required

The products internal ID in your webshop (the product will also get a Lipscore product ID, usually referred to as “id”)


Value:

Must be String

url
required

The URL of the product details page in your webshop


Value:

Must be String

name
required

The full name of the product (not including brand name)


Value:

Must be String

brand
optional

The product brand (i.e. “Apple” for an iPhone)


Value:

Must be String

sku_values
optional

One or more Product SKU values


Value:

Must be an array of String

image_url
optional

The product image URL (full path)


Value:

Must be String

price
optional

The Product price without currency


Value:

Must be Numeric

currency
optional

The price currency


Value:

Must be String

category
optional

The product category


Value:

Must be String

fields
optional

A comma-separated list of fields which should be returned with the product. Available: rating, votes, review_count, reviews. By default it’s empty


Value:

Must be String

api_key
required

API key (a 24 character unique code)


Value:

Must be String

Examples

POST /products&fields=rating,votes?api_key=889c3f3e4b6ac67269261324

Single Product
Request
{ "internal_id": "4716051", "url": "http://mysite.com/products/htc-m8/6268A", "name": "LipscoreDemo HTC One M8 Gold", "brand": "HTC", "sku_values": [ "LipscoreDemo_4716051" ], "image_url": "http://mysite.com/images/htc-m8/6268A.png", "price": "200", "currency": "USD", "category": "smartphones" }
Response
{ "id": "1807875", "internal_id": "4716051", "sku": [ "LipscoreDemo_4716051" ], "name": "LipscoreDemo HTC One M8 Gold", "brand": "HTC", "votes": 0, "rating": "4.4", "review_count": null, "reviews": [ ], "ratings": "0.0" }
Multiple Products
Request
[ { "internal_id": "4716051", "url": "http://mysite.com/products/htc-m8/6268A", "name": "LipscoreDemo HTC One M8 Gold", "brand": "HTC", "sku_values": [ "LipscoreDemo_4716051" ], "image_url": "http://mysite.com/images/htc-m8/6268A.png", "price": "200", "currency": "USD", "category": "smartphones" } ]
Response
[ { "id": "1807875", "internal_id": "4716051", "sku": [ "LipscoreDemo_4716051" ], "name": "LipscoreDemo HTC One M8 Gold", "brand": "HTC", "votes": 0, "rating": "4.4", "review_count": null, "reviews": [ ], "ratings": "0.0" } ]