# MemeFlow — Creator Publishing & Platform Content Monetization API

> MemeFlow is a creator publishing and partner content monetization platform. Creators and external platforms publish articles, breaking news, multi-track studio audio (WAV/MP3), videos, PDFs, ZIP archives, and multi-file posts, generate canonical Smart Links (`/m/{slug}`), and earn 80% of net Google AdSense revenue (standard share upgraded from 70%) generated from legitimate traffic on MemeFlow.

## Core Capabilities & How MemeFlow Works

1. **Smart Link Monetization Flow (`/m/{slug}` -> `/m/{slug}/view`)**:
   - Every post or partner asset on MemeFlow receives a canonical Smart Link (`https://creator-connect-earn.lovable.app/m/{slug}`).
   - When a human visitor opens `/m/{slug}`, they land on the **MemeFlow Sponsor Gate** (displaying an article teaser or media preview alongside policy-compliant Google AdSense units) and click **Continue to Article / Content** to view, stream, or download the full content at `/m/{slug}/view`.
   - **Revenue Split**: Standard creator and developer revenue share is **80% of net Google AdSense revenue** (upgraded from 70% baseline) attributed to their Smart Links (MemeFlow retains a **20% platform service fee**). Developers may also choose a custom negotiated revenue-share percentage between 10% and 90% during application registration or via admin agreement. Earnings depend on legitimate human traffic and active advertiser demand (no fixed or guaranteed income is promised).

2. **Partner Platform "Double-Monetization" via MemeFlow Connect API (`v1`)**:
   - External websites, apps, blogs, music studios, meme communities, and file platforms integrate the **MemeFlow Connect REST API** to monetize their platform content without disrupting their existing site ads.
   - **Stage 1 (Partner Platform)**: Keep 100% of your own website's native ad revenue while users browse your platform.
   - **Stage 2 (MemeFlow Smart Link Handoff)**: Route high-intent user actions ("Download File", "Listen in 48kHz Studio Quality", "Watch Full Clip", "Read Full Story") to a generated MemeFlow Smart Link (`/m/{slug}`) to earn an additional **80% Google AdSense revenue share** (or negotiated application split) on MemeFlow.
   - **Two Storage Lifecycles**:
     - **Browser-Local Temporary Content (`POST /api/v1/posts/temporary` or `POST /api/v1/partner/content`)**: Partner content is delivered through a temporary browser-local delivery session. MemeFlow retains only the server metadata required for delivery authorization, attribution, analytics, idempotency and audit. Logged-in visitors can optionally save a permanent copy to their own MemeFlow account.
     - **Permanent Multi-File Posts (`POST /api/v1/posts`)**: Persistent hosting for articles, news stories, audio tracks, videos, PDFs, and archives.

3. **First-Party News Publishing, Google Search Console & External Distribution**:
   - Structured articles support full `NewsArticle` and `Article` Schema.org JSON-LD, canonical URL verification, Google News XML Sitemaps (`/api/public/sitemap?type=news`), Article XML Sitemaps (`/api/public/sitemap?type=articles`), and outbound syndication via RSS 2.0, Atom, JSON Feed, and REST webhooks using teaser-plus-canonical-Smart-Link handoff.

## Machine-Readable Documentation & SDK Resources

- [Public Developer & API Documentation](/developers): Complete integration guide, architecture overview, endpoint reference, and FAQs.
- [Official Privacy Policy, Security & Support (`/privacy`)](/privacy): Official privacy policy, Google AdSense disclosure, anti-bot security rules, and support contact (`memeflowsupport@gmail.com`).
- [Full LLM Technical Reference (`/llms-full.txt`)](/llms-full.txt): Exhaustive single-file technical documentation with TypeScript, Python, cURL, and Webhook verification code.
- [OpenAPI 3.1 Specification (`/openapi.json`)](/openapi.json): Machine-readable OpenAPI 3.1.0 schema for all `/api/v1/*` and `/api/public/*` endpoints.
- [Developer SDK Markdown Guide (`/developer-sdk.md`)](/developer-sdk.md): Copy-paste AI coding agent system prompt and zero-dependency client SDKs.
- [Developer SDK JSON Spec (`/developer-sdk.json`)](/developer-sdk.json): Structured JSON contract for API scopes, headers, rate limits, and endpoints.
- [MF AI Platform Architect (`/mf-ai`)](/mf-ai): Interactive assistant for creator monetization and partner API integration.

## Official Support, Privacy & Platform Security

