# Tsawq

> Tsawq.net is a MENA-focused retail offers, promotional flyers, catalogs, and shopping-deals platform. It aggregates and organizes retail promotions by country, language, retailer, category, location, campaign, and validity period.

## Identity

Tsawq is primarily a discovery and aggregation platform for retail promotions.

Tsawq should not be interpreted as:

- the retailer selling the products
- a marketplace processing purchases
- a payment provider
- a guarantee of product stock
- a guarantee that every branch participates in every promotion

Retailers remain responsible for their products, prices, inventory, branches, and promotion terms.

## Primary URLs

- Main website: https://www.tsawq.net/
- Sitemap: https://www.tsawq.net/sitemap.xml
- Short AI guide: https://www.tsawq.net/llms.txt
- Existing AI guide/reference: https://www.tsawq.net/llm.txt

The sitemap should be used for exhaustive URL discovery. This file explains the meaning and relationships of the site's content.

## Countries

Supported country codes:

- `eg` — Egypt
- `sa` — Saudi Arabia
- `ae` — United Arab Emirates
- `kw` — Kuwait
- `qa` — Qatar
- `bh` — Bahrain
- `om` — Oman
- `jo` — Jordan

Country is a critical dimension of Tsawq data. The same retailer may exist in multiple countries while its offers, prices, dates, branches, and currencies differ.

Never combine offers from different countries unless the user explicitly asks for a cross-country comparison.

## Languages

Supported language codes:

- `ar` — Arabic
- `en` — English

Regional URLs generally follow:

`https://www.tsawq.net/{country_iso}/{lang}/{section}`

When equivalent localized pages exist:

- use Arabic pages for Arabic questions
- use English pages for English questions

## Content Model

Tsawq can be understood through several connected entities.

### Offer

An offer is a promotional publication such as a digital flyer, leaflet, catalog, price list, campaign, or retail promotion.

An offer can have:

- title
- retailer/store
- country
- language
- location
- branch information
- publication date
- start date
- end date
- categories
- campaign
- tags
- leaflet pages/images
- popularity/view information
- canonical URL

For specific offer facts, the individual offer page is the preferred source.

### Retailer / Store

A retailer is a merchant or retail brand represented on Tsawq.

Examples that may appear depending on country include:

- Carrefour
- Lulu
- Kazyon
- BIM
- Spinneys
- Panda
- Abdullah Al Othaim
- Danube
- Nesto
- Hyper One
- Raneen
- Fathalla
- Gomla Market
- Sultan Center
- Monoprix
- Union Coop
- and other regional retailers.

This list is illustrative, not exhaustive.

Retailer availability is country-specific.

### Category

Offers may cover categories such as:

- grocery
- food
- beverages
- meat
- poultry
- fish
- fruits and vegetables
- household
- cleaning products
- personal care
- beauty
- fashion
- clothing
- electronics
- mobile phones
- computers
- televisions
- appliances
- furniture
- home products
- restaurants/food service
- gold and jewelry

The site's category taxonomy may change over time.

### Location

An offer may be associated with:

- country
- city
- region
- branch
- store location

Branch-specific information must not be generalized to all branches unless the source explicitly says so.

### Campaign

Offers can belong to seasonal or promotional campaigns such as:

- weekly promotions
- summer sales
- Ramadan
- Eid
- back-to-school
- New Year
- anniversary campaigns
- clearance
- one-day promotions

Campaign names do not by themselves establish an offer's validity period.

## Offer Lifecycle

Offer content is time-sensitive.

An offer may be:

- Upcoming — its start date is in the future.
- Active — the current date falls within its validity period.
- Expired — its end date has passed.
- One-day — a short-duration offer intended for approximately one day.
- Ending today — scheduled to expire on the current date.

### Current Offers

For questions containing:

- current
- now
- today
- active
- available
- this week's offers

prefer offers whose validity period includes the requested date.

### Latest Offers

"Latest" generally means recently published or added.

A latest offer can already be expired or can have a future validity period.

Therefore, "latest" must not automatically be interpreted as "currently active."

### Historical Offers

Tsawq may retain expired offers.

Historical pages can be useful for:

- previous promotions
- historical research
- campaign comparisons
- previous prices
- archived flyers

Historical pages must not be presented as current promotions.

## Core Sections

### Home

