REST API
API Documentation
Enrich product data programmatically. Send JSON, get enriched JSON back.
Enrichment API
Send products, get missing specs filled. AI crawls manufacturer data and returns values with sources.
Classification
Automatic ETIM and eCl@ss classification. Send a product name and description, get the correct class back.
Validation
GTIN check digits, unit normalization, value range validation. Catch data quality issues before your customers do.
Quickstart
1
Get your API key
Sign up at app.facetflux.com and generate an API key from your dashboard.
2
Send products for enrichment
curl
curl -X POST https://api.facetflux.com/v1/enrich \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"products": [
{
"sku": "HYD-450-SS",
"name": "Hydraulic Fitting 450",
"material": "",
"dimensions": "",
"weight": ""
}
],
"enrich": ["material", "dimensions", "weight"],
"classify": "etim"
}'3
Get enriched data back
Response
{
"products": [
{
"sku": "HYD-450-SS",
"name": "Hydraulic Fitting 450",
"material": "Stainless Steel 316L",
"dimensions": "45mm x 32mm x 28mm",
"weight": "0.34 kg",
"etim_class": "EC000211",
"etim_class_description": "Pipe fitting",
"enrichment_sources": {
"material": "manufacturer-datasheet.pdf",
"dimensions": "manufacturer-catalog-2024.pdf",
"weight": "manufacturer-catalog-2024.pdf"
},
"confidence": 0.94
}
],
"credits_used": 22
}Code examples
Python
import requests
response = requests.post(
"https://api.facetflux.com/v1/enrich",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"products": [
{"sku": "HYD-450-SS", "name": "Hydraulic Fitting 450"}
],
"enrich": ["material", "dimensions", "weight"],
"classify": "etim",
},
)
for product in response.json()["products"]:
print(f"{product['sku']}: {product['etim_class']}")TypeScript
const response = await fetch("https://api.facetflux.com/v1/enrich", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
products: [
{ sku: "HYD-450-SS", name: "Hydraulic Fitting 450" }
],
enrich: ["material", "dimensions", "weight"],
classify: "etim",
}),
});
const { products, credits_used } = await response.json();Ready to integrate?
Sign up for free and start enriching products via API in minutes.