TrendSuite API
Build on the same content engine that powers the TrendSuite dashboard. Programmatic access to trends, content plans, brand profiles, and publishing — designed for teams that have outgrown manual workflows.
What you can build
Trend monitoring dashboards
Pull live trend signals for any niche into your own BI tool, internal dashboard, or Slack digest. Filter by platform, lifecycle stage, and relevance score. Subscribe to webhooks that fire when a trend crosses an Emerging → Rising threshold.
Custom content workflows
Integrate TrendSuite's content-generation engine into your existing production pipeline. Trigger plan generation from your CMS, route drafts to an approval step in Notion or Linear, and push final posts back to TrendSuite for scheduling.
Multi-brand publishing pipelines
Agency customers can manage content across every client brand through a single API key scoped to their workspace. Automate the repetitive parts of brand-switching and cross-platform scheduling without touching the UI.
Authentication
The TrendSuite API uses two authentication mechanisms depending on the integration pattern. Server-to-server integrations use long-lived API keys scoped to a specific workspace — generated and rotatable from your dashboard at any time without service interruption. User-delegated integrations, where your application acts on behalf of a TrendSuite user, use standard OAuth 2.0 authorization code flow with PKCE.
All API requests require HTTPS. Keys are never logged in server-side telemetry. Key rotation invalidates the old key immediately; there is no grace period, so rotation should be done atomically in your deployment pipeline.
Available endpoints (planned)
Trends
- List trends with filters: platform, niche, lifecycle stage, date range.
- Get a single trend by ID, including full signal breakdown and relevance score.
- Get trending topics for a specific brand profile.
- Subscribe to trend alerts via webhook.
- Mark a trend as actioned or dismissed.
Content plans
- Create a content plan from a trend ID and brand profile.
- List all plans: filter by status, platform, date range.
- Get a single plan including all platform variants and draft copy.
- Update plan status: draft, approved, scheduled, published.
- Regenerate individual platform variants within an existing plan.
Brands
- List all brand profiles in the authenticated workspace.
- Get full brand profile including niche, audience, tone, and content pillars.
- Update brand profile fields programmatically.
- Get brand completeness score.
Posts
- List posts: filter by platform, status, scheduled date.
- Schedule a post to one or more connected social accounts.
- Cancel or reschedule a scheduled post.
- Get post performance analytics (after publish).
Analytics
- Get aggregate publishing performance by platform and date range.
- Get trend-to-performance correlation: which trend types convert best for your brand.
- Export analytics as JSON or CSV.
Rate limits & pricing
API access is included with Pro and Agency plans at no additional cost. Free plan accounts receive read-only access with restricted rate limits. Specific rate-limit values (requests per minute, daily quotas) are being finalised and will be published before the public beta launches. Agency plans receive higher limits by default; custom limits are available for high-volume use cases — contact sales@trendsuite.ai to discuss.
SDKs
TypeScript / Node.js
First-party SDK with full type coverage matching the OpenAPI spec. Install via npm. Works in Node.js, Deno, and edge runtimes.
Python
First-party Python SDK with async support and Pydantic models for response validation. Install via pip.
OpenAPI specification
The full OpenAPI 3.1 spec will be published at GA. Generate a client in any language using tools like openapi-generator or Speakeasy.
Frequently asked questions
- When can I get access?
- We are targeting a public beta in Q3 2026. A private alpha is already running with a small group of Agency-tier customers. To apply for private alpha access, email api@trendsuite.ai with a description of what you want to build.
- Will the API be REST or GraphQL?
- REST, with JSON responses following consistent conventions (pagination cursors, typed error objects, ISO 8601 dates). A GraphQL layer is on the long-term roadmap but not in scope for the initial release.
- Is there a sandbox?
- Yes — every account will have a sandbox workspace where API calls operate against seeded, non-live data. Sandbox requests do not consume rate-limit quota and do not trigger real social-platform publishing.
- Will there be webhooks?
- Yes. Webhook support is planned for the initial release, covering trend-threshold events, content-plan status changes, and post publish confirmations. Delivery includes retry logic with exponential backoff and a delivery log in the dashboard.
- What authentication model will the API use?
- API keys scoped to a workspace for server-to-server integrations, and OAuth 2.0 for delegated access on behalf of a user. Keys will be rotatable from the dashboard without service interruption.
- Will the API be included in my existing plan?
- API access is included with Pro and Agency tiers. Free plan accounts will have read-only access with strict rate limits. Specific rate-limit numbers are still being determined and will be published before the beta launches.