# AutoTrego — Full Documentation

> AutoTrego (autotrego.com) is an online vehicle marketplace for buying and selling automobiles, motorcycles, and trucks in Albania. It connects private sellers and business dealers with buyers, offering free listings, paid promotional boosts, and subscription plans for increased visibility. Browsing and searching is completely free and requires no account.

- Albanian version: https://autotrego.com/llms-sq.txt
- Summary version: https://autotrego.com/llms.txt

## About

AutoTrego is Albania's vehicle classifieds platform, launched in 2024 and headquartered in Tirana. The platform supports both Albanian (default) and English languages and serves individual sellers, business dealers, and buyers across Albania.

- Website: https://autotrego.com
- Email: support@autotrego.com
- Phone: +355685055057
- Location: Tirana, Albania
- Mobile apps: Android and iOS

## Vehicle Categories

AutoTrego supports three vehicle categories, each with its own listing and search pages:

| Category    | URL path | Description                                  |
|-------------|----------|----------------------------------------------|
| Automobiles | `/auto`  | Cars, sedans, SUVs, hatchbacks, coupes, etc. |
| Motorcycles | `/bike`  | Motorcycles and scooters                      |
| Trucks      | `/truck` | Trucks, vans, and commercial vehicles         |

## Vehicle Data Model

Every vehicle listing contains the following information:

### Core Fields
- **Make** — vehicle manufacturer (e.g., Audi, BMW, Mercedes-Benz, Toyota, Volkswagen)
- **Model** — specific model within the make (e.g., A4, 320i, C-Class, Corolla, Golf)
- **Generation** — model generation/variant
- **Year** — manufacturing year (1885+)
- **Price** — listing price in EUR
- **Mileage** — odometer reading in km
- **Description** — free-text seller description (2–3000 characters)
- **Images** — up to 50 photos per listing
- **Video** — optional video URL
- **Location** — seller location (Albanian cities)

### Technical Specifications
- **Engine type / Fuel:** Diesel, Benzine (Petrol), Electric, Benzine + GAZ (LPG), Hybrid (Diesel/Electric), Hybrid (Petrol/Electric), CNG
- **Transmission:** Automatic (`auto`), Manual (`manual`)
- **Body type:** Convertible, Coupe, Estate, Hatchback, Pickup, Saloon, MiniVan/MPV, SUV
- **Color**

### Detailed Modification Data (when available)
Vehicles may include enriched technical data:
- Engine displacement, cylinders, power (HP), torque (Nm)
- Acceleration, max speed
- Fuel consumption (urban, extra-urban, combined)
- Drivetrain, gearbox type
- Dimensions (length, width, height), curb weight
- Electric motor specs (for hybrids/EVs): battery capacity, electric range, motor power
- Emission standard, oil capacity, oil specs

### Listing Status
- **Approved** — reviewed and visible on the platform
- **Sold** — marked as sold by the seller
- **Valid until** — listing expiration date (can be extended)
- **Views** — number of detail page views
- **Impressions** — number of times shown in listings
- **Likes** — number of users who saved it to their garage

## Search & Filters

### Search URL Pattern
```
https://autotrego.com/{type}/search?{filters}
```

### Example Searches
- All Audi cars: `https://autotrego.com/auto/search?makeId=Audi`
- All BMW cars: `https://autotrego.com/auto/search?makeId=BMW`
- All Mercedes-Benz cars: `https://autotrego.com/auto/search?makeId=Mercedes-Benz`
- All Toyota cars: `https://autotrego.com/auto/search?makeId=Toyota`
- All Volkswagen cars: `https://autotrego.com/auto/search?makeId=Volkswagen`
- All motorcycles: `https://autotrego.com/bike/search`
- All trucks: `https://autotrego.com/truck/search`

### Available Filter Parameters
| Parameter     | Type    | Description                                                |
|---------------|---------|------------------------------------------------------------|
| `makeId`      | string  | Vehicle make name (e.g., `Audi`, `BMW`, `Mercedes-Benz`)  |
| `makeTypeId`  | string  | Vehicle model ID                                           |
| `year`        | number  | Minimum manufacturing year                                 |
| `yearTo`      | number  | Maximum manufacturing year                                 |
| `price`       | number  | Minimum price                                              |
| `priceTo`     | number  | Maximum price                                              |
| `mileage`     | number  | Minimum mileage                                            |
| `mileageTo`   | number  | Maximum mileage                                            |
| `engineType`  | string  | Fuel type filter                                           |
| `transmission`| string  | `auto` or `manual`                                         |
| `bodyType`    | string  | Body type filter                                           |
| `color`       | string  | Color filter                                               |
| `sort`        | string  | Sort direction                                             |
| `sortField`   | string  | Field to sort by                                           |
| `page`        | number  | Page number for pagination                                 |
| `limit`       | number  | Results per page                                           |

## User Types

| Role       | ID | Description                                                    |
|------------|----|----------------------------------------------------------------|
| Individual | 1  | Private sellers — can list vehicles for free                   |
| Dealer     | 2  | Business dealers — dedicated profile page, bulk listing tools  |

