{"available_endpoints":[{"description":"Upload an image for object detection.","method":"POST","request_body":{"file":"Image file (JPEG/PNG) [Required]"},"response":{"200":{"example":{"detected_items":["apple","banana","milk"],"filename":"uploaded_image.jpg"}},"400":{"example":{"error":"No file part / Invalid file type"}},"500":{"example":{"error":"Error processing the image"}}},"route":"/detect_items"},{"description":"Upload an image, detect ingredients, and find recipes.","method":"POST","request_body":{"file":"Image file (JPEG/PNG) [Required]"},"response":{"200":{"example":{"recipes":[{"ingredients":["tomato","pasta","cheese"],"instructions":"Boil pasta, add sauce, mix with cheese.","name":"Pasta with Tomato Sauce"}]}},"400":{"example":{"error":"No file provided / No ingredients detected"}},"404":{"example":{"error":"No matching recipes found"}},"500":{"example":{"error":"Error processing the image"}}},"route":"/find_recipe_from_image"},{"description":"Fetch recipe steps from a given source.","method":"GET","request_params":"None","response":{"200":{"example":{"result":"Fetched recipe data"}}},"route":"/fetch-recipe-data"},{"description":"Get recipe suggestions based on user-provided ingredients.","method":"GET","request_params":{"ingredients":"Comma-separated list of ingredients (e.g., ?ingredients=tomato,cheese) [Required]"},"response":{"200":{"example":{"recipes":[{"ingredients":["cheese","eggs"],"instructions":"Whisk eggs, add cheese, cook in a pan.","name":"Cheese Omelette"}]}},"400":{"example":{"error":"No ingredients provided"}},"404":{"example":{"error":"No matching recipe found"}}},"route":"/find_recipe"},{"description":"Find recipes using natural language queries like 'I want to make butter chicken'","method":"GET","request_params":{"query":"Natural language recipe query (e.g., ?query=I want to make butter chicken) [Required]"},"response":{"200":{"example":{"query":"I want to make butter chicken","recipes":[{"Dish Name":"Butter Chicken","Ingredients":"chicken, butter, tomatoes, cream, spices","Match Score":0.95,"Recipe URL":"https://example.com/recipe","Similar YouTube Videos":["video1","video2"],"Steps to Cook":"1. Marinate chicken 2. Cook in butter 3. Add sauce","Story":"Traditional Indian dish loved worldwide","Thumbnail Image":"https://example.com/image.jpg","YouTube Link":"https://youtube.com/watch?v=example"}],"recipes_found":3}},"400":{"example":{"error":"No query provided"}},"404":{"example":{"error":"No matching recipes found"}}},"route":"/find_recipe_by_query"},{"description":"Get Indian festivals for flexible date ranges","method":"GET","request_params":{"api_key":"Optional API key for enhanced results","end_date":"End date for custom range (YYYY-MM-DD format)","range":"Range type: 'week' (default), 'month', or 'custom'","start_date":"Start date for custom range (YYYY-MM-DD format)"},"response":{"200":{"example":{"date_range":"Aug 19-25, 2025","end_date":"2025-08-25","festivals":[{"date":"2025-08-20","name":"Raksha Bandhan"}],"festivals_count":2,"range_description":"Current Week","range_type":"week","start_date":"2025-08-19"}},"400":{"example":{"error":"Invalid range parameter / Missing required dates"}},"500":{"example":{"error":"Failed to fetch festivals"}}},"route":"/festivals"},{"description":"Quick access to current week's festivals","method":"GET","request_params":{"api_key":"Optional API key for enhanced results"},"response":{"200":{"example":{"festivals":[{"date":"2025-08-20","name":"Raksha Bandhan"}],"festivals_count":1,"range_description":"Current Week","range_type":"week"}}},"route":"/festivals/week"},{"description":"Get festivals and their traditional recipes with complete recipe data from India Food Network","method":"GET","request_params":{"api_key":"Optional API key for enhanced festival results","end_date":"End date for custom range (YYYY-MM-DD format)","range":"Range type: 'week' (default), 'month', or 'custom'","start_date":"Start date for custom range (YYYY-MM-DD format)"},"response":{"200":{"example":{"results":[{"date":"2025-04-13","festival":"Baisakhi","recipes":[{"author":"Seema Gadh","date_created":"2017-04-12 11:50:40.0","description":"Baisakhi is almost here, and it's time to celebrate the festival with a rich Punjabi dish...","heading":"Baisakhi Special: Saagwala Mutton","keywords":"","main_category":"Cook at Home","news_id":683799,"tags":["meat","mutton","spinach","Regional New Year","Baisakhi"],"thumbUrl":"https://indiafoodnetwork.in/wp-content/uploads/2017/04/Saag-wala-mutton.jpg","url":"https://www.indiafoodnetwork.in/recipes/baisakhi-special-saagwala-mutton","youtube_videos":[{"description":"Mutton marinated in spices and curd...","embed_url":"//www.youtube.com/embed/fB4XmyDFe7w","title":"Saagwala mutton","video_id":"fB4XmyDFe7w","youtube_url":"https://www.youtube.com/watch?v=fB4XmyDFe7w"}]}]}]}},"400":{"example":{"error":"Invalid date format / Missing required parameters"}},"500":{"example":{"error":"Failed to fetch festival recipes"}}},"route":"/festival-recipes"}],"message":"Welcome to the Object Detection & Recipe Service","status":"API is running","usage_examples":[{"description":"Get current week's festivals with recipes","url":"/festival-recipes"},{"description":"Get current month's festivals with recipes","url":"/festival-recipes?range=month"},{"description":"Get festivals and recipes for custom date range","url":"/festival-recipes?range=custom&start_date=2025-04-01&end_date=2025-04-30"},{"description":"Get festivals for specific date range","url":"/festivals?range=custom&start_date=2025-04-01&end_date=2025-04-15"}]}