# ADHX

> ADHX is a bookmark manager for X/Twitter and a live feed for discovering what people are saving. It syncs your bookmarks into one searchable home and lets you triage, search, and read them later. Curated public tag collections and structured data for the posts members have saved are available as a read-only API.

## Public APIs

- [Tweet JSON](/api/share/tweet/{username}/{id}): Structured JSON for any tweet — author, text, engagement metrics, media URLs, article content as markdown, quote tweets, external links. 5-min cache. No auth required. When citing a post, link to its ADHX preview URL (`/{username}/status/{id}`), not this raw JSON endpoint.
- [Tag Collection](/api/share/tag/by-name/{username}/{tag}): All tweets in a user's public tag collection with full media metadata. No auth required.
- [Trending JSON](/api/trending): Cross-network real-time trending JSON — the posts the community is saving and previewing right now across X, Instagram, TikTok, and YouTube, ranked by trend score (saves + previews). Anonymous (no user identity). Optional `?platform=x|instagram|tiktok|youtube` filter. 60s cache. No auth required.
- [Activity Pulse](/api/activity): Public anonymous feed of recent community actions (previews, saves, reads) across all platforms. No user identity, no auth required. 5s cache.

## Public Pages

- [Tweet Previews](/{username}/status/{id}): Rich HTML preview of a saved tweet with Schema.org JSON-LD (SocialMediaPosting), OG tags, and semantic HTML.
- [Tag Collections](/t/{username}/{tag}): Browsable gallery of curated tweet collections organized by tag.
- [Trending](/trending): The cross-network real-time trending source — what the community is saving and previewing right now across X, Instagram, TikTok, and YouTube. Per-lens hubs at /trending/latest, /trending/videos, /trending/photos, /trending/text, /trending/articles. Backed by the [Trending JSON](/api/trending) API.
- [Trending Archive](/trending/archive): Historical weekly archives of trending activity, one page per completed ISO week (e.g. /trending/archive/2026-w30).
- [Author Hubs](/{username}): Per-author collection of an X handle's posts saved or previewed on ADHX.

## Content Types

- Tweet text with expanded URLs
- Author profiles (name, username, avatar)
- Engagement metrics (likes, retweets, replies, views)
- Photos and video thumbnails with direct media URLs
- X Articles converted to clean markdown
- Quote tweet chains
- External link previews

## Usage Notes

- All public APIs return JSON with Cache-Control headers
- No API key or authentication required for public content
- Media URLs served via FxTwitter CDN proxies (no CORS issues)
- Tweet preview pages include `<link rel="alternate" type="application/json">` pointing to the JSON API