### User Profiles
- Name, surname, profile photo
- Phone number (verified via SMS)
- WhatsApp number
- Social links: website, Instagram, Facebook
- Location (address + coordinates)
- About Us description (dealers)

## Advertising & Boost Products

### Boost Types
| Type        | Description                                                        |
|-------------|--------------------------------------------------------------------|
| Starred     | Featured badge on listing card — increased visibility in results   |
| Top         | Appears at the top of category and search result pages             |
| StarredTop  | Combined: featured badge + top placement                           |

### Subscription Plans
| Plan    | Description                                              |
|---------|----------------------------------------------------------|
| Free    | Basic listing features, no cost                          |
| Basic   | Enhanced visibility and listing features                 |
| Premium | Maximum exposure, priority placement, all features       |

Boosts are time-limited (valid for a set number of days) and purchased via Stripe. Each boost tracks its own views and impressions.

## Vehicle Service Tracker

Users can track maintenance and service records for their vehicles:

| Service Type   | Albanian            | English              |
|----------------|---------------------|----------------------|
| Vehicle Tax    | Taksa Mjeti         | Vehicle Tax          |
| Insurance      | Siguracion Mjeti    | Vehicle Insurance    |
| Inspection     | Kolaudim            | Inspection           |
| Oil + Filters  | Vaj + Filtra        | Oil + Filters        |
| Brakes         | Frenat              | Brakes               |
| Timing Belt    | Rrip Faze           | Timing Belt          |
| AC Filter      | AC Filter (Filter Kabine) | AC Filter (Cabin Filter) |
| Other          | Tjera               | Other                |

## Content Sections & Pages

### Public Pages (no account required)
- `/` — Homepage with featured vehicles, popular makes, body types, and blog highlights
- `/auto` — Automobile listings
- `/bike` — Motorcycle listings
- `/truck` — Truck and commercial vehicle listings
- `/auto/search?makeId=Audi` — Search with filters (example: Audi cars)
- `/auto/search?makeId=BMW` — Search with filters (example: BMW cars)
- `/auto/search?makeId=Mercedes-Benz` — Search with filters (example: Mercedes-Benz cars)
- `/auto/search?makeId=Toyota` — Search with filters (example: Toyota cars)
- `/auto/search?makeId=Volkswagen` — Search with filters (example: Volkswagen cars)
- `/[type]/[slug]` — Individual vehicle detail page with full specs, photos, and seller info
- `/[type]/search` — Filtered search results with pagination
- `/all-makes` — Full directory of all vehicle makes and logos
- `/blogs` — Automotive blog listing (powered by Contentful CMS)
- `/blogs/[slug]` — Individual blog posts
- `/dealers` — Directory of registered business dealers
- `/dealer/[userId]` — Individual dealer profile with their listings
- `/about-us` — About AutoTrego
- `/privacy-policy` — Privacy policy (Albanian data protection compliance)

### Authentication Pages
- `/login` — User login (Firebase Authentication)
- `/login/forgot-password` — Password reset
- `/register` — New user registration with phone verification

### Protected Pages (account required)
- `/account` — Account settings and profile management
- `/account/posts` — User's own vehicle listings
- `/account/orders` — Purchase and order history
- `/account/password` — Change password
- `/account/plan` — Subscription plan selection
- `/garage` — Saved/liked vehicles
- `/checkout` — Purchase checkout (Stripe)
- `/offers/[level]` — Pricing and plan details

## Albanian Cities Supported

Tirana, Durrës, Vlorë, Kamëz, Fier, Shkodër, Elbasan, Korçë, Sarandë, Berat, Lushnjë, Kavajë, Gjirokastër, Pogradec, Fushë-Krujë, Laç, Kukës, Lezhë, Patos, Peshkopi, Librazhd, Kuçovë, Krujë, Burrel, Rrëshen, Belsh, Divjakë, Gramsh, Bulqizë, and more.

## Access & Privacy

- **Free to browse:** No account or payment required to search and view any vehicle listing
- **Free to list:** Any user can create an account and post vehicle listings at no cost
- **Optional paid features:** Ad boosts and premium plans are available but never mandatory
- **Account security:** User accounts are protected with Firebase Authentication; sessions are managed via secure cookies
- **Data control:** Sellers and dealers have full control over their listings and personal information — they can edit, hide, or delete their posts and account data at any time
- **Privacy compliance:** The platform handles personal data in accordance with Albanian data protection law
- **No data sharing without consent:** User contact details are only visible to logged-in users and are never exposed publicly in raw form
- **Phone verification:** Phone numbers are verified via SMS (Twilio) during registration
- **Bot protection:** Google reCAPTCHA protects forms and submissions

## Languages

| Code | Language | Example phrase                                |
|------|----------|-----------------------------------------------|
| sq   | Albanian | "Gjeni makina për shitje në Shqipëri"         |
| en   | English  | "Find cars for sale in Albania"               |

Albanian is the default language. All UI elements, labels, and content are available in both languages.

## Social

- Facebook: AutoTrego
- Instagram: @autotrego
- TikTok: @autotrego
- YouTube: @AutoTrego

## Sitemap & Indexing

- Sitemap: https://autotrego.com/sitemap.xml
- Robots: https://autotrego.com/robots.txt