API Documentation

{
  "progress": {
    "type": "youtube_search" | "amazon_search" | "weather_search" | "ai_processing" | "image_generation",
    "message": "string",
    "status": "started" | "completed" | "error",
    "timestamp": number,
    "chat_id": "string"    // Only present in final completion
  }
}

{
  "chat_id": "string",           // Unique ID for this conversation
  "question": "string",          // The original question (formatted)
  "answer": "string",            // Markdown-formatted answer (250-700 words)
  "category": "string",          // Category classification
  "geo_data": {                  // Location data (if mentioned)
    "location_name": "string",   // Full location name with context
    "latitude": number,          // Latitude coordinate
    "longitude": number,         // Longitude coordinate
    "location_type": "lake" | "river" | "ocean" | "pond" | "stream" | "bay" | "creek" | "reservoir" | "general" | null
  }
}

// The complete response stored in database also includes:
{
  "youtube_videos": Array,       // YouTube video recommendations
  "amazon_products": Array,      // Amazon products with affiliate tags
  "tackle_products": Array,      // Tackle.net products
  "conversation": Array          // Full conversation history
}

fetch('/api/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    question: 'What are the best lures for bass fishing in summer?'
  })
})
  .then(response => {
    const reader = response.body.getReader();
    const decoder = new TextDecoder();
    
    function readStream() {
      reader.read().then(({ done, value }) => {
        if (done) {
          console.log('Stream complete');
          return;
        }
        
        const chunk = decoder.decode(value);
        console.log('Received:', chunk);
        
        readStream();
      });
    }
    
    readStream();
  });

fetch('/api/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    question: 'What tackle should I use for trout fishing in Lake Tahoe?',
    enabledTools: {
      weather: false,     // Enable weather data
      shop: true,         // Enable Amazon products
      youtube: true,      // Enable YouTube videos
      tackle: false       // Enable Tackle.net products
    }
  })
});

// Convert image to base64
const imageInput = document.querySelector('input[type="file"]');
const file = imageInput.files[0];
const reader = new FileReader();

reader.onload = async (e) => {
  const base64Image = e.target.result;
  
  const response = await fetch('/api/chat', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      question: 'What species is this fish and how should I catch it?',
      imageUrl: base64Image
    })
  });
};

reader.readAsDataURL(file);