List Products
Retrieve a paginated list of products for a specific store, including their variants and basic information.
HTTP Method & Endpoint
GET | /product
Request
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | Number | No | Number of items per page (default: 10, max: 100) |
page | Number | No | Page number to fetch (default: 1) |
Response Format
Success Response (200 OK)
| Field | Type | Description |
|---|---|---|
message | String | Status message indicating the result of the operation |
data | Data | Contains the list of products and pagination details |
source | String | Source of the product data (e.g., "unisouk") |
Data Object Properties
| Field | Type | Description |
|---|---|---|
products | Array(Product) | List of product objects |
pagination | Pagination | Pagination metadata |
info
You can view the rest of response at Product Response page.
warning
Product details such as price, SKU, and availability are available only inside the variants array. The main product object is a container for shared information like title, description, and attributes, but it does not include actual pricing or inventory data.
Sample Response
Click to view Sample Response
{
"message": "Products Fetched Successfully",
"data": {
"products": [
{
"storeId": "30182834660443136",
"id": "30212344240120832",
"title": "Testing 1",
"slug:: "testing-1",
"hsnCode": "6404",
"categoryName": "Fashion",
"subCategoryName": "Sports Shoes",
"description": "Good Shoes From Abibas",
"brandName": "Adidas",
"originCountry": "IN",
"images": [
{
"position": 1,
"url": "https://unisouk-dev.s3.ap-south-1.amazonaws.com/store/30182834660443136/assets/30198038983308288.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAXYKJRKRSVXK5BHFX%2F20250325%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20250325T105642Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEKj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRjBEAiA6KczSwEEYG77MBTZWyvysHNHIsCmkURUx7b5DnbW49gIgPc8m6w5J1hyBkE5GDbn2m0MO7Rc7p4HVWh6O0s60GVQq%2BgIIERAAGgw1MzMyNjcwNDM0MjkiDInVsQ7NK3xcySCJ7SrXAjRAWhLKdQy%2Fj05FA%2BvclOYJiVPJqDk87JXwNIhz6O1APXgurze3ju8Dg5TVXzRw2%2FRSKSXw7wzvZFLjYSFnWL5KxPi%2FfzoniqTtvsTYRJgXttR7HmZfpe7OVdu6v9OE7yj0mFxXBOd1F6Uv0FsJv5uCXLI9AQ5%2B60Pnb19j7dLzjJJhtg9nvnI%2Bzw9fRKhOQZYlkXRN5bYTYgoA%2B6BFBfN1A5cpk7Jpfadq1o7kDGZBNa8eZfcYbAh33SBLGMtPlG%2FVvtFpHr9VZBMKM678WwGFQUfKTWWaqVk7zJVKI%2Bpp5dtiCOG8I1FSvHDQA7X3lq20NhXJZTRcLsALVVCzuYdC0SWoS2tvCmQhtn%2BOH1xUHO7jCdo%2Bo5d36d%2FFNpMbOVQf%2FSV5vXV6kaIDVCFk1I%2BH8D4IeuaEqXpqjRu%2BJv8c9S7zkCpPqs%2ByGkJJJHb9ADCKGlIUJ78wmMGJvwY6qAE3SmYSM%2FdHu1rGD8kcoO2ZNfFhFbV3aHmdiHGIuOH3bEPO%2Bk68LKBOGdwJUAFI0e1ButHBADw92afKNiudSc9Js3%2BSpizZhJSk9tWVacNshPVwsf1P%2BYkdpmDSEjLRBtR4%2FGiqpwtm7w3IUYyAqHDRviw3QtD8HMkRFF3SuA%2B2s30L4WRPifPcJ%2FVTW793PYcUQES1CEFmlJkfpFuTIY%2B0Z6HFFJBF4Os%3D&X-Amz-Signature=79c8fefa454284e94506a1478a867ed7a0141390fd081becb738c88a1481d972&X-Amz-SignedHeaders=host&x-id=GetObject"
},
{
"position": 2,
"url": "https://unisouk-dev.s3.ap-south-1.amazonaws.com/store/30182834660443136/assets/30198039012669440.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAXYKJRKRSVXK5BHFX%2F20250325%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20250325T105642Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEKj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRjBEAiA6KczSwEEYG77MBTZWyvysHNHIsCmkURUx7b5DnbW49gIgPc8m6w5J1hyBkE5GDbn2m0MO7Rc7p4HVWh6O0s60GVQq%2BgIIERAAGgw1MzMyNjcwNDM0MjkiDInVsQ7NK3xcySCJ7SrXAjRAWhLKdQy%2Fj05FA%2BvclOYJiVPJqDk87JXwNIhz6O1APXgurze3ju8Dg5TVXzRw2%2FRSKSXw7wzvZFLjYSFnWL5KxPi%2FfzoniqTtvsTYRJgXttR7HmZfpe7OVdu6v9OE7yj0mFxXBOd1F6Uv0FsJv5uCXLI9AQ5%2B60Pnb19j7dLzjJJhtg9nvnI%2Bzw9fRKhOQZYlkXRN5bYTYgoA%2B6BFBfN1A5cpk7Jpfadq1o7kDGZBNa8eZfcYbAh33SBLGMtPlG%2FVvtFpHr9VZBMKM678WwGFQUfKTWWaqVk7zJVKI%2Bpp5dtiCOG8I1FSvHDQA7X3lq20NhXJZTRcLsALVVCzuYdC0SWoS2tvCmQhtn%2BOH1xUHO7jCdo%2Bo5d36d%2FFNpMbOVQf%2FSV5vXV6kaIDVCFk1I%2BH8D4IeuaEqXpqjRu%2BJv8c9S7zkCpPqs%2ByGkJJJHb9ADCKGlIUJ78wmMGJvwY6qAE3SmYSM%2FdHu1rGD8kcoO2ZNfFhFbV3aHmdiHGIuOH3bEPO%2Bk68LKBOGdwJUAFI0e1ButHBADw92afKNiudSc9Js3%2BSpizZhJSk9tWVacNshPVwsf1P%2BYkdpmDSEjLRBtR4%2FGiqpwtm7w3IUYyAqHDRviw3QtD8HMkRFF3SuA%2B2s30L4WRPifPcJ%2FVTW793PYcUQES1CEFmlJkfpFuTIY%2B0Z6HFFJBF4Os%3D&X-Amz-Signature=0360be45201e3ab3ffafe2bc63148728abdd738a94902468833816a9186cf698&X-Amz-SignedHeaders=host&x-id=GetObject"
},
{
"position": 3,
"url": "https://unisouk-dev.s3.ap-south-1.amazonaws.com/store/30182834660443136/assets/30198039046225920.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAXYKJRKRSVXK5BHFX%2F20250325%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20250325T105642Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEKj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRjBEAiA6KczSwEEYG77MBTZWyvysHNHIsCmkURUx7b5DnbW49gIgPc8m6w5J1hyBkE5GDbn2m0MO7Rc7p4HVWh6O0s60GVQq%2BgIIERAAGgw1MzMyNjcwNDM0MjkiDInVsQ7NK3xcySCJ7SrXAjRAWhLKdQy%2Fj05FA%2BvclOYJiVPJqDk87JXwNIhz6O1APXgurze3ju8Dg5TVXzRw2%2FRSKSXw7wzvZFLjYSFnWL5KxPi%2FfzoniqTtvsTYRJgXttR7HmZfpe7OVdu6v9OE7yj0mFxXBOd1F6Uv0FsJv5uCXLI9AQ5%2B60Pnb19j7dLzjJJhtg9nvnI%2Bzw9fRKhOQZYlkXRN5bYTYgoA%2B6BFBfN1A5cpk7Jpfadq1o7kDGZBNa8eZfcYbAh33SBLGMtPlG%2FVvtFpHr9VZBMKM678WwGFQUfKTWWaqVk7zJVKI%2Bpp5dtiCOG8I1FSvHDQA7X3lq20NhXJZTRcLsALVVCzuYdC0SWoS2tvCmQhtn%2BOH1xUHO7jCdo%2Bo5d36d%2FFNpMbOVQf%2FSV5vXV6kaIDVCFk1I%2BH8D4IeuaEqXpqjRu%2BJv8c9S7zkCpPqs%2ByGkJJJHb9ADCKGlIUJ78wmMGJvwY6qAE3SmYSM%2FdHu1rGD8kcoO2ZNfFhFbV3aHmdiHGIuOH3bEPO%2Bk68LKBOGdwJUAFI0e1ButHBADw92afKNiudSc9Js3%2BSpizZhJSk9tWVacNshPVwsf1P%2BYkdpmDSEjLRBtR4%2FGiqpwtm7w3IUYyAqHDRviw3QtD8HMkRFF3SuA%2B2s30L4WRPifPcJ%2FVTW793PYcUQES1CEFmlJkfpFuTIY%2B0Z6HFFJBF4Os%3D&X-Amz-Signature=64c986ff72986b919a15e1ec048846d1af4287cfb6c68af562e939c3228c1e4b&X-Amz-SignedHeaders=host&x-id=GetObject"
}
]
}
],
"pagination": {
"totalItems": 1,
"currentPage": 1,
"totalPages": 1,
"pageSize": 10
}
},
"source": "unisouk"
}
Examples
Javascript (React)
import axios from "axios";
import { api } from "../constant";
const fetchProducts = async () => {
try {
const response = await api.get("/product", {
params: {
limit: 100,
},
});
console.log("Products fetched:", response.data);
} catch (error) {
console.error("Error fetching products:", error.response?.data || error.message);
}
};
Error Responses
| Status Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Authentication token is missing or invalid |
| 403 | Forbidden - Insufficient permissions |
| 500 | Internal Server Error - Something went wrong on the server |