# SOUQ SHARE — سوق شير

> SOUQ SHARE is a global bilingual (Arabic/English) marketplace covering 80+ countries with 70+ currencies. It combines a classifieds marketplace (cars, real estate, electronics, jobs, etc.), a job board synced daily from wazaayf.com, and a freelance micro-services marketplace with escrow payment, wallet, and reviews.

Three distinct product lines run on one platform:
1. **Classifieds marketplace** — country-bound listings (free + paid plans)
2. **Job board** — local postings + daily import from wazaayf.com
3. **Micro-services marketplace** — global freelance services with wallet/escrow, similar to Fiverr/Khamsat

## Primary entry points

- [Homepage](https://souqshare.com/) — featured ads, latest services, stores
- [Browse classifieds](https://souqshare.com/browse.php) — full marketplace with filters
- [Browse micro-services](https://souqshare.com/services.php) — freelance services with category/price/rating filters
- [Pricing & subscriptions](https://souqshare.com/pricing.php) — plans for paid tiers
- [Post ad](https://souqshare.com/user/post_ad.php) — free classified listing
- [Post service](https://souqshare.com/user/service_form.php) — sell a micro-service
- [My wallet](https://souqshare.com/user/wallet.php) — top up, withdraw, transaction history
- [Sitemap](https://souqshare.com/sitemap.xml) — all indexed URLs

## Country subdomains (32 active)

Each subdomain auto-locks visitor to that country's listings:
- Arab countries: sa, eg, ae, kw, qa, bh, om, jo, lb, iq, ma, dz, tn, ye, sy, ly, sd, ps, tr, mr
- Europe: de, fr, gb, nl, be, it, es, se, at, ch
- Americas + Oceania: us, ca, au

Example: `https://sa.souqshare.com/` shows Saudi Arabia listings only. The main domain `souqshare.com` auto-detects country via GeoIP.

## Wallet system

- One wallet per user, default currency USD (admin-configurable)
- Top up via Kashier (cards), Vodafone Cash, InstaPay, bank transfer
- Earnings from completed service orders credit automatically (minus platform commission)
- Withdraw via bank transfer or PayPal (globally), or Vodafone Cash/InstaPay (Egypt only)
- Minimum withdrawal $25 USD (admin-configurable)
- All transactions logged immutably in `wallet_transactions` with running balance audit

## Micro-services marketplace

Categories (Khamsat-style):
- Design & Arts, Writing & Translation, Programming & Development, Digital Marketing, Video & Audio, Business & Consulting, Training & Education, Virtual Assistance, WordPress, Other Services

Order lifecycle: `pending_payment → paid → in_progress → delivered → completed` (or `disputed` / `cancelled`).
- Buyer pays via wallet or gateway → funds held in platform escrow
- Seller delivers work (text + file attachments)
- Buyer accepts → seller earnings released (total − commission) to seller wallet
- Auto-accept after 3 days if buyer doesn't act (admin-tunable)
- Disputes resolved by admin (refund buyer or release to seller)
- Reviews + ratings update service aggregates for sort-by-rating

## External integrations

- **wazaayf.com** — daily sync imports active job listings into the Jobs category. Jobs link out to wazaayf for application.
- **khedmahonline.com** — scrapes public service pages daily and imports them as affiliate listings. Orders link out to khedmahonline.

## Key categories (top-level)

Vehicles, Real Estate, Electronics, Home & Furniture, Fashion, Jobs, Services (micro-services), Pets, Business & Industrial, Sports & Hobbies, Books & Media, Kids & Baby, Beauty & Health, Food & Groceries

Job subcategories: Full-time, Part-time, Freelance, Internships, Job Seekers (CVs)

## Languages

- العربية (Arabic, RTL) — primary
- English (LTR)
- Language auto-detected: explicit URL ?lang=ar|en → session/cookie → country subdomain (Arab=AR, else EN) → Accept-Language header → default AR

## API endpoints (read-only)

- `/sitemap.xml` — full sitemap (dynamic)
- `/llms.txt` — this file
- `/robots.txt` — crawler rules (AI bots whitelisted)

No public REST API for ads/services yet — the marketplace is consumed through the web UI.

## Trust signals

- All passwords bcrypt-hashed
- CSRF tokens on every form
- reCAPTCHA v2 on registration
- Escrow protects buyers in micro-services
- Reviews + 5-star ratings on completed orders
- Verified merchant badges
- Admin moderation: pending → approved workflow for ads, services, blog posts

## Coverage by region

**Middle East:** Saudi Arabia, UAE, Egypt, Kuwait, Qatar, Bahrain, Oman, Jordan, Lebanon, Syria, Iraq, Yemen, Palestine, Libya, Tunisia, Algeria, Morocco, Sudan, Somalia, Mauritania, Djibouti, Comoros
**Asia:** Turkey, Iran, Afghanistan, Pakistan, India, Bangladesh, Indonesia, Malaysia, Singapore, Thailand, Philippines, Vietnam, China, Japan, South Korea, Hong Kong, Taiwan
**Europe:** UK, France, Germany, Italy, Spain, Portugal, Netherlands, Belgium, Switzerland, Austria, Sweden, Norway, Denmark, Finland, Ireland, Poland, Czech Republic, Hungary, Romania, Ukraine, Russia
**Americas:** USA, Canada, Mexico, Brazil, Argentina, Chile, Colombia, Peru, Venezuela
**Africa:** South Africa, Nigeria, Kenya, Ghana, Ethiopia, Uganda, Tanzania
**Oceania:** Australia, New Zealand
**Other:** Israel, Kazakhstan, Uzbekistan, Azerbaijan

## Contact

Operated by Mostafa Elwan Programming Co.
General: contact@souqshare.com