Help customers find exactly what they're looking for.

// Server-side JavaScript. Use an integration key with catalog:read.
const url = new URL("/api/v1/products", process.env.VELOSEARCH_API_URL);
url.search = new URLSearchParams({
  q: "hydrating serum", limit: "6"
});

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.VELOSEARCH_READ_KEY}` }
});
if (!res.ok) throw new Error(`Search failed: ${res.status}`);
const { products, meta } = await res.json();

// Selected response fields for the product in the sync example.
{
  "products": [
    {
      "external_id": "sku-1042",
      "title": "Hydrating Serum with Hyaluronic Acid",
      "price": "18.9",
      "currency": "EUR",
      "permalink": "https://shop.example/products/hydrating-serum"
    }
  ],
  "meta": { "total": 1, "page": 1, "limit": 6, "total_pages": 1 }
}

// Server-side JavaScript. Use an integration key with catalog:write.
const url = new URL("/api/v1/catalog/products/bulk_upsert", process.env.VELOSEARCH_API_URL);
const res = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VELOSEARCH_INGEST_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    products: [{
      external_id: "sku-1042",
      title: "Hydrating Serum with Hyaluronic Acid",
      price: 18.90,
      currency: "EUR", in_stock: true,
      categories: ["Serums"],
      permalink: "https://shop.example/products/hydrating-serum",
      custom_attributes: { ingredients: ["hyaluronic acid"] }
    }]
  })
});
if (!res.ok) throw new Error(`Sync failed: ${res.status}`);
const receipt = await res.json();
if (receipt.failed) throw new Error("Some products could not be synced");