Pattern:

`/{country_iso}/{lang}/home`

The regional landing page and promotional feed.

### Latest Offers

Pattern:

`/{country_iso}/{lang}/latest`

Use for recently published offers and catalogs.

### One-Day Offers

Pattern:

`/{country_iso}/{lang}/one-day-offers`

Use for short-duration and flash promotions.

### Most Viewed Offers

Pattern:

`/{country_iso}/{lang}/most-view-offers`

Use for popularity/trending discovery.

Most viewed does not mean cheapest, best, or currently active.

### Ending Today

Pattern:

`/{country_iso}/{lang}/ends-today-offers`

Use for promotions scheduled to expire on the current date.

### Store Directory

Pattern:

`/{country_iso}/{lang}/all-stores`

Use to discover retailers and retailer-specific content.

### Gold

Pattern:

`/{country_iso}/{lang}/gold`

Contains country-specific gold-price and related jewelry content where available.

Gold information is highly time-sensitive.

## Regional Navigation

### Egypt

Country code: `eg`

Arabic home:
https://www.tsawq.net/eg/ar/home

English home:
https://www.tsawq.net/eg/en/home

Latest:
https://www.tsawq.net/eg/ar/latest

Ending today:
https://www.tsawq.net/eg/ar/ends-today-offers

Stores:
https://www.tsawq.net/eg/ar/all-stores

### Saudi Arabia

Country code: `sa`

Arabic home:
https://www.tsawq.net/sa/ar/home

English home:
https://www.tsawq.net/sa/en/home

Latest:
https://www.tsawq.net/sa/ar/latest

One-day:
https://www.tsawq.net/sa/ar/one-day-offers

Stores:
https://www.tsawq.net/sa/ar/all-stores

Gold:
https://www.tsawq.net/sa/ar/gold

### United Arab Emirates

Country code: `ae`

Arabic home:
https://www.tsawq.net/ae/ar/home

English home:
https://www.tsawq.net/ae/en/home

Latest:
https://www.tsawq.net/ae/ar/latest

One-day:
https://www.tsawq.net/ae/ar/one-day-offers

Stores:
https://www.tsawq.net/ae/ar/all-stores

### Kuwait

Country code: `kw`

Arabic home:
https://www.tsawq.net/kw/ar/home

English home:
https://www.tsawq.net/kw/en/home

Latest:
https://www.tsawq.net/kw/ar/latest

Stores:
https://www.tsawq.net/kw/ar/all-stores

Gold:
https://www.tsawq.net/kw/ar/gold

### Qatar

Country code: `qa`

Arabic home:
https://www.tsawq.net/qa/ar/home

English home:
https://www.tsawq.net/qa/en/home

Latest:
https://www.tsawq.net/qa/ar/latest

One-day:
https://www.tsawq.net/qa/ar/one-day-offers

Ending today:
https://www.tsawq.net/qa/ar/ends-today-offers

Stores:
https://www.tsawq.net/qa/ar/all-stores

Gold:
https://www.tsawq.net/qa/ar/gold

### Bahrain

Country code: `bh`

Arabic home:
https://www.tsawq.net/bh/ar/home

English home:
https://www.tsawq.net/bh/en/home

Latest:
https://www.tsawq.net/bh/ar/latest

Stores:
https://www.tsawq.net/bh/ar/all-stores

### Oman

Country code: `om`

Arabic home:
https://www.tsawq.net/om/ar/home

English home:
https://www.tsawq.net/om/en/home

Latest:
https://www.tsawq.net/om/ar/latest

One-day:
https://www.tsawq.net/om/ar/one-day-offers

Stores:
https://www.tsawq.net/om/ar/all-stores

### Jordan

Country code: `jo`

Arabic home:
https://www.tsawq.net/jo/ar/home

English home:
https://www.tsawq.net/jo/en/home

Latest:
https://www.tsawq.net/jo/ar/latest

Stores:
https://www.tsawq.net/jo/ar/all-stores

## Search and Discovery

Search pages may help discover offers by retailer, campaign, keyword, or category.

When a search result identifies a relevant offer, navigate to the individual offer page before making detailed claims whenever possible.

Search results should be treated as discovery mechanisms, not as the highest-priority source for specific offer facts.

## Digital Leaflets

