E-commerce API Endpoints
Industry-specific endpoints optimized for e-commerce use cases. Get from integration to revenue impact in minutes, not weeks.
Menos código
Endpoints listos para e-commerce
Minutos
Hasta la primera recomendación
Mejor CTR
Medido con A/B testing
Homepage Recommendations
Optimized recommendations for e-commerce homepage with intelligent strategy
POST
/api/v1/recommendations/ecommerce/homepage
Optimizations
Relevancia optimizada
In-stock products only
12 items optimal
No explanations (performance)
// Node.js 18+ (fetch nativo)
const res = await fetch("https://api.rayuela.ai/api/v1/recommendations/ecommerce/homepage", {
method: "POST",
headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ external_user_id: "user-123", limit: 12 }),
});
const recs = await res.json();Product Page Cross-sell
Cross-sell and related product recommendations for product detail pages
POST
/api/v1/recommendations/ecommerce/product-page
Optimizations
Engagement-focused strategy
Excludes current product
Includes explanations
8 items optimal
// Node.js 18+ (fetch nativo)
const res = await fetch("https://api.rayuela.ai/api/v1/recommendations/ecommerce/product-page?current_product_id=prod-456", {
method: "POST",
headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ external_user_id: "user-123", limit: 8 }),
});
const recs = await res.json();Shopping Cart Add-ons
Complementary product recommendations for shopping cart page
POST
/api/v1/recommendations/ecommerce/cart
Optimizations
Complementary items focus
Excludes cart items
Quick decision optimized
6 items optimal
// Node.js 18+ (fetch nativo)
const res = await fetch("https://api.rayuela.ai/api/v1/recommendations/ecommerce/cart?cart_items=prod-123&cart_items=prod-456", {
method: "POST",
headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ external_user_id: "user-123", limit: 6 }),
});
const recs = await res.json();Checkout Upsells
Last-chance upsell recommendations for checkout page
POST
/api/v1/recommendations/ecommerce/checkout
Optimizations
Price capped at 30% of order
Quick-add items focus
Minimal distraction
4 items optimal
// Node.js 18+ (fetch nativo)
const res = await fetch("https://api.rayuela.ai/api/v1/recommendations/ecommerce/checkout?order_value=299.99", {
method: "POST",
headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ external_user_id: "user-123", limit: 4 }),
});
const recs = await res.json();Complete E-commerce Integration Example
Full implementation showing all endpoints in a typical e-commerce flow
// Complete E-commerce Integration (Node.js 18+, fetch nativo)
const apiBase = "https://api.rayuela.ai/api/v1";
const headers = {
"X-API-Key": "YOUR_API_KEY",
"Content-Type": "application/json",
};
async function post(path, body) {
const res = await fetch(apiBase + path, {
method: "POST",
headers,
body: JSON.stringify(body),
});
return res.json();
}
// 1. Homepage recommendations
const homepage = await post("/recommendations/ecommerce/homepage", {
external_user_id: "user-123",
limit: 12,
});
// 2. Product page cross-sell
const crossSell = await post(
"/recommendations/ecommerce/product-page?current_product_id=prod-456",
{ external_user_id: "user-123", limit: 8 }
);
// 3. Cart add-ons
const cartAddons = await post(
"/recommendations/ecommerce/cart?cart_items=prod-123&cart_items=prod-456",
{ external_user_id: "user-123", limit: 6 }
);
// 4. Checkout upsells
const upsells = await post(
"/recommendations/ecommerce/checkout?order_value=299.99",
{ external_user_id: "user-123", limit: 4 }
);
// 5. Track interactions
await post("/interactions/", {
external_user_id: "user-123",
external_product_id: "product-456",
interaction_type: "PURCHASE",
value: 99.99,
});