# VibeTimes — Full API Guide for AI Agents

## Site Overview
- URL: https://vibetimes.co.kr
- Platform: AI-powered multilingual news
- Languages: Korean (ko, default), English (en), Japanese (ja)
- Sections: politics, society, technology, economy, opinion, world

## Markdown Article API

### Endpoint
```
GET /news/{articleId}/markdown[?lang=ko|en|ja]
GET /{lang}/news/{articleId}/markdown
```

### Parameters
| Parameter | Type   | Default | Description          |
|-----------|--------|---------|----------------------|
| articleId | string | —       | Article unique ID    |
| lang      | string | ko      | Language: ko, en, ja |

### Response
- Content-Type: `text/markdown; charset=utf-8`
- Cache: `public, s-maxage=3600, stale-while-revalidate=600`

### Example Request
```
curl https://vibetimes.co.kr/news/clxy123abc/markdown?lang=en
```

### Example Response
```markdown
---
title: "Article Title Here"
author: "VibeTimes"
published: "2026-04-23T09:00:00Z"
section: "technology"
tags: ["AI", "machine learning"]
language: "en"
url: "https://vibetimes.co.kr/en/news/clxy123abc"
---

# Article Title Here

Article body in clean Markdown format...
```

### Error Responses
- 404: Article not found — `{"error": "Article not found"}`
- 500: Server error — `{"error": "Internal server error"}`

## RSS Feeds

### Endpoints
```
GET /api/rss              — All articles (Korean)
GET /api/rss?section=tech — Filter by section
```

### Format
Standard RSS 2.0 XML with full article content in `<description>`.

## Sitemaps
- Main: https://vibetimes.co.kr/sitemap.xml
- News: https://vibetimes.co.kr/sitemap-news.xml
- Articles: https://vibetimes.co.kr/sitemaps/articles.xml
- Sections: https://vibetimes.co.kr/sitemaps/sections.xml

## Rate Limits
No strict rate limits for read-only access. Please be respectful and cache responses when possible.

## Contact
Website: https://vibetimes.co.kr