Get Product List

Method Objective

The method allows getting a list of products in stock.

Request

Endpoint	Request Type
https://api.personaclick.com/products	GET

Parameters

Name

Type

Requirement

Description

shop_id

string

required

Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings

did

string

optionally

Unique Device ID. See "Initialization (REST API)" for information about getting and using Device ID.

seance

string

optionally

Unique ID of the current user session. See "Initialization (REST API)" for information about getting and using User Session ID.

limit

number

optionally

The maximum number of products in the API response (by default - 10).

page

number

optionally

Page number (first page - 1, by default - 1).

API Response Code

HTTP status code	Description
200 OK	The request was successful
403 Forbidden	Incorrect store ID value

API Response Data

Name

Type

Description

products

array

An array of objects with product information. Each object has the following properties:

barcode – product barcode, if it was imported in the product catalog (type: string)
brand – product vendor (type: string)
categories – an Object array with details of the product category hierarchy, where each object has properties:
"id" – category ID (type: string)
"level" – сategory level in the hierarchy (type: string)
"name" – category name (type: string)
"name_with_parent" – string name from the name of the parent and main product categories, separated by a "-" (type: string)
"parent_id" – parent category ID (type: string)
"url" – category page url (type: string)
category_ids – an array of IDs of the product category hierarchy (type: String array)
currency – product currency (type: string, matches the currency of the PersonaClick account, or the user value set in the settings of the PersonaClick account)
discount – the percentage difference between the old price and the current price (type: number)
discount_formatted – the percentage difference between the old and the current price that is formatted as a string with the "%" symbol (type: string)
group_id – product group ID (type: string)
id – product ID (type: string)
image_url – URL of the original product image (type: string)
image_url_handle – relative URL of the original product image (type: string)
image_url_resized – the object with the URLs of the resize product image. Available object keys matching the size of the image in pixels: 120, 140, 160, 180, 200, 220, 310, 520 (type: object)
is_new – new arrival product (type: boolean). See the parameter in the product catalog import (XML, HTTP API)
leftovers – rough number of the products left in stock. Available values are:
"one" - one product
"few" - 2-10 products
"lot" - over 10 products
model – model and product name (type: string)
name – product name (type: string)
oldprice – integer old price of the product (type: number)
oldprice_formatted – formatted integer old price of the product, including currency (type: string)
oldprice_full – old price of the product (type: number)
oldprice_full_formatted – formatted old price of the product, including currency (type: string)
params – object array with pairs of "key" (type: string), "values" (type: array) properties. The data matches the values of the "param" parameter of the product feed/catalog (XML, HTTP API).
picture – link to the product image in the PersonaClick image repository (type: string)
price – integer current price of the product (type: number)
price_formatted – formatted integer current price of the product, including currency (type: string)
price_full – current price of the product (type: number)
price_full_formatted – formatted current price of the product, including currency (type: string)
rating – product rating (type: number)
relative_sales_rate – level of sales of current product ( in percentage) in relation to the maximum level of sales of products in the store (type: number)
sales_rate – level of product sales (absolute value) (type: number)
url – product page URL (type: string)
url_handle - relative product page URL (type: string)

products_total

number

The total number of products. The following request parameters don't affect this value: page, limit.

brands

Object array

An array of objects with information about available brands. Each object has the following properties:

name – brand name (type: string)
count – total number of brand products (type: number)

filters

Object

JSON string with properties and their values of all API response products. The data matches the values of the "param" parameter of the product feed/catalog (XML, HTTP API). Format:

Code Block
{"property1":["value1","value2"],"property2":["value1","value2"]}

price_range

Object

The object containing the values of the minimum and maximum price of the products in the API response. Available properties:

min - minimum price
max - maximum price

Request Example

Code Block

language	js
theme	FadeToGrey

#Basic
curl https://api.personaclick.com/products?shop_id=0d42fd8b713d0752776ca589cc0056

#Using a profile device ID and seance ID
curl https://api.personaclick.com/products?shop_id=0d42fd8b713d0752776ca589cc0056&did=7rjVGhMykT&seance=R5eQXkrKCf

#Filter by brands
curl https://api.personaclick.com/products?shop_id=0d42fd8b713d0752776ca589cc0056&brands=BRAND_1,BRAND_2

