A Fair Exchange
for Verifiable Knowledge.

import { CiteSearch } from '@cite/sdk';

const cite = new CiteSearch({
  apiKey: process.env.CITE_API_KEY,

  // Search quality tier
  mode: 'premium',  // 'premium' | 'capped' | 'free'

  // Budget control
  maxCostPerQuery: 1.00,  // Cap spending per query

  // Source prioritization
  preferredDomains: ['nature.com', 'arxiv.org'],
  excludeDomains: ['spam-site.com'],

  // Quality filters
  minReputationScore: 0.7,  // 0.5-1.0 scale
  requireFreshness: '30d'   // Prefer recent content
});

// Execute search with automatic attribution
const searchResults = await cite.search({
  query: "How does nuclear fusion work?",
  numResults: 5
});

// Access results with full transparency
searchResults.citations.forEach(citation => {
  console.log(citation.content);
  console.log(citation.publisher);
  console.log(citation.cost);
  console.log(citation.reputation);
});

// Complete receipt with provenance
console.log('Total: $' + searchResults.totalCost);
console.log(searchResults.receipt);