# Best Newsletters Directory

> A curated directory of the world's best newsletters across 30+ categories.

This site helps users discover high-quality newsletters for their inbox. All newsletters are manually reviewed and curated.

## Site Structure

- `/` - Homepage with featured newsletters and categories
- `/newsletters` - Browse all newsletters with filters (free, weekly, daily)
- `/newsletters/[slug]` - Individual newsletter pages with detailed reviews
- `/categories` - Browse all newsletter categories
- `/categories/[slug]` - Newsletters in a specific category
- `/lists` - Curated "best of" lists
- `/lists/[slug]` - Individual curated lists (e.g., Best 100 Newsletters of 2025)
- `/submit` - Submit a new newsletter for review

## Content Types

### Newsletters
Each newsletter page includes:
- Title and description
- Author information
- Frequency (daily, weekly, monthly)
- Pricing (free, freemium, paid)
- Categories/tags
- Sample issues
- User reviews and ratings
- Pros and cons
- FAQ section

### Categories
Newsletter categories include:
- SaaS
- Business
- Technology
- Marketing
- Design
- Finance
- Productivity
- Lifestyle

### Curated Lists
Hand-picked collections like:
- Best 100 Newsletters of 2025
- Best Free Newsletters
- Best Weekly Newsletters
- Best Newsletters for Founders

## API Endpoints

- `/api/submit` - Submit new newsletter (POST)
- `/api/reviews` - Submit newsletter reviews (POST)

## Data Format

Newsletter data is stored in JSON format with the following key fields:
- `title` - Newsletter name
- `description` - Brief description
- `author` - Author name
- `link` - Newsletter URL
- `frequency` - Publishing frequency
- `price` - Pricing model
- `tags` - Category tags
- `rating` - Average user rating
- `rssUrl` - RSS feed URL
- `sampleIssues` - Recent newsletter issues

## Contact

Website: https://bestnewsletters.xyz
Twitter: https://x.com/bestnewsletters

## Crawling Guidelines

- All public pages can be crawled
- Respect rate limits
- The `/api/*` endpoints are not for crawling
- RSS feeds are available for individual newsletters via their `rssUrl` field