#Filter by categories
curl https://api.personaclick.com/products?shop_id=0d42fd8b713d0752776ca589cc0056&categories=CATEGORY_1,CATEGORY_2

# Filter by locations
curl https://api.personaclick.com/products?shop_id=0d42fd8b713d0752776ca589cc0056&locations=LOCATION_1,LOCATION_2

# Filter by params
curl https://api.personaclick.com/products?shop_id=0d42fd8b713d0752776ca589cc0056&filters={"PARAM_NAME_1": ["PARAM_VALUE_1", "PARAM_VALUE_2"], "PARAM_NAME_2": ["PARAM_VALUE_1", "PARAM_VALUE_2"]}

# Filter by boolean params (boolean as string)
curl https://api.personaclick.com/products?shop_id=0d42fd8b713d0752776ca589cc0056&filters={"PARAM_NAME_1": ["true"], "PARAM_NAME_2": ["false"]}

Get Product Details

Method Objective

The method allows getting product details.

Request

Endpoint	Request Type
https://api.personaclick.com/products/get	GET

Parameters

Name	Type	Requirement	Description
shop_id	string	required	Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings
item_id	string	required	Product ID

API Response Code

HTTP status code	Description
200 OK	The request was successful
403 Forbidden	Incorrect store ID value

API Response Data

The structure of the API response object matches the structure of the object when uploading product data to the system. See Import products via HTTP API.

Request Example

Code Block

language	js
theme	FadeToGrey

curl https://api.personaclick.com/products/get?shop_id=0d42fd8b713d0752776ca589cc0056&item_id=100500

Get Product Counters

Method Objective

The method allows getting 24-hour and 15-minute counters of interaction with a product.

Request

Endpoint

Request Type

Name

Type

Description

products

array

An array of objects with product information. Each object has the following properties:

barcode – product barcode, if it was imported in the product catalog (type: string)
brand – product vendor (type: string)
categories – an Object array with details of the product category hierarchy, where each object has properties:
"id" – category ID (type: string)
"level" – сategory level in the hierarchy (type: string)
"name" – category name (type: string)
"name_with_parent" – string name from the name of the parent and main product categories, separated by a "-" (type: string)
"parent_id" – parent category ID (type: string)
"url" – category page url (type: string)
category_ids – an array of IDs of the product category hierarchy (type: String array)
currency – product currency (type: string, matches the currency of the PersonaClick account, or the user value set in the settings of the PersonaClick account)
discount – if the product has an old price (type: boolean)
group_id – product group ID (type: string)
is_available – product availability status (type: boolean)
model – model and product name (type: string)
name – product name (type: string)
oldprice – integer old price of the product (type: number)
params – object array with pairs of "key" (type: string), "values" (type: array) properties. The data matches the values of the "param" parameter of the product feed/catalog (XML, HTTP API).
picture – link to the product image in the PersonaClick image repository (type: string)
price – integer current price of the product (type: number)
uniqid – product ID (type: string)
url – product page URL (type: string)

Request Example

Code Block

language	js
theme	FadeToGrey

curl https://api.personaclick.com/products/get?shop_id=0d42fd8b713d0752776ca589cc0056&item_id=100500

Get Product Counters

Method Objective

The method allows getting 24-hour and 15-minute counters of interaction with a product.

Request

Endpoint	Request Type
https://api.personaclick.com/products/counters	GET

Parameters

Name	Type	Requirement	Description
shop_id	string	required	Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings
item	string	required	Product ID

API Response Code

HTTP status code	Description
200 OK	The request was successful.
400 Bad Request	See the "message" property of the API response for details.
403 Forbidden	See the "message" property of the API response for details.

API Response Data

Name	Type	Description
now	object	The product interaction counters for the last 15 minutes. The following properties are available: view (number) - the number of product views cart (number) - the number of times product is added to the cart purchase (number) - the number of product purchases
daily	object	The product interaction counters for the last 24 hours. The following properties are available: view (number) - the number of product views cart (number) - the number of times product is added to the cart purchase (number) - the number of product purchases
status	string	Available only in case of an error. Contains the "error" value in this case.
message	string	Available only in case of an error. Contains a description of the error.

Request Example

Code Block

language	js
theme	FadeToGrey

curl https://api.personaclick.com/products/counters?shop_id=0d42fd8b713d0752776ca589cc0056&item=100500

Get Category Product List

Method Objective

