SDK Overview

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

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

// Search
const results = await refine.search.text({
  query: 'summer dress',
  topK: 24,
  visualWeight: 0.5
});

// Track events
const context = refine.events.trackSearch('summer dress', results.results, {
  surface: 'search_results',
  totalResults: results.totalResults
});

// Handle user interaction
context.trackClick('sku_001', 0);

// Get recommendations
const recs = await refine.recs.similarItems({
  anchorId: 'sku_001',
  topK: 8
});

// Identify logged-in users
refine.identify('user_12345');