diff --git a/zeeguu/api/endpoints/article.py b/zeeguu/api/endpoints/article.py
index 954ff0e6..240964e5 100644
--- a/zeeguu/api/endpoints/article.py
+++ b/zeeguu/api/endpoints/article.py
@@ -14,6 +14,143 @@
import json
from zeeguu.logging import log
+import math
+import requests
+from io import BytesIO
+from markupsafe import escape
+from PIL import Image
+from zeeguu.config import ZEEGUU_DATA_FOLDER
+from zeeguu.core.audio_lessons import og_image
+
+# Production origins for shared-article link previews (mirrors audio lessons):
+# the share page lives on the web app; the card image is served by this API.
+SHARE_WEB_ORIGIN = "https://zeeguu.org"
+SHARE_API_ORIGIN = "https://api.zeeguu.org"
+
+
+def _article_card_view(article):
+ """The data the article OG card + text need, derived from article_info()."""
+ info = article.article_info()
+ metrics = info.get("metrics") or {}
+ word_count = metrics.get("word_count")
+ minutes = max(1, math.ceil(word_count / 200)) if word_count else None
+ lang_code = info.get("language")
+ language_name = (
+ Language.LANGUAGE_NAMES.get(lang_code, lang_code.upper()) if lang_code else None
+ )
+ source = article.feed.title if article.feed else (article.authors or None)
+ return {
+ "article_id": article.id,
+ "title": info.get("title"),
+ "language_name": language_name,
+ "cefr_level": metrics.get("cefr_level"),
+ "minutes": minutes,
+ "source": source,
+ "image_url": info.get("img_url"),
+ }
+
+
+def _article_preview_texts(view):
+ """(, <description>) for the article's OG tags."""
+ title = (view.get("title") or "Article").strip()
+ parts = [p for p in [
+ f"{view['language_name']} article" if view.get("language_name") else "Article",
+ view.get("cefr_level"),
+ f"{view['minutes']} min read" if view.get("minutes") else None,
+ view.get("source"),
+ ] if p]
+ return title, " · ".join(parts) + ". Read on Zeeguu."
+
+
+def _fetch_preview_image(url):
+ """Download the article's hero image for compositing; None on any failure."""
+ if not url:
+ return None
+ try:
+ resp = requests.get(url, timeout=6, headers={"User-Agent": "ZeeguuLinkPreview/1.0"})
+ resp.raise_for_status()
+ return Image.open(BytesIO(resp.content))
+ except Exception:
+ return None
+
+
+def _og_preview_html(og_title, description, page_url, image_url):
+ title = escape(og_title)
+ desc = escape(description)
+ return f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{title}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Opening this article on Zeeguu… Continue.
+
+