Skip to main content
    API reference

    The TrendsIQ API.

    A public, stable REST API is on the roadmap. Until then, here are the internal endpoints the TrendsIQ web app calls — for transparency, not for production integration.

    Public API: coming soon

    The public, customer-facing https://api.trendsiq.io/v1/* endpoints are still in design — we're stabilising the data model before promising a contract. The list below is the real internal API surface that powers the TrendsIQ web app today. Auth is cookie-based; endpoints require an active user session and (where indicated) a connected BYOK key.

    Track API progress on the roadmap

    Auth

    POST
    /api/auth/signup

    Create a TrendsIQ account.

    POST
    /api/auth/login

    Email/password login → returns access cookie.

    POST
    /api/auth/forgot-password

    Trigger a Resend-sent password-reset email.

    GET
    /api/auth/me

    Return the current authed user.

    Integrations

    GET
    /api/integrations

    List the user's connected BYOK keys with live quota.

    POST
    /api/integrations

    Add or update a BYOK key (YouTube / SerpApi / Supadata / Gemini).

    DELETE
    /api/integrations/{id}

    Revoke a connected key. Deletion is immediate and permanent.

    GET
    /api/integrations/status

    Per-provider connection + live quota snapshot (5-min TTL).

    YouTube Data

    GET
    /api/youtube/trending

    Discover pipeline — 3-stage candidate pool, guaranteed ≥20 results for common combos.

    GET
    /api/youtube/search

    Free-text YouTube search via your BYOK key.

    GET
    /api/youtube/channel

    Channel deep-look — videos, stats, sub count.

    GET
    /api/youtube/categories

    Region-aware list of YouTube video categories.

    AI

    POST
    /api/ai/titles

    Generate title variants with predicted CTR + clarity.

    POST
    /api/ai/hooks

    Generate 8 hook patterns with predicted retention.

    POST
    /api/ai/script

    Long-form script generation — streams as NDJSON to bypass edge timeouts.

    POST
    /api/ai/deep-dive

    Reverse-engineer a topic: angles, hooks, comment intents, supporting videos.

    POST
    /api/ai/thumbnails

    Layout-aware thumbnail concept briefs.

    POST
    /api/ai/thumbnail

    Image generation via Gemini 2.5 Flash Image Preview (Nano Banana).

    POST
    /api/ai/channel-research

    Reverse-engineer a competitor channel via grounded analysis.

    POST
    /api/ai/gaps

    Find under-served sub-topics in a niche.

    POST
    /api/ai/calendar

    30-day content calendar tailored to your niche + voice.

    Dashboard

    GET
    /api/dashboard/hot-opportunities

    Snapshot of your trending YouTube breakouts (cron-refreshed every 6h).

    Library

    GET
    /api/saved

    List items saved to your library.

    POST
    /api/saved

    Save an item (trend / hook / title / thumbnail) to your library.

    Pipeline

    GET
    /api/pipeline

    List your 4-stage video-production kanban items.

    Public

    GET
    /api/trend-reports

    Weekly auto-generated niche trend reports.

    Want early access when the public API ships? Let us know.