TrendGuru · Entity map · Last updated: 2026-09-05

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.
Status: Public beta since September 2026. Free during beta.
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. Uses the customer's X developer app; X API pricing applies.
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

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

Public beta: $0. Unlimited profiles, accounts, posts, webhooks, analytics. No card.
Future paid plans: Per connected account; announced in the dashboard before they start. Not yet defined.

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 being free during beta and 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.