🏛️ Museum Hours Scraper API

🎨

MET Museum

The Metropolitan Museum of Art

GET http://localhost:8303/api/met

Scrapes hours from metmuseum.org using BeautifulSoup. Returns address, phone, and real-time hours.

🍦

Ice Cream Museum

Museum of Ice Cream NYC

GET http://localhost:8303/api/icecream

Scrapes hours from museumoficecream.com using regex patterns. Returns fun, colorful data.

🇺🇦

Ukrainian Museum

Ukrainian Museum NYC

GET http://localhost:8303/api/ukrainian

Scrapes hours from ukrainianmuseum.org. Returns cultural heritage information.

🗽

Empire State Building

Empire State Building Observatory

GET http://localhost:8303/api/empire

Scrapes hours from esbnyc.com. Returns iconic NYC landmark hours.

📊

All Museums

Get all museum data at once

GET http://localhost:8303/api/all

Returns hours for all 4 museums in a single request. Perfect for dashboards.

🔧

API Test

Verify API is working

GET http://localhost:8303/api/test

Simple endpoint to verify the API server is running and list all available endpoints.

🎯 How This Web Scraping Works

Real HTTP Requests: Makes actual GET requests to museum websites
HTML Parsing: Uses BeautifulSoup to parse HTML content
Regex Patterns: Searches for hour patterns in text content
Fallback Data: Provides default hours if scraping fails
Live Timestamps: Shows when data was last scraped
CORS Enabled: Works with any frontend application

📡 Frontend Integration

Your frontend HTML should call these endpoints:

// JavaScript fetch example:
async function fetchMuseumHours(museum) {
    const response = await fetch('http://localhost:8303/api/' + museum);
    const data = await response.json();
    return data.data;
}

// Available museums: 'met', 'icecream', 'ukrainian', 'empire', 'all', 'test'