TrendGuru FAQ

TrendGuru is a social media publishing API and dashboard. You connect Instagram, TikTok, YouTube, Facebook Pages, X and LinkedIn accounts once, then publish or schedule posts to any of them with a single REST request. Webhooks report results and analytics collect engagement and follower data.

Instagram, TikTok, YouTube, Facebook Pages, X (Twitter) and LinkedIn. Threads, Telegram, Pinterest, Reddit and Bluesky are planned for the next wave.

TrendGuru has four monthly plans: Free $0 with 50 credits, Creator $9 with 500 credits, Pro $29 with 2,000 credits and Business $99 with 7,500 credits; all paid plans include Studio. Extra credits come in one-time packs: 1,000 for $10, 5,000 for $50 and 25,000 for $250. 1 credit is 1 post to one network.

One credit has a nominal value of $0.01. AI on TrendGuru keys costs provider cost × 1.2, rounded up to a whole credit; your own keys are billed by your provider with no TrendGuru AI markup. A post sent to one network costs 1 credit, so five networks cost 5 credits. A tweet on X costs 10 credits, 100 if it contains a link, and each tweet of a thread counts separately. A Simple video editing costs 10 credits per started minute; motion graphics render costs 3 credits per second locally of output.

Credit packs are one-time purchases on top of any plan: 1,000 credits for $10, 5,000 for $50 and 25,000 for $250, paid by card through Stripe. Pack credits never expire. Plan credits are always spent first, then pack credits.

Plan credits do not roll over: they renew at the start of each billing month and whatever is left of the previous month expires. Pack credits never expire and stay until you use them.

Yes, any time. An upgrade applies immediately and adds the difference in credits. A cancellation or downgrade takes effect at the end of the paid month, so you keep the current plan until then.

No. Credits are taken when a post is sent, and if it finally fails they go back to your balance.

Up to 10 profiles on the Free plan and up to 100 on any paid plan or while you have pack credits. A profile holds one account per platform.

Studio is AI content generation, autopilots that prepare and publish content on a schedule, and video rendering. It is included in every paid plan, starting with Creator ($9 a month); simple video editing costs 10 credits per started minute, and local motion graphics rendering costs 3 credits per second.

Yes, the Free plan has no time limit and needs no card. It gives 50 credits a month (1 credit is 1 post to one network), up to 10 profiles, and includes the API, webhooks and analytics. For more, pick a paid plan or buy a credit pack.

Yes. Profiles hold accounts, a post carries text, media and targets with typed per-platform options, media is uploaded through an upload URL and results arrive by HMAC-signed webhooks. Most integrations move in an afternoon; the docs list every endpoint and option.

Same job: connect accounts, post and schedule, get results by webhook, read analytics. TrendGuru differs by charging in credits per post instead of per connected account, with 50 free credits a month, by being self-hostable and by focusing on publishing rather than inbox features.

Send POST /v1/posts with a Bearer API key, the content, optional mediaItems (public URLs) and a targets array of accountId entries. Set publishAt to "now" or an ISO 8601 time. The response contains the post with per-target status and url.

Set publishAt to an ISO 8601 timestamp and optionally timezone. The post gets status scheduled; the worker publishes it at that time and fires post.published or post.failed.

Yes. Each entry in targets can carry its own text and media. The main text and media are used when they are absent.

Per-target options validated per platform: Instagram kind and first comment, TikTok privacy and duet toggles, YouTube title and visibility, Facebook reel or story, X reply settings and threads, LinkedIn organization and document title. The full list is in the docs.

Use a public URL directly, or call POST /v1/media to get an upload URL and PUT the file to it (up to 5 GB), then reference the returned publicUrl. TrendGuru pulls the file into each platform's own upload flow.

Yes. YouTube uploads use the resumable API, TikTok uses PULL_FROM_URL, Instagram Reels and Facebook Reels use container and upload sessions, X and LinkedIn use chunked uploads.

Yes on Instagram (up to 10 items), TikTok photo posts (up to 35), Facebook multi-photo posts, LinkedIn multi-image posts and X (up to 4 images).

Yes on Instagram and Facebook Pages via options.kind = story.

The target is marked failed with error.message, error.category and error.source. Transient errors retry automatically up to three times. The post ends as failed or partial and webhooks post.failed or post.partial fire. You can retry with POST /v1/posts/{id}/retry.

A post that published on some targets and failed on others. Each platform target keeps its own status, id and error.

Create a webhook with a URL and a list of events. TrendGuru POSTs a JSON event with headers TrendGuru-Event, TrendGuru-Event-Id, TrendGuru-Timestamp and TrendGuru-Signature (t=…,v1=HMAC-SHA256 of "t.body" with your secret). Failed deliveries retry at 1 minute, 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours. Ten consecutive failures disable the endpoint.

