# خصم كودز - KhasmCodes
> أكبر موقع كوبونات وأكواد خصم في الوطن العربي
> ⚡ For the LIVE dynamic version with real-time coupon data, visit: https://khasmcodes.com/llms.txt
> 📄 For the FULL version with all articles and store profiles: https://khasmcodes.com/llms-full.txt

## About
KhasmCodes (خصم كودز) is the largest Arabic coupon and discount code website, providing verified discount codes for major online stores in the Middle East and North Africa.

## Website
- Main: https://khasmcodes.com
- Blog: https://khasmcodes.com/blog
- Stores: https://khasmcodes.com/stores
- Categories: https://khasmcodes.com/categories

## API Endpoints for AI/Bots

Since this is a React SPA, use these endpoints to get rendered content:

### 1. Articles List (NEW!)
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/articles-list
```

**Parameters:**
- `limit`: Number of articles (default: 50, max: 100)
- `offset`: Pagination offset (default: 0)
- `category`: Filter by category slug
- `store`: Filter by store slug
- `format`: Response format (json, rss, sitemap)

**Examples:**
- All articles: `/articles-list`
- With pagination: `/articles-list?limit=20&offset=40`
- Filter by store: `/articles-list?store=noon`
- RSS format: `/articles-list?format=rss`

### 2. Single Article Content
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/article-content?id={article_id}&format={format}
```

**Parameters:**
- `id`: Article UUID
- `slug`: Article title (partial match)
- `format`: html (default), text, markdown, json

**Examples:**
- HTML: `/article-content?id=abc123&format=html`
- JSON: `/article-content?id=abc123&format=json`
- Markdown: `/article-content?id=abc123&format=markdown`

### 3. Stores List with Coupons
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/stores-list
```

**Parameters:**
- `limit`: Number of stores (default: 50, max: 100)
- `offset`: Pagination offset
- `category`: Filter by category slug
- `featured`: Show featured stores only (true/false)
- `include_coupons`: Include coupons for each store (default: true)

**Examples:**
- All stores: `/stores-list`
- Featured only: `/stores-list?featured=true`
- Fashion stores: `/stores-list?category=fashion`

### 4. Search Content (NEW!)
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/search-content
```

**Parameters:**
- `q` or `query`: Search query (required, min 2 characters)
- `type`: Filter by content type (all, articles, stores, coupons)
- `limit`: Max results per type (default: 20, max: 50)
- `format`: Response format (json, simple)

**Examples:**
- Search all: `/search-content?q=نون`
- Articles only: `/search-content?q=خصم&type=articles`
- Simple format: `/search-content?q=شي ان&format=simple`

### 5. RSS Feed
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/rss-feed
```

### Sitemap
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/sitemap
```

## Content Structure

### Articles
Articles contain:
- Coupon codes and discount information
- Store-specific guides
- Shopping tips and tutorials
- Seasonal offers and deals

### Stores
Major stores covered:
- Noon (نون)
- Amazon (أمازون)
- Namshi (نمشي)
- Shein (شي إن)
- AliExpress
- Max Fashion
- And 50+ more stores

### Categories
- Electronics (إلكترونيات)
- Fashion (أزياء)
- Beauty (جمال)
- Food & Restaurants (طعام ومطاعم)
- Travel (سفر)
- And more

## Contact
- Website: https://khasmcodes.com
- Contact Page: https://khasmcodes.com/contact

## Robots
Robots.txt: https://khasmcodes.com/robots.txt
Sitemap: https://khasmcodes.com/sitemap.xml

## Notes for AI Assistants
1. This website is in Arabic (RTL)
2. Content is dynamically loaded via React
3. Use the API endpoints above for programmatic access
4. All coupon codes are verified and updated regularly
5. Prices and discounts are in local currencies (SAR, AED, EGP, etc.)

## Rate Limiting
All API endpoints have rate limiting to prevent abuse:
- **Articles List**: 60 requests/minute
- **Article Content**: 100 requests/minute
- **Stores List**: 60 requests/minute
- **Search Content**: 30 requests/minute
- **Site Stats**: 60 requests/minute

Response includes headers:
- `X-RateLimit-Limit`: Maximum requests allowed
- `X-RateLimit-Remaining`: Requests remaining in window
- `X-RateLimit-Reset`: Unix timestamp when limit resets

If limit exceeded: HTTP 429 with `retry_after` in seconds

## Additional Endpoints

### 6. Site Statistics
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/site-stats
```

Returns comprehensive site statistics:
- Total counts (stores, coupons, articles, categories)
- Recent activity (new coupons/articles in last 7 days)
- Top stores by coupon count
- API links

### 7. Coupon Webhook (for Developers)
```
GET https://totctpfeelfmaegfqpca.supabase.co/functions/v1/webhook-coupon
POST https://totctpfeelfmaegfqpca.supabase.co/functions/v1/webhook-coupon
```

**Register a webhook to receive notifications when new coupons are added:**
```json
POST body: { "webhook_url": "https://your-server.com/webhook" }
```

**Payload sent to your webhook:**
```json
{
  "event": "new_coupon",
  "timestamp": "2026-02-07T12:00:00.000Z",
  "data": {
    "code": "SAVE10",
    "title": "خصم 10%",
    "discount": "10%",
    "store": { "name": "نون", "slug": "noon" }
  }
}
```

Compatible with: n8n, Zapier, Make, custom servers