- Getting Started
- Data Ingestion
- Use Cases
Product Catalog User Guides
- Overview
- List
- Attributes
- Categories
- Collections
- Background Jobs
- Settings
Product Catalog API
- Overview
- API Authentication and Data Sync
- Attributes & Attribute Mapping
- Categories
- Products
- Overview
- Create
- Update
- Delete
- Get
- Update Product Attributes
- Add Variants
- Remove Variants
- Get Variants
- Assign Bundle Items
- Remove Bundle Items
- Get Products in a Bundle
- Change Category Assignment
- Publish
- Unpublish
- Collections
- Background Jobs
- Bulk Import & Export
- Published Products
Developer Guide
Catalog Connector User Guides
- Overview
- Items
- Bundles
Catalog Connector API
- Files
- Jobs
- Operations
Get
Find Products
To find specific products for review or reports, you need to specify the criteria for the search. With this endpoint, you can find products (items, variants, and bundles) based on ID or SKU, type, category, and other criteria.
POST
/
products
/
search
curl --request POST \
--url https://api.fabric.inc/v3/products/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"sort": "+sku,-name",
"match": {
"id": {
"op": "IN",
"value": [
"blue"
]
},
"sku": {
"op": "IN",
"value": [
"blue"
]
},
"type": {
"op": "EQUALS",
"value": "ITEM"
},
"hasDraft": {
"op": "EQUALS",
"value": true
},
"hasLive": {
"op": "EQUALS",
"value": true
},
"status": {
"op": "EQUALS",
"value": "LIVE"
},
"categoryId": [
{
"op": "IN",
"value": [
"blue"
]
}
],
"properties": [
{
"attributeId": "CAZZX1234567DDDDD",
"attributeValue": [
{
"op": "RANGE",
"fromValue": "2022-09-14T22:10:30.618Z",
"toValue": "2023-04-14T22:10:30.618Z"
}
]
}
],
"variantIds": {
"op": "IN",
"value": [
"blue"
]
},
"bundleProductIds": {
"op": "IN",
"value": [
"blue"
]
},
"createdAt": {
"op": "RANGE",
"fromValue": "2022-09-14T22:10:30.618Z",
"toValue": "2023-04-14T22:10:30.618Z"
},
"updatedAt": {
"op": "RANGE",
"fromValue": "2022-09-14T22:10:30.618Z",
"toValue": "2023-04-14T22:10:30.618Z"
},
"createdBy": {
"op": "IN",
"value": [
"blue"
]
}
},
"offset": 2,
"limit": 10
}'
{
"data": [
{
"id": "8d7329dfd5288b0011332376",
"sku": "QWERTTY56DDFFVVV",
"type": "ITEM",
"isActive": true,
"hasDraft": true,
"hasLive": true,
"status": "LIVE",
"attributes": [
{
"id": "6d7329dfd5288b0011332345",
"name": "Color",
"type": "string",
"isDeleted": false,
"value": "blue",
"isInherited": true
}
],
"localizedProperties": {
"en-US": {
"attributes": [
{
"id": "517329dfd5288b0011332315",
"name": "Color",
"type": "string",
"isDeleted": false,
"value": "blue",
"isInherited": true
}
]
},
"en-IN": {
"attributes": [
{
"id": "617329dfd5288b0011332316",
"name": "Colour",
"type": "string",
"isDeleted": false,
"value": "blue",
"isInherited": true
}
]
}
},
"variants": [
{
"id": "717329dfd5288b0011332317"
}
],
"categoryId": "5e7329dfd5288b00113323e4",
"createdAt": "2021-09-14T22:10:30.618Z",
"updatedAt": "2021-09-14T22:10:30.618Z"
}
],
"offset": 5,
"limit": 10,
"count": 100
}
Authorizations
S2S access token (JWT) from fabric Identity service (during Login)
Headers
A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.
Example:
"517fa9dfd42d8b00g1o3k312"
Unique request ID
Example:
"263e731c-45c8-11ed-b878-0242ac120002"
Body
application/json
Response
200
application/json
OK
Product list by IDs
Was this page helpful?
curl --request POST \
--url https://api.fabric.inc/v3/products/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"sort": "+sku,-name",
"match": {
"id": {
"op": "IN",
"value": [
"blue"
]
},
"sku": {
"op": "IN",
"value": [
"blue"
]
},
"type": {
"op": "EQUALS",
"value": "ITEM"
},
"hasDraft": {
"op": "EQUALS",
"value": true
},
"hasLive": {
"op": "EQUALS",
"value": true
},
"status": {
"op": "EQUALS",
"value": "LIVE"
},
"categoryId": [
{
"op": "IN",
"value": [
"blue"
]
}
],
"properties": [
{
"attributeId": "CAZZX1234567DDDDD",
"attributeValue": [
{
"op": "RANGE",
"fromValue": "2022-09-14T22:10:30.618Z",
"toValue": "2023-04-14T22:10:30.618Z"
}
]
}
],
"variantIds": {
"op": "IN",
"value": [
"blue"
]
},
"bundleProductIds": {
"op": "IN",
"value": [
"blue"
]
},
"createdAt": {
"op": "RANGE",
"fromValue": "2022-09-14T22:10:30.618Z",
"toValue": "2023-04-14T22:10:30.618Z"
},
"updatedAt": {
"op": "RANGE",
"fromValue": "2022-09-14T22:10:30.618Z",
"toValue": "2023-04-14T22:10:30.618Z"
},
"createdBy": {
"op": "IN",
"value": [
"blue"
]
}
},
"offset": 2,
"limit": 10
}'
{
"data": [
{
"id": "8d7329dfd5288b0011332376",
"sku": "QWERTTY56DDFFVVV",
"type": "ITEM",
"isActive": true,
"hasDraft": true,
"hasLive": true,
"status": "LIVE",
"attributes": [
{
"id": "6d7329dfd5288b0011332345",
"name": "Color",
"type": "string",
"isDeleted": false,
"value": "blue",
"isInherited": true
}
],
"localizedProperties": {
"en-US": {
"attributes": [
{
"id": "517329dfd5288b0011332315",
"name": "Color",
"type": "string",
"isDeleted": false,
"value": "blue",
"isInherited": true
}
]
},
"en-IN": {
"attributes": [
{
"id": "617329dfd5288b0011332316",
"name": "Colour",
"type": "string",
"isDeleted": false,
"value": "blue",
"isInherited": true
}
]
}
},
"variants": [
{
"id": "717329dfd5288b0011332317"
}
],
"categoryId": "5e7329dfd5288b00113323e4",
"createdAt": "2021-09-14T22:10:30.618Z",
"updatedAt": "2021-09-14T22:10:30.618Z"
}
],
"offset": 5,
"limit": 10,
"count": 100
}