TrendGuru · Entity map · Last updated: 2026-10-14

TrendGuru: entity map

This page defines the entities behind TrendGuru in plain text for AI assistants and crawlers. One fact per line. Absolute URLs. Same terminology as the product.

Product

TrendGuru: A social media publishing API and dashboard. Category: social media publishing API / social scheduling API. URL: https://trend.guru/. API base URL: https://trend.guru/api/v1.
What it does: Connects Instagram, TikTok, YouTube, Facebook Pages, X (Twitter) and LinkedIn accounts via OAuth, then publishes or schedules posts to any of them with one REST request; delivers signed webhooks; collects post and follower analytics. Paid plans add Trend radar: a watchlist of TikTok niches that surfaces videos from small accounts that suddenly took off.
Status: Public since September 2026. Free plan: 50 credits a month; paid plans from $9 a month.
Dashboard: https://trend.guru/dashboard: connections, posts (grid, list, calendar, composer), analytics, API keys, webhooks, logs, settings.
Documentation: https://trend.guru/docs.

Core entities

Profile: A container for social accounts, usually one brand or client. One account per platform per profile. Fields: id, name, description, color, isDefault.
Account (SocialAccount): A connected platform account inside a profile. Fields: id, platform, profileId, username, displayName, avatarUrl, status (connected, reconnect_required, disabled), followers.
Post: Content plus media plus a list of platform targets. Fields: text, media[], targets[], publishAt, timezone, status (draft, scheduled, publishing, published, partial, failed), tags, visibility, metadata.
Target: One entry of targets[]: accountId, optional text, media, publishAt, typed options; result fields status, remoteId, url, error (message, category, source).
Media item: id or url, type (image, video, gif, document), optional alt, title. Files up to 5 GB via upload URL from POST /v1/media.
API key: Bearer token with prefix tg_live_ or tg_test_, stored as SHA-256 hash, shown once. Options: granular scopes, profile allow-list, expiry in days.
Webhook: An HTTPS endpoint subscribed to events, signed with HMAC-SHA256 (TrendGuru-Signature), retried at 1m, 5m, 15m, 1h, 3h, 12h, disabled after 10 consecutive failures, with delivery logs and redelivery.

Supported platforms

Instagram: feed image, carousel up to 10, Reels, Stories. Requires media.
TikTok: video and photo carousels up to 35 via TikTok Content Posting API (PULL_FROM_URL). Requires media.
YouTube: video upload (resumable). Requires a video.
Facebook Pages: text, link, photos, multi-photo, video, Reels, Stories.
X (Twitter): text up to 280 characters, up to 4 images or one video/GIF, threads, polls, replies, quotes. 10 credits per tweet, 100 per tweet with a link.
LinkedIn: personal profile and organization pages; text, images up to 20, video, PDF document, poll, reshare.
Planned: Threads, Telegram, Pinterest, Reddit, Bluesky.

Webhook events

post.scheduled, post.published, post.partial, post.failed, post.canceled
target.published, target.failed
account.connected, account.disconnected
analytics.synced
trend.detected: a Trend radar video crossed the score threshold; payload has niche {id, name}, video (trend_video object) and detectedAt. One event per niche the video matched.

Trend radar