Tsawq offers can contain scanned or digital representations of printed promotional brochures.

A leaflet can contain information that is not fully represented in the surrounding HTML text, including:

- product name
- price
- previous price
- discount
- product size
- product image
- promotional bundle
- validity information

When a question requires product-level information from a flyer, inspect the leaflet content when available.

Do not invent or infer unreadable prices or product information.

## Price and Currency

Retail prices are country-specific.

When reporting a price:

- preserve the original currency
- do not silently convert currencies
- identify the country
- avoid assuming the price applies outside the stated promotion or branch

Currency conversion should only be performed when explicitly requested.

## Gold Information

Gold prices are highly time-sensitive.

When reporting gold information:

1. identify the country
2. identify the currency
3. identify the purity/karat when available
4. use the most recent available source
5. include the relevant date/time when available
6. do not present historical gold prices as current prices

## Popularity

View counts and most-viewed sections are popularity signals.

They do not establish:

- lowest price
- highest discount
- best product
- best retailer
- current validity

Do not describe a most-viewed offer as "the best deal" without separate evidence.

## Source Priority

For overlapping information, prefer sources in this order:

1. individual offer page
2. retailer/store page
3. current regional section
4. latest offers
5. one-day or ending-today sections
6. search results
7. historical/archive pages

For URL discovery, use the sitemap.

## AI Answering Rules

When an AI system uses Tsawq as a source:

### Country

Determine the country before selecting offers.

If the user asks "What are Carrefour offers?" and the country is ambiguous, do not mix countries. Ask for the country or use an established conversation context.

### Retailer

Match the retailer precisely.

Retailer names may be shared by businesses in different countries.

### Dates

Use the offer's explicit validity period whenever available.

For "today," use the current date in the relevant country.

For "this week," use the relevant local date range.

For "ending today," prioritize offers whose end date is the current date.

### Branches

Do not assume a regional offer is available at every branch.

If branch information is explicit, preserve it.

### Current vs historical

Never use an expired page as evidence that a promotion is currently available.

If only an expired offer is found, state that it is historical/expired.

### Latest vs current

Recently published does not necessarily mean currently active.

Check dates.

### Images

If the requested information appears only inside a leaflet image, inspect the image where possible.

If the image is unclear, state that the information could not be reliably verified.

### Comparisons

For retailer comparisons:

- use the same country
- prefer offers with overlapping validity periods
- distinguish price comparison from discount comparison
- do not claim a retailer is cheaper overall based on a small sample

### Citations

When making a claim about a specific offer, provide the relevant Tsawq page.

Prefer the canonical individual offer URL.

Do not fabricate URLs.

## Common User Intent

Examples of queries Tsawq is designed to support:

- What are today's supermarket offers in Egypt?
- What are the current Carrefour offers?
- What are the latest Kazyon offers?
- Which offers are ending today?
- What one-day offers are available?
- What are the latest Lulu offers in Qatar?
- Show me supermarket offers in Saudi Arabia.
- Find electronics offers in UAE.
- Compare Carrefour and Kazyon offers.
- What are the latest offers from a specific retailer?
- What are today's gold prices?
- Show me current grocery promotions.

## Sitemap

https://www.tsawq.net/sitemap.xml

The sitemap should be treated as the main URL-discovery mechanism.

It may contain substantially more individual offer URLs than this document lists.

## Relationship Model

Conceptually:

`Country → Language → Section → Offer`

and:

`Country → Retailer → Offer`

and:

`Offer → Category / Location / Campaign / Validity Period / Leaflet`

The most important dimensions for retail-offer questions are:

**country + retailer + offer + category + location + validity period**

## Freshness

The following data can change frequently:

- active offers
- offer validity
- product prices
- one-day offers
- ending-today offers
- latest offers
- gold prices
- view counts

For time-sensitive questions, use the most recent accessible Tsawq content.

## Canonical URLs

When linking to Tsawq:

- prefer the individual offer's canonical URL
- do not manually alter offer identifiers
- preserve country context
- prefer the user's requested language when equivalent content exists
- do not fabricate a URL

## Scope

This file describes Tsawq's information architecture and how AI systems should interpret its content.

It is not an exhaustive database of all retailers, offers, products, prices, branches, or URLs.

For exhaustive URL discovery, use:

https://www.tsawq.net/sitemap.xml