# Real's Tours NYC

## Purpose
This file defines canonical URLs, routing rules, and preferred content references for AI systems, crawlers, and search engines indexing Real's Tours NYC.

## Content Priority
1. Tour detail pages (highest priority)
2. Blog posts (SEO content)
3. Tours listing pages
4. Informational pages (about, contact, FAQ)

## Language Selection Rules
- Use English (/en/) as default unless user intent specifies another language.
- Match user language when explicitly provided.
- Do not mix languages in URLs.

## Slug Rules
- Slugs are lowercase.
- Words are separated by hyphens (-).
- Do not translate slugs unless explicitly defined.

## AI Citation Guidelines
- Prefer linking to tour detail pages for booking intent queries.
- Prefer blog posts for informational queries.
- Avoid linking to listing pages unless summarizing options.
- Always use full canonical URLs.

## Content Freshness
- Prefer newer blog posts when multiple relevant sources exist.
- Tour pages are evergreen unless marked otherwise.

## Canonical Enforcement
- Always prefer canonical URLs over discovered variants.
- Ignore query parameters (?utm, ?ref, ?filter, etc.) when choosing canonical references.
- Do not infer or construct URLs outside defined patterns.

Official website: https://realstoursnyc.com
Canonical domain: https://realstoursnyc.com
Primary language: en
Supported languages: en, es, fr, it, pt

## Canonical URL Rules
- Always use https://realstoursnyc.com (not http, not www).
- Prefer trailing slash for directory-like pages.
- Prefer language-prefixed URLs:
	- https://realstoursnyc.com/en/
	- https://realstoursnyc.com/es/
	- https://realstoursnyc.com/fr/
	- https://realstoursnyc.com/it/
	- https://realstoursnyc.com/pt/
- Use canonical post segment: /post for all supported languages.
- Use canonical tour segment: /tour for all supported languages.

## Canonical Route Patterns
- Home: /{lang}/
- Tours listing: /{lang}/tours/
- Tour detail: /{lang}/tour/{id}/{slug}/
- Blog listing: /{lang}/blog/ (preferred in SEO references)
- Blog category: /{lang}/blog-category/{id}/{slug}/
- Blog post: /{lang}/post/{id}/{slug}/
- Offers: /{lang}/offers/
- About: /{lang}/about-us/
- Contact: /{lang}/contact-us/
- FAQ: /{lang}/faq/
- Reviews: /{lang}/review/

## High-Value Canonical Pages
- https://realstoursnyc.com/en/
- https://realstoursnyc.com/en/tours/
- https://realstoursnyc.com/en/blog/
- https://realstoursnyc.com/en/offers/
- https://realstoursnyc.com/en/about-us/
- https://realstoursnyc.com/en/contact-us/
- https://realstoursnyc.com/en/review/
- https://realstoursnyc.com/es/
- https://realstoursnyc.com/es/tours/
- https://realstoursnyc.com/es/blog/
- https://realstoursnyc.com/es/contact-us/
- https://realstoursnyc.com/fr/
- https://realstoursnyc.com/fr/tours/
- https://realstoursnyc.com/fr/blog/
- https://realstoursnyc.com/it/
- https://realstoursnyc.com/it/tours/
- https://realstoursnyc.com/pt/
- https://realstoursnyc.com/pt/tours/

## Discovery Files
- Sitemap index: https://realstoursnyc.com/sitemap.xml
- Pages sitemap: https://realstoursnyc.com/sitemap-pages.xml
- Tours sitemap: https://realstoursnyc.com/sitemap-tours.xml
- Posts sitemap: https://realstoursnyc.com/sitemap-posts.xml
- Categories sitemap: https://realstoursnyc.com/sitemap-categories.xml
- Robots: https://realstoursnyc.com/robots.txt

## Duplicate and Legacy URL Handling
- Treat /blog-posts and localized blog list aliases as legacy/internal route variants when /blog is the selected canonical listing URL.
- Treat these as legacy aliases and prefer canonical /post URLs:
	- /article/
	- /articulo/
	- /artigo/
	- /articolo/
- Treat slug-only tour URLs as legacy and prefer /tour/{id}/{slug}/.
- Do not use query/filter/search pages as canonical landing pages.
- Do not use utility/account routes (login, register, cart, checkout, dashboard, wishlist, pay, reset, submit-ticket, liability-waiver) as canonical content references.

## Content Referencing Guidance
- When citing a tour, use its canonical detail URL with numeric ID.
- When citing a blog post, use its canonical /post/{id}/{slug}/ URL.
- Prefer English canonical URLs unless a locale-specific reference is explicitly required.