# Best Parents - Complete Documentation for LLMs

> Comprehensive guide to all content, URLs, and functionality

## Table of Contents

1. [Site Overview](#site-overview)
2. [Architecture](#architecture)
3. [Landing Pages](#landing-pages)
4. [Courses](#courses)
5. [Blog Posts](#blog-posts)
6. [Static Pages](#static-pages)
7. [Business Information](#business-information)
8. [API Documentation](#api-documentation)

---

## Site Overview

Best Parents is a premium marketplace connecting parents with world-class summer camps, academic programs, and educational experiences for children aged 4-18 years.

### Key Statistics

- **Total Programs**: 514+ courses
- **Countries**: 40+ countries worldwide
- **Landing Pages**: 146 per language (438 total)
- **Languages**: English, Spanish, Turkish (website); English only (markdown API)
- **Blog Posts**: 45 articles
- **Institutions**: Oxford, Cambridge, Harvard, Yale, UCLA, and 100+ more

**Important**: Markdown API (`/api/markdown/*` endpoints and `Accept: text/markdown` responses) currently supports English only. Spanish and Turkish content is available on the website but not yet through the markdown API.

### Featured Locations

- **United Kingdom**: Oxford University, Cambridge University, London universities
- **United States**: Harvard, Yale, UCLA, Stanford, and prestigious prep schools
- **Switzerland**: Premium mountain camps and boarding schools
- **International**: Programs across Europe, North America, Asia, and more

---

## Architecture

### URL Structure

#### English (Default)
- Homepage: `/`
- Courses listing: `/courses`
- Landing pages: `/[slug]` (e.g., `/uk-summer-camps`)
- Course details: `/[landing]/[course]` (e.g., `/uk-summer-camps/oxford-royale-engineering`)
- Blog: `/blog` and `/blog/[slug]`

#### Spanish
- Homepage: `/es/`
- Courses listing: `/es/cursos`
- Landing pages: `/es/[slug]` (translated slugs)
- Course details: `/es/[landing]/[course]` (translated slugs)
- Blog: `/es/blog` and `/es/blog/[slug]`

#### Turkish
- Homepage: `/tr/`
- Courses listing: `/tr/kurslar`
- Landing pages: `/tr/[slug]` (translated slugs)
- Course details: `/tr/[landing]/[course]` (translated slugs)
- Blog: `/tr/blog` and `/tr/blog/[slug]`

---

## Landing Pages

### English Landing Pages (150 total)

- **/academic-summer-camps** - Academic
  API: `/api/markdown/page/academic-summer-camps?lang=en`

- **/adventure-camps** - Adventure
  API: `/api/markdown/page/adventure-camps?lang=en`

- **/ai-camps** - AI Camps
  API: `/api/markdown/page/ai-camps?lang=en`

- **/aiglon** - Aiglon
  API: `/api/markdown/page/aiglon?lang=en`

- **/courses** - All Courses
  API: `/api/markdown/page/courses?lang=en`

- **/alpadia** - Alpadia Language Schools 
  API: `/api/markdown/page/alpadia?lang=en`

- **/architecture-camps** - Architecture
  API: `/api/markdown/page/architecture-camps?lang=en`

- **/art-camps** - Art 
  API: `/api/markdown/page/art-camps?lang=en`

- **/australia** - Australia
  API: `/api/markdown/page/australia?lang=en`

- **/basketball-camps** - Basketball
  API: `/api/markdown/page/basketball-camps?lang=en`

- **/bell-english** - Bell English
  API: `/api/markdown/page/bell-english?lang=en`

- **/berkeley** - Berkeley
  API: `/api/markdown/page/berkeley?lang=en`

- **/biology-camps** - Biology 
  API: `/api/markdown/page/biology-camps?lang=en`

- **/biotechnology** - Biotechnology
  API: `/api/markdown/page/biotechnology?lang=en`

- **/boston** - Boston
  API: `/api/markdown/page/boston?lang=en`

- **/brillantmont** - Brillantmont International School
  API: `/api/markdown/page/brillantmont?lang=en`

- **/bucksmore** - Bucksmore
  API: `/api/markdown/page/bucksmore?lang=en`

- **/business-management-camps** - Business and Management
  API: `/api/markdown/page/business-management-camps?lang=en`

- **/cambridge** - Cambridge
  API: `/api/markdown/page/cambridge?lang=en`

- **/csvpa** - Cambridge School of Visual and Performing Arts
  API: `/api/markdown/page/csvpa?lang=en`

- **/canada-summer-camps** - Canada
  API: `/api/markdown/page/canada-summer-camps?lang=en`

- **/cats-academy** - Cats Academy
  API: `/api/markdown/page/cats-academy?lang=en`

- **/chemistry-camps** - Chemistry Summer 
  API: `/api/markdown/page/chemistry-camps?lang=en`

- **/churchill-house** - Churchill House Summer Centres
  API: `/api/markdown/page/churchill-house?lang=en`

- **/climate-change-camps** - Climate Change 
  API: `/api/markdown/page/climate-change-camps?lang=en`

- **/coding-summer-camps** - Coding Summer 
  API: `/api/markdown/page/coding-summer-camps?lang=en`

- **/college-du-leman** - Collège du Léman
  API: `/api/markdown/page/college-du-leman?lang=en`

- **/columbia** - Columbia
  API: `/api/markdown/page/columbia?lang=en`

- **/computer-science** - Computer Science
  API: `/api/markdown/page/computer-science?lang=en`

- **/costa-rica-summer-camps** - Costa Rica
  API: `/api/markdown/page/costa-rica-summer-camps?lang=en`


... and 120 more landing pages

### Spanish Landing Pages (150 total)

All 150 English landing pages are translated to Spanish with localized URLs.
Website access: `/es/[slug]`
**Note**: Markdown API (`/api/markdown/page/[slug]?lang=es`) not yet supported - English only for now.

### Turkish Landing Pages (150 total)

All 150 English landing pages are translated to Turkish with localized URLs.
Website access: `/tr/[slug]`
**Note**: Markdown API (`/api/markdown/page/[slug]?lang=tr`) not yet supported - English only for now.

---

## Courses

**Total Courses**: 1027 programs across all categories

Each course is available in all 3 languages with localized URLs. Courses are organized by landing page categories.

### Course URL Pattern
```
English:  /[landing-page]/[course-slug]
Spanish:  /es/[landing-page]/[course-slug]
Turkish:  /tr/[landing-page]/[course-slug]
```

### Course Markdown API
```
/api/markdown/course/[landing-page]/[course-slug]?lang=[en|es|tr]
```

### Example Courses

- **/uk-summer-camps/oxford-royale-engineering** - Engineering Summer School at Oxford
- **/uk-summer-camps/cambridge-immerse-medicine** - Medicine Program at Cambridge
- **/usa-summer-camps/harvard-pre-college** - Pre-College Program at Harvard
- **/switzerland-summer-camps/les-elfes-verbier** - Multi-Activity Camp in Swiss Alps

*(For complete course list, use the sitemap API: `/api/markdown/sitemap`)*

---

## Blog Posts

### English Blog Posts (15 articles)

- **/blog/world-class-outdoor-summer-camps-adventure** - Discover Outdoor Summer Camps for 2026: Adventure Awaits!
  API: `/api/markdown/blog/world-class-outdoor-summer-camps-adventure?lang=en`

- **/blog/fusion-academy-individualized-education-experience** - Fusion Academy: Tailored Education in 2026
  API: `/api/markdown/blog/fusion-academy-individualized-education-experience?lang=en`

- **/blog/empowering-women-vacations-sisterhood-travel-destinations** - Girlfriend Getaways: Unique Destinations for Women (2026)
  API: `/api/markdown/blog/empowering-women-vacations-sisterhood-travel-destinations?lang=en`

- **/blog/summer-programs-for-high-school-students** - High School Summer Programs: Explore & Grow in 2026
  API: `/api/markdown/blog/summer-programs-for-high-school-students?lang=en`

- **/blog/inspiring-gen-z-women-leaders-empowerment-stories-global-change** - Inspiring Gen Z Women Leaders: Empowerment Stories for 2026
  API: `/api/markdown/blog/inspiring-gen-z-women-leaders-empowerment-stories-global-change?lang=en`

- **/blog/pre-college-summer-camps-value** - Pre-College Camps: Value for High Schoolers in 2026
  API: `/api/markdown/blog/pre-college-summer-camps-value?lang=en`

- **/blog/how-precollege-programs-can-help** - Pre-College Programs: Choose Your Career Path in 2026
  API: `/api/markdown/blog/how-precollege-programs-can-help?lang=en`

- **/blog/how-robotics-camps-equip-for-ai-era** - Robotics Camps: Equip Your Child for the AI Era in 2026
  API: `/api/markdown/blog/how-robotics-camps-equip-for-ai-era?lang=en`

- **/blog/study-english-teen-summer-camps-usa-vs-uk** - Study English Abroad: USA vs. UK Teen Summer Camps in 2026
  API: `/api/markdown/blog/study-english-teen-summer-camps-usa-vs-uk?lang=en`

- **/blog/swiss-summer-camps-parent-guide** - Swiss Summer Camps: A Parent's Guide for Adventure in 2026
  API: `/api/markdown/blog/swiss-summer-camps-parent-guide?lang=en`

- **/blog/best-academic-summer-camps-aspiring-minds** - Top Academic Summer Camps in 2026: Kick-Start Your Future
  API: `/api/markdown/blog/best-academic-summer-camps-aspiring-minds?lang=en`

- **/blog/best-uk-summer-camps-teens** - Top UK Summer Camps for Teens in 2026
  API: `/api/markdown/blog/best-uk-summer-camps-teens?lang=en`

- **/blog/english-language-summer-camps-perfect** - Unlock English Skills: Best Parents' Summer Camps in 2026.
  API: `/api/markdown/blog/english-language-summer-camps-perfect?lang=en`

- **/blog/usa-summer-camps-unveiled** - USA Summer Camps in 2026: A Parent's Guide to Growth and Fun
  API: `/api/markdown/blog/usa-summer-camps-unveiled?lang=en`

- **/blog/world-class-sports-summer-camps-child-growth** - World-Class Sports Camps: Growth & Fun for Kids in 2026
  API: `/api/markdown/blog/world-class-sports-summer-camps-child-growth?lang=en`


### Spanish Blog Posts (15 articles)

Website access: `/es/blog/[slug]`
**Note**: Markdown API (`/api/markdown/blog/[slug]?lang=es`) not yet supported - English only for now.

### Turkish Blog Posts (15 articles)

Website access: `/tr/blog/[slug]`
**Note**: Markdown API (`/api/markdown/blog/[slug]?lang=tr`) not yet supported - English only for now.

---

## Static Pages

Available in all 3 languages:

- **/about** - About Best Parents (20+ years of expertise)
- **/contact** - Contact our education consultants
- **/faq** - Frequently Asked Questions
- **/terms** - Terms & Conditions (includes booking terms)
- **/privacy** - Privacy Policy
- **/courses** - Browse all programs with filters

### Markdown API for Static Pages
```
/api/markdown/page/about?lang=en
/api/markdown/page/contact?lang=en
/api/markdown/page/faq?lang=en
```

**Note**: All static pages currently available in English only via markdown API.

---

## Business Information

### Booking Process

1. **Browse & Select**: Find the perfect program using filters or categories
2. **Reserve**: Pay 20% deposit to secure your spot
3. **Confirmation**: Receive confirmation within 2 business days
4. **Balance Payment**: Pay remaining 80% after confirmation
5. **Support**: Ongoing support before, during, and after the program

### Payment Terms

- **Deposit**: 20% of total program fee
- **Confirmation Time**: Within 2 business days
- **Balance Due**: After confirmation received
- **Accepted Payment Methods**: Credit cards, bank transfers
- **Currency**: USD, GBP, CHF, EUR depending on program

### Call-to-Actions

#### Connect with Advisor
Schedule a free consultation with our education experts to find the perfect program for your child.
- **URL**: https://www.bestparents.com/contact
- **Platform**: Calendly integration
- **Service**: Free personalized consultation

#### Talk to Mom AI
Get a callback in English to discuss your family's travel and educational needs with our AI voice agent.
- **URL**: https://www.bestparents.com/call-me
- **Language**: English support
- **Service**: AI-powered consultation

### Terms & Policies

- **Terms of Sale**: https://www.bestparents.com/terms
- **Privacy Policy**: https://www.bestparents.com/privacy
- **Cancellation Policy**: Varies by program (detailed in terms)
- **Refund Policy**: Subject to program provider terms

### Accreditations & Trust

- 20+ years of industry experience
- Partnerships with accredited institutions worldwide
- Rigorous safety and quality vetting
- Trusted by families in 50+ countries
- Member of international education associations

---

## API Documentation

### Complete Sitemap API

Get the full site structure with all URLs and markdown endpoints:

```bash
GET https://www.bestparents.com/api/markdown/sitemap
```

Returns JSON with:
- All landing pages (438 total)
- All courses (514+ total)
- All blog posts (45 total)
- All static pages
- Markdown API URLs for every page

### Markdown Endpoints

#### 1. Page Markdown API

```
GET /api/markdown/page/[...path]?lang=[en|es|tr]
```

**Handles**:
- Homepage (`index`)
- Landing pages (e.g., `uk-summer-camps`)
- Static pages (e.g., `about`, `contact`, `terms`)
- Courses listing (`courses`)

**Response**:
```json
{
  "title": "Page Title",
  "description": "Meta description",
  "url": "https://www.bestparents.com/page",
  "language": "en",
  "type": "landing-page|static-page|homepage|courses-listing",
  "markdown": "# Page Title\n\n..."
}
```

#### 2. Course Markdown API

```
GET /api/markdown/course/[...path]?lang=[en|es|tr]
```

**Path Format**: `[landing-page-slug]/[course-slug]`

**Example**: `/api/markdown/course/uk-summer-camps/oxford-royale-engineering?lang=en`

**Response**:
```json
{
  "title": "Course Title",
  "description": "Course description",
  "url": "https://www.bestparents.com/landing/course",
  "language": "en",
  "type": "course",
  "slug": "course-slug",
  "institution": "Institution Name",
  "location": "City, Country",
  "price": {
    "amount": 2998,
    "currency": "GBP",
    "period": "week"
  },
  "markdown": "# Course Title\n\n..."
}
```

#### 3. Blog Markdown API

```
GET /api/markdown/blog/[slug]?lang=[en|es|tr]
```

**Example**: `/api/markdown/blog/academic-camps?lang=en`

**Response**:
```json
{
  "title": "Blog Post Title",
  "author": "Author Name",
  "date": "January 5, 2025",
  "description": "Post description",
  "url": "https://www.bestparents.com/blog/slug",
  "language": "en",
  "type": "blog-post",
  "slug": "slug",
  "markdown": "# Blog Title\n\n..."
}
```

### Content Negotiation via Accept Header

Request any page with `Accept: text/markdown` header to automatically receive markdown response:

```bash
# Automatic routing to markdown API
curl -H "Accept: text/markdown" https://www.bestparents.com/uk-summer-camps
curl -H "Accept: text/markdown" https://www.bestparents.com/blog/academic-camps
curl -H "Accept: text/markdown" https://www.bestparents.com/uk-summer-camps/oxford-royale-engineering
```

The middleware automatically detects the content type and routes to the appropriate markdown API endpoint.

### Caching

All markdown API responses include cache headers:
```
Cache-Control: public, max-age=3600
```

Content is cached for 1 hour (3600 seconds).

---

## Usage Examples

### For AI Agents

```python
import requests

# Get sitemap
sitemap = requests.get("https://www.bestparents.com/api/markdown/sitemap").json()

# Get a landing page
page = requests.get(
    "https://www.bestparents.com/api/markdown/page/uk-summer-camps",
    params={"lang": "en"}
).json()

# Get course details
course = requests.get(
    "https://www.bestparents.com/api/markdown/course/uk-summer-camps/oxford-royale-engineering",
    params={"lang": "en"}
).json()

# Use Accept header
response = requests.get(
    "https://www.bestparents.com/uk-summer-camps",
    headers={"Accept": "text/markdown"}
)
```

### For Web Crawlers

```bash
# Get all URLs
curl https://www.bestparents.com/api/markdown/sitemap | jq '.pages.en'

# Crawl landing pages
curl https://www.bestparents.com/api/markdown/page/uk-summer-camps?lang=en
curl https://www.bestparents.com/api/markdown/page/usa-summer-camps?lang=en

# Crawl courses
curl https://www.bestparents.com/api/markdown/course/uk-summer-camps/oxford-royale-engineering?lang=en
```

---

## Contact & Support

- **Website**: https://www.bestparents.com
- **Email**: Available via contact form at /contact
- **Consultation**: Schedule via /contact (Calendly)
- **AI Assistant**: Request callback via /call-me

---

*Document Generated: 2025-12-04T11:27:49.845Z*
*Version: 1.0*
*Total Pages Documented: 3576+*