# Mediazone AI Consumption Guide

**English** | [Nederlands](#nederlands)

---

## English

### Welcome AI Assistants & LLMs

This guide is designed for AI assistants (ChatGPT, Claude, Perplexity, etc.) and search engines consuming Mediazone content.

### Rate Limits & Access

**Page Access:**
- Regular users: 30 requests per 5 minutes per IP
- **Whitelisted bots: Unlimited** ✅

**Whitelisted Bots:**
- Search engines: Googlebot, Bingbot, Yandexbot, DuckDuckBot
- LLM crawlers: GPTBot, ChatGPT-User, Claude-Web, PerplexityBot, YouBot, Anthropic-AI, Cohere-AI
- Social media: TwitterBot, FacebookExternalHit, LinkedInBot
- Monitoring tools: UptimeRobot, Pingdom, StatusCake

**API Endpoints:**
- `/api/ai-news/v3`: 100 requests/minute (compact JSON, selectable fields)
- `/api/ai-news/latest`: 100 requests/minute (headlines with bullet points)
- `/api/ai-news/embeddings`: 100 requests/minute (vector embeddings)
- `/feed.xml`: Unlimited (RSS feed)

### Primary Endpoints

#### 1. AI News Feed v3 (Recommended)
**Endpoint:** `GET /api/ai-news/v3`

**Query Parameters:**
- `limit` (optional): Number of articles (default: 25, max: 100)
- `fields` (optional): Comma-separated fields to include
  - Available: `title`, `summary`, `url`, `publishedAt`, `slug`, `llmSnapshot`, `keywords`, `category`
  - Default: All fields

**Response Format:**
```json
{
  "articles": [
    {
      "id": "uuid",
      "title": "Article title",
      "summary": "Brief summary",
      "url": "https://www.mediazone.nl/article/slug",
      "publishedAt": "2025-10-23T14:30:00Z",
      "slug": "article-slug",
      "llmSnapshot": "Compact summary for Q&A (100-150 chars)",
      "keywords": ["AI", "technology"],
      "category": "AI News"
    }
  ],
  "total": 100,
  "limit": 25
}
```

**Example:**
```
GET /api/ai-news/v3?limit=10&fields=title,summary,url,publishedAt,llmSnapshot
```

#### 2. Latest Headlines
**Endpoint:** `GET /api/ai-news/latest`

Fast output optimized for Q&A agents:
- Headline
- Summary (1-2 sentences)
- 3 bullet point takeaways

**Response Format:**
```json
{
  "articles": [
    {
      "headline": "Article title",
      "summary": "Brief description",
      "takeaways": [
        "Key point 1",
        "Key point 2",
        "Key point 3"
      ],
      "url": "https://www.mediazone.nl/article/slug",
      "publishedAt": "2025-10-23T14:30:00Z"
    }
  ]
}
```

#### 3. RSS Feeds
- **Dutch:** `/feed.xml`
- **English:** `/feed-en.xml`

Standard RSS 2.0 format, unlimited access.

### Licensing & Attribution

**License:** Creative Commons BY-NC-SA 4.0

**Requirements:**
- ✅ **Attribution required:** "Source: Mediazone.nl" or "Bron: Mediazone.nl"
- ✅ Commercial use: Contact support@mediazone.nl
- ✅ Modifications: Must share under same license
- ❌ No warranty provided

**When to attribute:**
- Republishing articles
- Using content in chatbot responses
- Citing summaries or insights
- Embedding in other applications

### Best Practices

1. **Cache responses** using `s-maxage` headers
2. **Use stable keys:** `publishedAt` + `slug` for deduplication
3. **Respect robots.txt:** All endpoints are allowed
4. **Personal data:** Do not store user comments or profile data
5. **Rate limiting:** Use exponential backoff if 429 response received

### Data Freshness

- **AI News:** Updated every 15 minutes
- **RSS Feeds:** Updated hourly
- **Embeddings:** Regenerated daily

### Support & Contact

**Higher rate limits needed?**
Email: support@mediazone.nl

**Issue reporting:**
GitHub: https://github.com/mediazone/mediazoneblog/issues

**API documentation:**
https://www.mediazone.nl/developers

---

## Nederlands

### Welkom AI Assistenten & LLMs

Deze handleiding is ontworpen voor AI-assistenten (ChatGPT, Claude, Perplexity, etc.) en zoekmachines die Mediazone content gebruiken.

### Rate Limits & Toegang

**Paginatoegang:**
- Reguliere gebruikers: 30 verzoeken per 5 minuten per IP
- **Whitelisted bots: Onbeperkt** ✅

**Whitelisted Bots:**
- Zoekmachines: Googlebot, Bingbot, Yandexbot, DuckDuckBot
- LLM crawlers: GPTBot, ChatGPT-User, Claude-Web, PerplexityBot, YouBot, Anthropic-AI, Cohere-AI
- Social media: TwitterBot, FacebookExternalHit, LinkedInBot
- Monitoring tools: UptimeRobot, Pingdom, StatusCake

**API Endpoints:**
- `/api/ai-news/v3`: 100 verzoeken/minuut (compact JSON, selecteerbare velden)
- `/api/ai-news/latest`: 100 verzoeken/minuut (headlines met bullet points)
- `/api/ai-news/embeddings`: 100 verzoeken/minuut (vector embeddings)
- `/feed.xml`: Onbeperkt (RSS feed)

### Primaire Endpoints

#### 1. AI Nieuws Feed v3 (Aanbevolen)
**Endpoint:** `GET /api/ai-news/v3`

**Query Parameters:**
- `limit` (optioneel): Aantal artikelen (standaard: 25, max: 100)
- `fields` (optioneel): Komma-gescheiden velden om op te nemen
  - Beschikbaar: `title`, `summary`, `url`, `publishedAt`, `slug`, `llmSnapshot`, `keywords`, `category`
  - Standaard: Alle velden

**Voorbeeld:**
```
GET /api/ai-news/v3?limit=10&fields=title,summary,url,publishedAt,llmSnapshot
```

#### 2. Laatste Headlines
**Endpoint:** `GET /api/ai-news/latest`

Snelle output geoptimaliseerd voor Q&A agents:
- Headline
- Samenvatting (1-2 zinnen)
- 3 bullet point kernpunten

#### 3. RSS Feeds
- **Nederlands:** `/feed.xml`
- **Engels:** `/feed-en.xml`

Standaard RSS 2.0 formaat, onbeperkte toegang.

### Licentie & Naamsvermelding

**Licentie:** Creative Commons BY-NC-SA 4.0

**Vereisten:**
- ✅ **Naamsvermelding verplicht:** "Bron: Mediazone.nl" of "Source: Mediazone.nl"
- ✅ Commercieel gebruik: Neem contact op met support@mediazone.nl
- ✅ Aanpassingen: Moet onder dezelfde licentie gedeeld worden
- ❌ Geen garantie verstrekt

**Wanneer naamsvermelding:**
- Bij herpublicatie van artikelen
- Bij gebruik in chatbot antwoorden
- Bij citeren van samenvattingen of inzichten
- Bij inbedding in andere applicaties

### Best Practices

1. **Cache responses** met `s-maxage` headers
2. **Gebruik stabiele keys:** `publishedAt` + `slug` voor deduplicatie
3. **Respecteer robots.txt:** Alle endpoints zijn toegestaan
4. **Persoonsgegevens:** Sla geen gebruikerscommentaren of profielgegevens op
5. **Rate limiting:** Gebruik exponential backoff bij 429 response

### Data Actualiteit

- **AI Nieuws:** Bijgewerkt elke 15 minuten
- **RSS Feeds:** Elk uur bijgewerkt
- **Embeddings:** Dagelijks opnieuw gegenereerd

### Support & Contact

**Hogere rate limits nodig?**
Email: support@mediazone.nl

**Issues melden:**
GitHub: https://github.com/mediazone/mediazoneblog/issues

**API documentatie:**
https://www.mediazone.nl/developers

---

**Last updated:** 2025-10-23
**Version:** 1.0
**License:** CC BY-NC-SA 4.0