TrendsAGI API Docs

Complete API reference for trends, automations, and integrations. Connect Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads, Snapchat Ads, and Pinterest Ads, Shopify, Reddit Ads, BigQuery, Google Sheets, n8n, Slack, and webhooks with a mix of one-click OAuth and direct REST workflows.

Base URL: https://api.trendsagi.com

Manage API Keys Generate and rotate keys in the dashboard.
Python SDK

Best for backend jobs, orchestration workers, and data pipelines.

pip install trendsagi
JavaScript / TypeScript REST

Best default path for JavaScript and TypeScript services, jobs, and web apps.

No TrendsAGI package required

Quick Start

Install command

bash
# No TrendsAGI package required
# Use native fetch in Node.js 18+ or modern browsers

API usage

typescript
const API_BASE_URL = process.env.API_BASE_URL ?? "https://api.trendsagi.com";
const API_KEY = process.env.TRENDSAGI_API_KEY;
if (!API_KEY) throw new Error("Set TRENDSAGI_API_KEY first");

async function main() {
  const response = await fetch(`${API_BASE_URL}/api/trends?category=Technology&limit=5`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  if (!response.ok) throw new Error(`Request failed: ${response.status}`);

  const trends = await response.json();
  console.log((trends.trends ?? []).map((item) => item.name));
}

main().catch(console.error);

Run command

bash
# Save as quickstart.mjs
node quickstart.mjs

Integration Checklist

Follow this order for the fastest path from first call to production-ready automation.

Step 1

Generate API key

Create and store `TRENDSAGI_API_KEY` in your runtime secrets.

Open API key manager

Step 2

Choose integration path

Use one-click setup for speed, or advanced custom setup for execution in your own stack.

Step 3

Run first signal pull

Validate connectors with `GET /api/integrations/ads/providers`.

Step 4

Enable category-driven automation

Save a trend category with safety guardrails, then run preview/apply.

Integrations
16

Python SDK, REST patterns, frameworks, social/search, and automation connectors.

Reference Endpoints
112

Grouped by domain with request/response schema details.

Ads Integrations
2

One-click and advanced setup paths for Google, Meta, TikTok, and LinkedIn workflows.

Social/Search
4

Playbooks for social listening, content ops, and search workflows.