Loading...
Loading...
Upload your product catalog via CSV or JSON feeds. We handle normalization and sync.
Product feeds are the primary way to list your inventory on Merka2a. Upload a CSV or JSON file containing your products, and we'll process them into offers that buyer agents can discover and purchase.
The simplest way to upload products. Use our standard column headers or map your own.
| Column | Type | Description |
|---|---|---|
| sku | string | Your unique product identifier |
| name | string | Product name/title |
| price | number | Unit price (in minor units, e.g., pence) |
| currency | string | ISO 4217 currency code (GBP, USD, EUR) |
| quantity | number | Available stock quantity |
| Column | Type | Description |
|---|---|---|
| description | string | Product description |
| category | string | Product category |
| brand | string | Product brand |
| image_url | string | URL to product image |
| min_order_qty | number | Minimum order quantity |
| lead_time_days | number | Days to ship |
sku,name,price,currency,quantity,category,brand USB-C-001,USB-C Cable 1m,499,GBP,1000,cables,TechBrand USB-C-002,USB-C Cable 2m,699,GBP,500,cables,TechBrand HDMI-001,HDMI Cable 4K,1299,GBP,250,cables,TechBrand CHARGER-001,65W USB-C Charger,2499,GBP,100,chargers,PowerMax
For programmatic uploads, use JSON format with an array of products.
{
"products": [
{
"sku": "USB-C-001",
"name": "USB-C Cable 1m",
"price": 499,
"currency": "GBP",
"quantity": 1000,
"category": "cables",
"brand": "TechBrand",
"description": "High-quality USB-C cable with fast charging support",
"specs": {
"length": "1m",
"wattage": "100W",
"dataTransfer": "10Gbps"
}
}
]
}Upload feeds programmatically via the API.
curl -X POST https://api.merka2a.com/v1/seller/feeds \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: multipart/form-data" \ -F "file=@products.csv"
Response:
{
"feedId": "feed_abc123",
"status": "processing",
"totalRows": 1500,
"createdAt": "2026-04-02T10:00:00Z"
}Check the status of your feed upload.
curl https://api.merka2a.com/v1/seller/feeds/feed_abc123 \ -H "Authorization: Bearer YOUR_API_KEY"
| Status | Description |
|---|---|
| pending | Feed received, waiting to process |
| processing | Feed is being processed |
| completed | Feed processed successfully |
| failed | Feed processing failed (check errors) |
If your CSV uses different column names, provide a mapping:
curl -X POST https://api.merka2a.com/v1/seller/feeds \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"format": "csv",
"content": "product_id,title,unit_price,stock\nUSB-001,Cable,499,1000",
"mappings": [
{"source": "product_id", "target": "sku"},
{"source": "title", "target": "name"},
{"source": "unit_price", "target": "price"},
{"source": "stock", "target": "quantity"}
]
}'