Real-time Catalogue Import
Use JSON ingestion to send new or changed products directly to the current catalogue. The request is asynchronous: acceptance does not mean product processing has finished.
Prepare each product using the Product Data Requirements; all JSON field names use camelCase.
Submit Products
Send at least one product in the products array:
curl -X POST https://platform.youzu.ai/api/v1/admin/catalogue/ingest \
-H "x-client-key: YOUR_CLIENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"products": [
{
"sku": "CHAIR-001",
"name": {"en": "Ergonomic Office Chair"},
"description": {"en": "Office chair with adjustable lumbar support"},
"url": "https://shop.example.com/products/chair-001",
"price": {"USD": 299.99},
"inStock": true,
"isPublished": true,
"images": ["https://cdn.example.com/chair-001/front.jpg"],
"dimensions": {"widthCm": 60, "heightCm": 120, "lengthCm": 70},
"weightKg": 15.5,
"brand": "ErgoDesigns",
"categories": ["Furniture", "Office"],
"customProperties": {"material": "Leather"}
}
]
}'
The complete direct-ingest JSON request must be no larger than 5 MiB. Use API Batch Import with a file URL for larger feeds.
Use the same sku when sending a later version of an offer. Do not send clientId, catalogueId, or externalRef; Youzu derives the account and catalogue scope and manages the external reference.
A successful response confirms only that the ingestion request was accepted. Follow Upload Product Data and Track Processing for pagination and readiness, then Check Moderation Results.
