# URL Word Counter

> Professional word counting tool for SEO specialists, translators, and content marketers - accurate counts from any website in 5 seconds

## Overview

URL Word Counter analyzes word counts from web pages with JavaScript rendering support, providing accurate counts that basic scrapers miss. Free tier supports single-page analysis up to 10,000 words. Premium and Business tiers offer multi-page crawling, unlimited analysis, and webhook integrations.

## Key Features

- JavaScript-rendered content support (detects dynamic content that basic scrapers miss)
- Multi-page website crawling (analyze up to 20 pages at once)
- 7-language interface (English, Spanish, German, French, Korean, Greek, Chinese Simplified)
- Heat map text visualization for content density analysis
- CSV export for analysis history tracking
- Privacy-focused: No text storage, no tracking, no cookies
- Real-time Core Web Vitals monitoring
- Reading time and readability level calculations
- Sentence and paragraph counting

## Pricing Tiers

### Free
- 10,000 characters per analysis
- 100 requests per hour
- Single-page analysis only
- Basic text statistics
- No credit card required

### Premium ($4.99/month)
- 50,000 characters per analysis
- 500 requests per hour
- 5 concurrent pages for multi-page crawling
- Analysis history with CSV export
- Priority support
- 1 webhook endpoint, 500 events/month

### Business ($8.99/month)
- Unlimited characters per analysis
- 2,000 requests per hour
- 20 concurrent pages for multi-page crawling
- Unlimited analysis history
- 24/7 priority support
- 5 webhook endpoints, 20,000 events/month
- Webhook retries and SLA guarantees

## API Endpoints

### Analysis
- `POST /api/scrape` - Analyze URL word count with multi-page crawling support
- `POST /api/text-analysis/analyze` - Analyze pasted text directly (no authentication required)
- `GET /api/scrape/history` - Retrieve analysis history (authenticated users)

### Authentication
- `POST /api/auth/signup` - Create new user account
- `POST /api/auth/login` - User authentication with JWT tokens
- `POST /api/auth/logout` - Session termination
- `GET /api/auth/csrf-token` - CSRF token generation
- `POST /api/auth/reset-password` - Password reset flow

### User Management
- `GET /api/user/profile` - User profile and subscription details
- `PATCH /api/user/profile` - Update profile information
- `GET /api/user/history` - Complete analysis history

### Health & Monitoring
- `GET /health` - Backend health check
- `GET /` - API welcome message

## Resources

- **Production**: https://www.urlwordcount.net
- **Backend API**: https://urlwordcounter.fly.dev
- **GitHub**: https://github.com/urlwordcounter/urlwordcounter
- **Contact**: hello@urlwordcount.net
- **Support**: support@urlwordcount.net
- **Documentation**: Available at /docs endpoint
- **Blog**: https://www.urlwordcount.net/blog

## Technical Stack

### Frontend
- React 18 with TypeScript
- TailwindCSS for styling
- Vite for build tooling
- React Router for navigation
- i18next for internationalization
- Supabase client for authentication
- Web Vitals for performance monitoring

### Backend
- Python 3.11 with FastAPI
- Playwright for JavaScript rendering
- Supabase (PostgreSQL with Row Level Security)
- Redis for caching and rate limiting
- Pydantic for data validation
- JWT for authentication

### Deployment
- Frontend: Vercel with Brotli compression
- Backend: Fly.io with auto-scaling
- Database: Supabase managed PostgreSQL
- CDN: Cloudflare for static assets

## Use Cases

### SEO Professionals
- Verify content length for SEO requirements
- Competitive content analysis and benchmarking
- Multi-page site content audits
- Track content changes over time

### Translators
- Accurate project estimation for quotes
- Word count verification for billing
- Multi-language content analysis
- Export data for client reports

### Content Marketers
- Content length tracking across campaigns
- Blog post word count standardization
- Competitor content analysis
- Reading time estimation for engagement

### Agencies
- Client content audits and reporting
- Multi-site analysis with webhook automation
- Bulk analysis with CSV export
- API integration for workflow automation

## Security & Privacy

- **No Text Storage**: Analyzed text is never stored on servers
- **No Tracking**: Tracker-free, privacy-focused design
- **HTTPS Only**: Forced HTTPS for all connections
- **CSRF Protection**: Built-in CSRF token validation
- **Rate Limiting**: IP-based and tier-based rate limiting
- **Row Level Security**: Database-level security policies
- **XSS Protection**: React framework + custom sanitization
- **SQL Injection Prevention**: Parameterized queries only

## Performance

- **Core Web Vitals Monitoring**: Real-time LCP, FID, CLS tracking
- **Brotli Compression**: ~75% asset size reduction
- **Optimized Chunking**: Smart code splitting for faster loads
- **HTTP/3 Support**: Modern protocol support
- **CDN Distribution**: Global edge network delivery
- **Target LCP**: Sub-500ms for optimal user experience

## Data Format

### Analysis Response
```json
{
  "url": "https://example.com",
  "word_count": 1234,
  "character_count": 6789,
  "sentence_count": 45,
  "paragraph_count": 12,
  "reading_time_seconds": 296,
  "reading_level": "College",
  "pages_analyzed": 1,
  "total_pages_found": 5,
  "crawl_depth": 2
}
```

## Internationalization

Fully localized interface supporting:
- English (en)
- Spanish (es)
- German (de)
- French (fr)
- Korean (ko)
- Greek (el)
- Chinese Simplified (zh-CN)

## Browser Support

- Chrome/Edge 90+
- Firefox 88+
- Safari 14+
- Mobile browsers (iOS Safari, Chrome Mobile)

## Rate Limits

### Free Tier
- 100 requests per hour (IP-based)
- 10,000 characters per request
- Single-page analysis only

### Premium Tier
- 500 requests per hour
- 50,000 characters per request
- 5 concurrent page crawls

### Business Tier
- 2,000 requests per hour
- Unlimited characters per request
- 20 concurrent page crawls

## Contact & Support

- **General Inquiries**: hello@urlwordcount.net
- **Technical Support**: support@urlwordcount.net
- **Response Time**: 24 hours (Premium/Business: priority support)

---

Last Updated: March 2026
Version: 3.6.0