The method allows getting a list of products in stock for a specified category.

Note
This method has a 60-second cache if no or empty “filters” parameter is used in the request.

Request

Endpoint	Request Type
https://api.personaclick.com/category/CATEGORY_ID	GET

Parameters

Name

Type

Requirement

Description

CATEGORY_ID

string

required

Category ID

shop_id

string

required

Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings

did

string

optionally

Unique Device ID. See "Initialization (REST API)" for information about getting and using Device ID.

seance

string

optionally

Unique ID of the current user session. See "Initialization (REST API)" for information about getting and using User Session ID.

limit

number

optionally

The maximum number of products in the API response (by default - 10).

page

number

optionally

Page number (first page - 1, by default - 1).

locations

string

optionally

Comma-separated location IDs. If used, the API will return only products available in the specified locations. Locations must be specified in the imported product catalog (XML, HTTP API).

brands

string

optionally

Comma-separated vendor names. If used, the API response will return only the products of the listed vendors. The vendors must be listed in the product feed.

filters

string

optionally

JSON string with the properties and their values that the products should match in the API response. The data matches the values of the "param" parameter of the product feed/catalog (XML, HTTP API). Format:

Code Block
{"property1":["value1","value2"],"property2":["value1","value2"]}

See the example below.

collapse

boolean

optionally

Allows disabling grouping of products by "group_id". This param's "false" value enables the API to return products regardless of a group. The "true" value is only one product of a group. The default value is "true".

API Response Code

HTTP status code	Description
200 OK	The request was successful
403 Forbidden	Incorrect store ID value

API Response Data

Name

Type

Description

products

array

An array of objects with product information. Each object has the following properties:

barcode – product barcode, if it was imported in the product catalog (type: string)
brand – product vendor (type: string)
categories – an Object array with details of the product category hierarchy, where each object has properties:
"id" – category ID (type: string)
"level" – сategory level in the hierarchy (type: string)
"name" – category name (type: string)
"name_with_parent" – string name from the name of the parent and main product categories, separated by a "-" (type: string)
"parent_id" – parent category ID (type: string)
"url" – category page url (type: string)
category_ids – an array of IDs of the product category hierarchy (type: String array)
currency – product currency (type: string, matches the currency of the PersonaClick account, or the user value set in the settings of the PersonaClick account)
discount – the percentage difference between the old price and the current price (type: number)
discount_formatted – the percentage difference between the old and the current price that is formatted as a string with the "%" symbol (type: string)
group_id – product group ID (type: string)
id – product ID (type: string)
image_url – URL of the original product image (type: string)
image_url_handle – relative URL of the original product image (type: string)
image_url_resized – the object with the URLs of the resize product image. Available object keys matching the size of the image in pixels: 120, 140, 160, 180, 200, 220, 310, 520 (type: object)
is_new – new arrival product (type: boolean). See the parameter in the product catalog import (XML, HTTP API)
leftovers – rough number of the products left in stock. Available values are:
"one" - one product
"few" - 2-10 products
"lot" - over 10 products
model – model and product name (type: string)
name – product name (type: string)
oldprice – integer old price of the product (type: number)
oldprice_formatted – formatted integer old price of the product, including currency (type: string)
oldprice_full – old price of the product (type: number)
oldprice_full_formatted – formatted old price of the product, including currency (type: string)
params – object array with pairs of "key" (type: string), "values" (type: array) properties. The data matches the values of the "param" parameter of the product feed/catalog (XML, HTTP API).
picture – link to the product image in the PersonaClick image repository (type: string)
price – integer current price of the product (type: number)
price_formatted – formatted integer current price of the product, including currency (type: string)
price_full – current price of the product (type: number)
price_full_formatted – formatted current price of the product, including currency (type: string)
rating – product rating (type: number)
relative_sales_rate – level of sales of current product ( in percentage) in relation to the maximum level of sales of products in the store (type: number)
sales_rate – level of product sales (absolute value) (type: number)
url – product page URL (type: string)
url_handle - relative product page URL (type: string)

products_total

number

The total number of products. The following request parameters don't affect this value: page, limit.

brands

Object array

An array of objects with information about available brands. Each object has the following properties:

name – brand name (type: string)
count – total number of brand products (type: number)

filters

Object

JSON string with properties and their values of all API response products. The data matches the values of the "param" parameter of the product feed/catalog (XML, HTTP API). Format:

