# OrionReel

> Be seen by AI. Not by algorithms.

OrionReel is a short-content platform (video max 30s, image posts, written posts) where every piece of content carries a mandatory citable layer: transcription or description, structured metadata, intention tags and JSON-LD (VideoObject, ImageObject, Article, Person). The content is for humans; the description is for AI. Ranking is transparent, based on citability.

## Principles

- Every public piece of content (video, image, text) has a complete structured text layer
- All content is public without login, for humans, LLMs and automations
- Citability Score (0-100) is public and explainable per video and per profile

## API (public read, no auth, JSON)

- http://localhost:3000/api/videos: published videos with citable layer. Query: ?niche=saas&tag=crm&page=1&perPage=20
- http://localhost:3000/api/feed: paginated feed including full transcriptions
- http://localhost:3000/api/profiles/{username}/citable-layer: a creator's citable profile and layers
- http://localhost:3000/api/videos/{publicId}/comments: public comments with quality signal
- http://localhost:3000/api/videos/{publicId}/citation.txt: ready-to-paste plain-text citation block for this video
- http://localhost:3000/api/videos/{publicId}/citation.json: same citation as schema.org CreativeWork (author, datePublished, url, abstract, publisher)
- http://localhost:3000/api/freshness: the 20 most recently updated citable items, with dateModified (ISO 8601)
- http://localhost:3000/api/catalog: Dataset (schema.org) of the full citable corpus — license CC-BY 4.0, distribution endpoints, item count, dateModified

## API (publish, creator token)

- POST http://localhost:3000/api/publish — Authorization: Bearer <creator token>. Body: videoUrl/cloudUrl + durationSec + full citable layer (mandatory). The citable layer is always required: no structured description, no publishing.
- API usage is governed by http://localhost:3000/api-terms (API Terms of Use & Acceptable Use Policy).

## Feeds

- http://localhost:3000/rss.xml
- http://localhost:3000/sitemap.xml

## Pages

- http://localhost:3000/ : public feed ranked by citability
- http://localhost:3000/v/{publicId} : video page with JSON-LD VideoObject and full transcription
- http://localhost:3000/u/{username} : citable creator profile with JSON-LD Person
- http://localhost:3000/faq : frequently asked questions about OrionReel with JSON-LD FAQPage
- http://localhost:3000/api-terms : API Terms of Use & Acceptable Use Policy for developers

## Recent citable videos