post.scheduled, post.published, post.partial, post.failed, post.canceled, target.published, target.failed, account.connected, account.disconnected and analytics.synced; wildcards post.* and * are accepted.

OAuth access and refresh tokens are encrypted at rest with AES-256-GCM using a server-side key and are never returned by the API. Tokens are refreshed automatically before they expire.

As SHA-256 hashes. The full key is shown once when created. Keys can be read-only, scoped to specific profiles and given an expiry.

No independent security audit has been published yet. Tokens are encrypted at rest, API keys are stored as hashes and every request is logged.

TrendGuru publishes only to accounts their owners connected through the platforms' official OAuth flows and official APIs. It does not scrape, automate browsers or use unofficial endpoints for publishing.

Not on trend.guru; the hosted service uses TrendGuru's apps. If you self-host you register your own OAuth apps and add the credentials to the server environment. The Settings page shows which platforms are ready.

X bills every write to its API, so a tweet costs more than a post to other networks: 10 credits per tweet, including every tweet of a thread, and 100 credits per tweet that contains a link.

Yes. Each profile holds one account per platform, so create one profile per Instagram account (or per brand) and connect each account into its own profile.

A profile is a container for accounts, usually one brand or client. Posts target accounts inside profiles. API keys can be scoped to profiles.

Ask for the Facebook connect URL, authorize, then pick the Page from the list TrendGuru returns. The Page's own token is stored, so posting keeps working when the user token expires.

Either through Instagram Login (business or creator account, default) or through Facebook Login when the Instagram account is linked to a Facebook Page. Both are official Meta flows.

Yes. Likes, comments, shares, saves, views, impressions and reach per published post are synced hourly for 14 days after publishing; follower counts per account are refreshed daily; daily aggregates and per-post timelines are available through the API and dashboard.

Not yet. TrendGuru covers publishing, scheduling, webhooks and analytics. Comments and messaging are on the roadmap.

No. TrendGuru is for organic publishing.

Yes. The API is plain JSON with a Bearer key, an Idempotency-Key header for idempotent retries, a validation endpoint and machine-readable error codes. An MCP server is planned.

Yes, through their HTTP request nodes. Send a fresh Idempotency-Key per logical post so retries never create duplicates.

Identical content to the same account within 24 hours returns HTTP 409 DUPLICATE_CONTENT with the existing post id. Change the text, media or account to post again intentionally.

600 requests per minute per API key by default, reported in RateLimit-* headers. Posting volume itself is not limited by TrendGuru; platform-side limits still apply.

Yes. It ships as one service plus a database that you run on your own server. One process serves the API, the dashboard and the publishing worker; the worker can also run separately. You supply your own OAuth app credentials.

TrendGuru is built by the team behind trend.guru, which also runs its own content and publishing pipelines on the platform. Contact through the dashboard.

On TrendGuru's own servers in the European Union for the hosted service, or on your servers when self-hosted.

POST /v1/posts/{id}/unpublish deletes it on platforms that allow deletion through their API (YouTube, X, LinkedIn, Facebook). Instagram and TikTok do not allow deletion through their APIs.

API request logs and publishing logs are kept for 30 days. Webhook delivery logs are kept with the webhook.

Trend radar is a TrendGuru feature on paid plans that watches the TikTok niches you pick and flags videos from small accounts (under 100,000 followers) that suddenly get far more views than that account normally does. It ranks them, shows the author, speed, outlier ratio and sound, and lists the sounds behind them.

Creator ($9 a month) gets 3 niches, Pro ($29) 10 and Business ($99) 30. The Free plan does not include it. Trend radar spends no credits.

A niche is a name plus up to 20 seeds. Seeds are hashtags, TikTok search queries or sounds (a TikTok music id or link). You can start from one of 20 presets, such as fitness, beauty, cooking, crypto, pets, gaming or small business, and edit the seeds later.

It compares the video's views with the median views of the account's earlier videos (the outlier ratio) and with how fast the video gains views per hour, and lets the score decay after 24 hours of age. Only videos between 6 and 72 hours old from accounts with at most 100,000 followers and at least 10,000 views are considered. Accounts with fewer than 5 earlier videos get an estimate and are marked lowData.

About every 6 hours. The numbers are what TikTok showed publicly at the time of the check, not a live counter. A new niche shows results after the first pass.

No. It reads public TikTok pages only. It does not log in, does not post, like, follow or comment on anyone's behalf and stores no private data.

Yes. Subscribe a webhook to trend.detected to get an event when a video first crosses the score threshold in one of your niches, turn on the daily email digest (08:00 UTC, top videos per niche), or ask an AI assistant through the MCP tools list_trend_niches, list_trends and list_trend_sounds.

No. It shows where attention is moving right now so you can act hours before large accounts repeat a format. Whether your version works depends on your content.

TikTok today. Publishing and analytics cover Instagram, TikTok, YouTube, Facebook Pages, X and LinkedIn.