Code Block
{"property1":["value1","value2"],"property2":["value1","value2"]}

price_range

Object

The object containing the values of the minimum and maximum price of the products in the API response. Available properties:

min - minimum price
max - maximum price

Request Example

Code Block

language	js
theme	FadeToGrey

#Basic
curl https://api.personaclick.com/category/100500?shop_id=0d42fd8b713d0752776ca589cc0056

#Using a profile device ID and seance ID
curl https://api.personaclick.com/category/100500?shop_id=0d42fd8b713d0752776ca589cc0056&did=7rjVGhMykT&seance=R5eQXkrKCf

#Filter by brands
curl https://api.personaclick.com/category/100500?shop_id=0d42fd8b713d0752776ca589cc0056&brands=BRAND_1,BRAND_2

# Filter by locations
curl https://api.personaclick.com/category/100500?shop_id=0d42fd8b713d0752776ca589cc0056&locations=LOCATION_1,LOCATION_2

# Filter by params
curl https://api.personaclick.com/category/100500?shop_id=0d42fd8b713d0752776ca589cc0056&filters={"PARAM_NAME_1": ["PARAM_VALUE_1", "PARAM_VALUE_2"], "PARAM_NAME_2": ["PARAM_VALUE_1", "PARAM_VALUE_2"]}

# Filter by boolean params (boolean as string)
curl https://api.personaclick.com/

products/countersGET

Parameters

NameTypeRequirementDescriptionshop_idstringrequiredUnique Store Key in PersonaClick. Located there: Account > Settings > Store SettingsitemstringrequiredProduct ID

API Response Code

HTTP status code

Description200 OK

The request was successful.

400 Bad RequestSee the "message" property of the API response for details.403 ForbiddenSee the "message" property of the API response for details.

API Response Data

NameTypeDescriptionnowobject

The product interaction counters for the last 15 minutes.

The following properties are available:

view (number) - the number of product views
cart (number) - the number of times product is added to the cart
purchase (number) - the number of product purchases

dailyobject

The product interaction counters for the last 24 hours.

The following properties are available:

view (number) - the number of product views
cart (number) - the number of times product is added to the cart
purchase (number) - the number of product purchases

statusstring

Available only in case of an error. Contains the "error" value in this case.

messagestringAvailable only in case of an error. Contains a description of the error.

category/100500?shop_id=0d42fd8b713d0752776ca589cc0056&filters={"PARAM_NAME_1": ["true"], "PARAM_NAME_2": ["false"]}

Get User's Current Cart

Method Objective

The method allows getting the current profile's cart.

Request

Endpoint	Request Type
https://api.personaclick.com/products/cart	GET

Parameters

Name	Type	Requirement	Description
shop_id	string	required	Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings
did	string	optionally	Unique Device ID. See "Initialization (REST API)" for information about getting and using Device ID.

API Response Code

HTTP status code	Description
200 OK	The request was successful
403 Forbidden	Incorrect store ID value
404 Not found	Profile not found.

API Response Data

Name	Type	Description
status	array	Contains "success" if the request is successful.
data	object	Contains the "items" object array, where each object contains the following properties: uniqid - product ID quantity - product quantity

Request Example

Code Block

language	js
theme	FadeToGrey

curl https://api.personaclick.com/products/counterscart?did=zXMNgW9p7W&shop_id=0d42fd8b713d0752776ca589cc0056&item=100500

Column

Page Navigation

Table of Contents

maxLevel	1
indent	0px
style	none

Related Pages

Filter by label (Content by label)

showLabels	false
showSpace	false
sort	title
cql	label = "product_counters"

Page Comparison

Versions Compared

Old Version 7

New Version Current

Key

Get Product List

Method Objective

Request

Parameters

API Response Code

API Response Data

Request Example

Get Product Details

Method Objective

Request

Parameters

API Response Code

API Response Data

Request Example

Get Product Counters

Method Objective

Request

Request Example

Get Product Counters

Method Objective

Request

Parameters

API Response Code

API Response Data

Request Example

Get Category Product List

Method Objective

Request

Parameters

API Response Code

API Response Data

Request Example

Parameters

API Response Code

API Response Data

Get User's Current Cart

Method Objective

Request

Parameters

API Response Code

API Response Data

Request Example