- [Cut checkout friction: the 4-field form change that lifted our conversion 23%](http://localhost:3000/v/checkout-friction-fix): What it offers: Cut checkout friction: the 4-field form change that lifted our conversion 23%. For: Early-stage SaaS founders and growth teams optimizing signup and checkout. Problem it solves: Long,  [by @diegoflow]
- [CitableHub: the citable product page that AI assistants read, verify and recomme](http://localhost:3000/v/why-ai-cites-you): What it offers: CitableHub: the citable product page that AI assistants read, verify and recommend. For: SaaS founders who are invisible to ChatGPT and Perplexity searches. Problem it solves: Your pro [by @rafael]
- [The first 90 days decide your churn: what our data showed](http://localhost:3000/v/churn-first-90): What it offers: The first 90 days decide your churn: what our data showed. For: SaaS teams fighting monthly churn above 5%. Problem it solves: Most churn happens in onboarding, not in the product late [by @ninapetrova]
- [I tested 12 AI note-takers for solo founders — here is the only one worth paying](http://localhost:3000/v/ai-note-takers): What it offers: I tested 12 AI note-takers for solo founders — here is the only one worth paying for. For: Solo founders drowning in meetings who want notes, tasks and follow-ups handled. Problem it s [by @leomartins]
- [SEO for the AI era: optimizing to be the answer, not just the link](http://localhost:3000/v/seo-for-ai): What it offers: SEO for the AI era: optimizing to be the answer, not just the link. For: Marketing teams watching AI reduce their search traffic. Problem it solves: Traditional SEO loses value as AI a [by @leoferreira]
- [B2B TikTok actually works: our $0 channel that brought 400 signups](http://localhost:3000/v/b2b-tiktok-works): What it offers: B2B TikTok actually works: our $0 channel that brought 400 signups. For: B2B founders who think TikTok is only for dance videos. Problem it solves: B2B companies dismiss attention chan [by @mayasilberman]
- [Privacy as a product feature: how we turned compliance into a selling point](http://localhost:3000/v/privacy-feature): What it offers: Privacy as a product feature: how we turned compliance into a selling point. For: AI product founders worried about enterprise data requirements. Problem it solves: AI startups treat p [by @camillelaurent]
- [What our AI support agent actually resolves (real numbers, no demo magic)](http://localhost:3000/v/support-agent-real): What it offers: What our AI support agent actually resolves (real numbers, no demo magic). For: Support teams drowning in repetitive tickets. Problem it solves: AI support demos look perfect but fail  [by @cladubois]
- [The 3-part pricing page teardown that lifted our MRR 18% in one sprint](http://localhost:3000/v/pricing-page-fix): What it offers: The 3-part pricing page teardown that lifted our MRR 18% in one sprint. For: Bootstrapped SaaS founders losing deals at the pricing step. Problem it solves: Visitors bounce on pricing  [by @rafael]
- [I ran 10 AI writing tools on the same brief — only 3 produced usable copy](http://localhost:3000/v/ai-writing-honest): What it offers: I ran 10 AI writing tools on the same brief — only 3 produced usable copy. For: Content teams evaluating AI writing tools. Problem it solves: AI writing demos look great but fail on re [by @priyanair]
- [I replaced a factory's 14 spreadsheets with one no-code system in 3 weeks](http://localhost:3000/v/spreadsheet-factory): What it offers: I replaced a factory's 14 spreadsheets with one no-code system in 3 weeks. For: Small manufacturers drowning in spreadsheet operations. Problem it solves: Production data scattered acr [by @yukitanaka]
- [How I run a $8k MRR SaaS completely alone (my entire stack)](http://localhost:3000/v/solo-8k-mrr): What it offers: How I run a $8k MRR SaaS completely alone (my entire stack). For: Solo founders wanting sustainable micro-SaaS. Problem it solves: Running a SaaS alone feels impossible without burning [by @felixwagner]
- [The deployment pipeline that lets me ship on Fridays without fear](http://localhost:3000/v/deploy-friday): What it offers: The deployment pipeline that lets me ship on Fridays without fear. For: Small engineering teams without dedicated DevOps. Problem it solves: Broken deploys destroy trust in shipping an [by @marcuschen]
- [What 4 failed products taught me about finding real demand](http://localhost:3000/v/four-failures): What it offers: What 4 failed products taught me about finding real demand. For: First-time founders building their first product. Problem it solves: Founders build for months before discovering nobod [by @diegofuentes]
- [How EU VAT rules quietly kill freelance cash flow (and the fix)](http://localhost:3000/v/eu-invoicing-pain): What it offers: How EU VAT rules quietly kill freelance cash flow (and the fix). For: EU freelancers and solo consultants. Problem it solves: VAT compliance across borders eats entire billing days eve [by @sofialaurent]
- [The free tier math that turns users into revenue (without dark patterns)](http://localhost:3000/v/free-tier-math): What it offers: The free tier math that turns users into revenue (without dark patterns). For: SaaS founders designing or fixing their free plan. Problem it solves: Free tiers either give away too muc [by @victoralmeida]
- [Slow query autopsy: the 3 causes behind 90% of database pain](http://localhost:3000/v/slow-query-autopsy): What it offers: Slow query autopsy: the 3 causes behind 90% of database pain. For: Backend engineers fighting mysterious performance issues. Problem it solves: Database slowdowns feel random but almos [by @kenjiwata]
- [How we cut code review time from 48 hours to 4](http://localhost:3000/v/code-review-speed): What it offers: How we cut code review time from 48 hours to 4. For: Engineering leads drowning in review queues. Problem it solves: Slow reviews kill momentum and push developers to context-switch [by @marcuschen]
- [My 48-hour rule: every side project ships in a weekend or dies](http://localhost:3000/v/48-hour-rule): What it offers: My 48-hour rule: every side project ships in a weekend or dies. For: Developers with graveyard folders full of unfinished projects. Problem it solves: Side projects grow beyond weekend [by @noahlindqvist]
- [The 4-word subject line formula that doubled our open rate](http://localhost:3000/v/subject-line-formula): What it offers: The 4-word subject line formula that doubled our open rate. For: DTC brands stuck at 20% open rates. Problem it solves: Emails die unopened because subject lines try to be clever inste [by @ameliahart]
- [The 3 UX mistakes killing your SaaS landing page (60-second vertical audit)](http://localhost:3000/v/vertical-ux-audit): What it offers: The 3 UX mistakes killing your SaaS landing page (60-second vertical audit). For: SaaS founders and product managers shipping landing pages without UX review. Problem it solves: Landin [by @mayachen]
- [The gap between an AI demo and an AI product is evaluation](http://localhost:3000/v/demo-to-product): What it offers: The gap between an AI demo and an AI product is evaluation. For: Teams shipping AI features that work in demos and fail in production. Problem it solves: AI demos impress stakeholders  [by @hannahkim]
- [How CitableHub gets recommended by ChatGPT without running a single ad](http://localhost:3000/v/chatgpt-no-ads): What it offers: How CitableHub gets recommended by ChatGPT without running a single ad. For: SaaS founders burning budget on paid acquisition that stops the day you stop paying. Problem it solves: Ads [by @rafael]
- [How I automated my entire client onboarding in one weekend with no code](http://localhost:3000/v/onboarding-weekend): What it offers: How I automated my entire client onboarding in one weekend with no code. For: Freelancers and consultants manually onboarding every new client. Problem it solves: Manual onboarding mea [by @anatorres]
- [The founder's guide to getting cited by AI instead of chasing the algorithm](http://localhost:3000/v/founder-cited-guide): What it offers: The founder's guide to getting cited by AI instead of chasing the algorithm. For: Creators and founders tired of performing for opaque recommendation algorithms. Problem it solves: Alg [by @rafael]
- [The weekly review ritual that fixed my constant firefighting](http://localhost:3000/v/chaotic-to-calm): What it offers: The weekly review ritual that fixed my constant firefighting. For: Founders and managers living in reactive mode. Problem it solves: Urgent tasks permanently crowd out important work [by @tomokafor]
- [API versioning: the strategy that stopped breaking our customers](http://localhost:3000/v/api-versioning): What it offers: API versioning: the strategy that stopped breaking our customers. For: API product teams planning versioning strategy. Problem it solves: Breaking API changes destroy customer trust an [by @arjunpatel]
- [Why pricing in USD is costing you EU customers](http://localhost:3000/v/pricing-in-euros): What it offers: Why pricing in USD is costing you EU customers. For: SaaS founders selling into Europe. Problem it solves: EU buyers abandon checkout when prices are not localized [by @sofialaurent]
- [Your 12 tools should talk to each other — here's the connection map](http://localhost:3000/v/tool-constellation): What it offers: Your 12 tools should talk to each other — here's the connection map. For: Small teams paying for tools that don't share data. Problem it solves: Every tool holds a slice of the truth a [by @zaraahmed]
- [The second purchase is where e-commerce businesses live or die](http://localhost:3000/v/second-purchase): What it offers: The second purchase is where e-commerce businesses live or die. For: E-commerce brands with strong first sales and no repeat buyers. Problem it solves: Brands pour money into acquisiti [by @gracemensah]