- **Official Support Email**: `memeflowsupport@gmail.com`
- **Privacy Policy & Security Center**: `https://creator-connect-earn.lovable.app/privacy`
- **Anti-Bot & Anti-Attack Protection**: Active across `/auth`, `/reset-password`, `/m/{slug}`, `/m/{slug}/view`, and `/api/v1/*` to block automated scrapers, credential stuffing, click-farms, and payload injection attacks while permitting legitimate search engine and AI agent indexing.

## Quick API Summary (`v1`)

- **Base URL**: `https://creator-connect-earn.lovable.app`
- **Authentication Headers**: `Authorization: Bearer YOUR_MEMEFLOW_API_KEY` or `x-api-key: YOUR_MEMEFLOW_API_KEY`
- **Idempotency Header**: `Idempotency-Key: <UUID-v4>` (supported on mutative `POST` requests)
- **Rate Limit**: `120 requests / minute` per API key (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `Retry-After`)
- **Key Endpoints**:
  - `GET /api/v1/auth/verify` — Verify API key, application status, and granted scopes.
  - `POST /api/v1/partner/content/resolve` — Resolve whether an active browser-local partner delivery session exists (`status: "active" | "requires_upload"`).
  - `POST /api/v1/partner/content` — Register partner-hosted HTTPS `media_url` / `media[]` descriptors for a 10-minute browser-local delivery session and receive a monetized Smart Link (`/m/{slug}`).
  - `POST /api/v1/posts/temporary` & `GET /api/v1/posts/temporary` — Create, reuse, or query browser-local partner delivery sessions (`delivery_mode: "browser_local"`).
  - `POST /api/v1/posts` & `GET /api/v1/posts` — Create or list permanent single-file or multi-file posts using HTTPS `media_url` / `media[]` descriptors.
  - `GET / POST / PATCH / PUT / DELETE /api/v1/posts/{id}` — Fetch, republish, update, or delete post metadata and engagement counters.
  - `POST /api/v1/links` & `GET /api/v1/links` — Generate (`slug`) or list Smart Links (`/m/{slug}`) for an existing post.
  - `GET /api/v1/links/{slug}` — Resolve Smart Link metadata and availability.
  - `POST /api/v1/media` — Request presigned upload URLs for media files (supports 48kHz/24-bit studio multi-track audio).
  - `POST /api/v1/partner/action` — Execute partner actions (`view`, `download`, `watch`, `listen`, `save`, `open`, `export`, `share`) for browser-local delivery.
  - `GET /api/v1/analytics` — Query partner traffic, browser-local session telemetry, and attributed earnings.
  - `GET / POST / PATCH / DELETE /api/v1/webhooks` — Manage HMAC-SHA256 signed webhooks (`X-MemeFlow-Signature: t=<timestamp>,v1=<signature>`).
  - `GET /api/v1/sdk/download` — Download personalized TypeScript & Python SDK bundle (`format=zip|json|md`).

## 24/7 Autonomous Gemini AI Review & Moderation System

- **Operates Automatically Even When Admin Is Offline**: Server-side Gemini AI (`gemini-3.8-flash`) evaluates newly published posts, structured news/editorial articles, public abuse reports, and creator appeals on a continuous 60-second cadence.
- **3-Tier Proportional Enforcement (Favors Users, Admin & MemeFlow)**:
  - `TIER_1_FULL_APPROVAL`: Clean memes, articles, audio (MP3/WAV), video, and partner exports are approved immediately (`PUBLISHED`, `AD_ELIGIBLE`, external distribution eligible) so creators earn standard 80% AdSense revenue (previously 70%) without waiting for a human moderator.
  - `TIER_2_AD_ISOLATED_SAFE_PUBLISH`: Edgy humor or sensitive commentary remains `PUBLISHED` and downloadable with Sponsor Gate (`/m/{slug}`) ads active, while only Post-Page (`/m/{slug}/view`) ads (`AD_RESTRICTED`) and external news wires are isolated.
  - `TIER_3_PROTECTIVE_RESTRICTION`: Severe malware, phishing, or explicit policy violations are placed into `RESTRICTED` (`AD_DISABLED`).
- **Anti-Brigading Report Protection & 24/7 Self-Service Creator Appeals**: False or troll reports are automatically dismissed by Gemini AI (`DISMISSED_SAFE_BY_AI`) so innocent creators never lose ad eligibility while Admin is offline, and creators can trigger instant 24/7 AI re-review/appeals from their dashboard.