Quickstart

import { Refine } from '@refine-ai/sdk';

const refine = new Refine({
  apiKey: process.env.REFINE_API_KEY,
  organizationId: 'org_abc123',
  catalogId: 'cat_xyz789'
});

const results = await refine.search.text({
  query: 'blue running shoes',
  topK: 12
});

console.log(`Found ${results.totalResults} products`);

results.results.forEach(product => {
  console.log(`${product.title} - $${product.price}`);
});

import { Refine } from '@refine-ai/sdk';

const refine = new Refine({
  apiKey: process.env.REFINE_API_KEY,
  organizationId: 'org_abc123',
  catalogId: 'cat_xyz789'
});

async function search(query: string) {
  const results = await refine.search.text({
    query,
    topK: 24,
    visualWeight: 0.4
  });

  // Track the search for analytics
  const searchContext = refine.events.trackSearch(
    query,
    results.results,
    { surface: 'search_results', totalResults: results.totalResults }
  );

  // Render results
  const container = document.getElementById('results');
  container.innerHTML = results.results.map((product, index) => `
    <div class="product" data-id="${product.productId}" data-position="${index}">
      <img src="${product.imageUrl}" alt="${product.title}" />
      <h3>${product.title}</h3>
      <p>$${product.price}</p>
    </div>
  `).join('');

  // Track clicks
  container.querySelectorAll('.product').forEach(el => {
    el.addEventListener('click', () => {
      const productId = el.dataset.id;
      const position = parseInt(el.dataset.position);
      searchContext.trackClick(productId, position);
    });
  });
}

refine.events.trackPurchase({
  orderId: 'order_12345',
  value: 149.99,
  currency: 'USD',
  items: [
    { itemId: 'sku_001', quantity: 1, unitPrice: 99.99 },
    { itemId: 'sku_002', quantity: 2, unitPrice: 25.00 }
  ]
});