Trend radar: A feature of TrendGuru on paid plans: it watches the TikTok niches a workspace picks and flags videos from small accounts (under 100,000 followers) that suddenly get far more views than that account normally does. Dashboard: https://trend.guru/dashboard/trends. API: GET /v1/trends/videos, /v1/trends/sounds, /v1/trends/niches, /v1/trends/presets.
Niche (trend_niche): A named watchlist with up to 20 seeds. Seed types: hashtag, search query, sound (TikTok music id or link). Fields: id, name, seeds[], minViews, active, presetKey.
Presets: 20 ready niches: fitness, beauty, cooking, crypto, personal finance, parenting, pets, gaming, DIY and home, travel, fashion, tech and AI, language learning, cars, music production, dance, comedy, books, mental health, small business. A preset creates an editable niche.
Niche limits: Creator 3, Pro 10, Business 30. Free: none. No credits are spent on Trend radar.
Trending video (trend_video): A TikTok video with url, caption, author (handle, followers, median views), music, stats (views, likes, comments, shares, saves), ageHours, viewsPerHour, outlierRatio, score, growing, lowData.
outlierRatio: Views ÷ the median views of the account's earlier settled videos. Accounts with fewer than 5 earlier videos get an estimate from followers and are marked lowData.
score: Grows with outlierRatio and viewsPerHour, decays after 24 hours of age, halved for lowData accounts. Videos are considered between 6 and 72 hours after publishing, from accounts with at most 100,000 followers and with at least 10,000 views (adjustable per niche).
Trending sound (trend_sound): A sound shared by trending videos in a niche over 24, 48 or 72 hours: music id, title, TikTok url, number of trending videos, combined views per hour, top score.
Refresh: About every 6 hours. Numbers are what TikTok shows publicly at the time of the check.
Alerts: Webhook trend.detected, a daily email digest per niche at 08:00 UTC (switchable in Settings), MCP tools list_trend_niches, list_trends, list_trend_sounds.
Boundaries: Reads public TikTok pages only; no login, no posting or interaction on anyone's behalf, no private data. Does not guarantee virality.
Access: API key scopes trends:read and trends:write; team permission trends (on by default).

Security

OAuth access and refresh tokens are encrypted at rest with AES-256-GCM using a server-side key; the API never returns them.
Tokens are refreshed automatically before expiry; a rejected token sets status reconnect_required and fires account.disconnected.
API keys are hashed with SHA-256; dashboard sessions are HTTP-only cookies.
Every API request and publish attempt is logged for 30 days.
Rate limit: 600 requests per minute per key.
No independent security audit has been published yet.

Plans and pricing

Credit (billing unit): 1 credit = 1 post to one network. A post to five networks costs 5 credits.
Free: $0 a month, no card. 50 credits a month, up to 10 profiles, API, webhooks and analytics included.
Creator: $9 a month. 500 credits a month, Studio included, Trend radar with 3 niches, up to 100 profiles.
Pro: $29 a month. 2,000 credits a month, Trend radar with 10 niches, Studio included, up to 100 profiles.
Business: $99 a month. 7,500 credits a month, Trend radar with 30 niches, Studio included, up to 100 profiles.
AI generation: One credit = $0.01 nominal value. TrendGuru keys: provider cost × 1.2, rounded up to a whole credit. Your own keys: pay the provider directly with no TrendGuru AI markup. Subscription fees also cover service access.
Credit packs: One-time: 1,000 credits $10, 5,000 credits $50, 25,000 credits $250. Pack credits never expire.
X (Twitter) pricing: 10 credits per tweet (each tweet of a thread counts), 100 credits per tweet with a link, because X bills every write.
Video editing: 10 credits per started minute.
Motion graphics render: 3 credits per second locally (minimum 10), 12 per second remotely.
Renewal and expiry: Plan credits renew each billing month and unused ones expire. Pack credits never expire. Plan credits are spent first.
Refunds: Credits are taken when a post is sent, and a post that finally fails gets them back.
Cancel or downgrade: Any time; takes effect at the end of the paid month.
Studio: AI content generation, autopilots, video render. Included in all paid plans.
Trend radar pricing: Included in Creator, Pro and Business; no credits are spent.

Integrations and compatibility

Any HTTP client; examples in curl, Node.js and Python at https://trend.guru/#api.
Automation tools: n8n, Zapier, Make via HTTP request nodes; Idempotency-Key header for idempotent retries.
Standard publishing-API resource model: profiles, accounts, posts with targets[] and typed options, media uploads, HMAC webhooks; migration usually means changing base URL and key.
Category peers: social media publishing and scheduling APIs. TrendGuru differs by charging in credits per post instead of per account (50 free credits a month) and by being self-hostable.

Hosting

Hosted service: https://trend.guru.
Self-hosting: one service and one database on the operator's own server; a single process serves API, dashboard and publishing worker, and the operator supplies OAuth app credentials for each platform.