Trends

List Trend Topics

GET /api/v1/trends/topics/

Auth: None.

Returns active trend topics, ordered by name.

Query parameters:

Response fields include: id, name, slug, keywords, keyword_list, topic_type, description, category, is_active, created_at, and updated_at.

Get Trend Topic

GET /api/v1/trends/topics/<slug>/

Auth: API key or logged-in browser session required.

Returns one active trend topic by slug.

Trends Summary

GET /api/v1/trends/summary/

Auth: API key or logged-in browser session required.

Returns high-level trend statistics.

Query parameters:

Response:

{
  "trending_up": 5,
  "trending_down": 3,
  "emerging_count": 2,
  "total_mentions": 1500,
  "companies_count": 45
}

Trends Data

GET /api/v1/trends/data/

Auth: API key or logged-in browser session required.

Returns summary, per-topic weekly trend data, and emerging topics.

Query parameters:

Response:

{
  "summary": {
    "trending_up": 5,
    "trending_down": 3,
    "emerging_count": 2,
    "total_mentions": 1500,
    "companies_count": 45
  },
  "topics": [
    {
      "name": "Serverless",
      "slug": "serverless",
      "category": "infrastructure",
      "keywords": ["serverless", "lambda"],
      "latest_mention_count": 42,
      "latest_post_count": 18,
      "weekly_data": [
        {
          "week_start": "2026-05-18",
          "mention_count": 42,
          "post_count": 18,
          "company_count": 12,
          "wow_change": 0.24
        }
      ]
    }
  ],
  "emerging": [
    {
      "term": "agentic workflows",
      "velocity_score": 12.5,
      "current_week_count": 8,
      "previous_week_count": 2,
      "growth_rate": 3.0,
      "first_detected": "2026-05-18",
      "total_count": 16
    }
  ]
}

Single Trend Topic Data

GET /api/v1/trends/topic-data/<slug>/

Auth: API key or logged-in browser session required.

Returns one trend topic, weekly data, summary stats, and enriched blog posts that mention the trend. Use this endpoint for single-trend analysis and content gap research.

Query parameters:

Blog post evidence includes title, URL, company, date, mention count, summary, word count, optional text preview, and company competitive-space metadata.

List Trend Reports

GET /api/v1/trend-reports/

Auth: Active Accelerate or Lead subscription required.

Returns paginated report metadata and company, competitive-space, and trend-topic associations. Full Markdown content is intentionally omitted from the list response. Accelerate accounts receive public, Free, and Accelerate reports; Lead accounts additionally receive Lead reports.

Get Trend Report

GET /api/v1/trend-reports/<slug>/

Auth: Active Accelerate or Lead subscription required.

Returns the entitled report metadata, associations, and complete Markdown content. Staff-only and higher-tier reports are returned as 404 Not Found rather than disclosed.

Raw Monthly Trend Metrics

GET /api/v1/trends/metrics/monthly/

Auth: Active Accelerate or Lead subscription required.

Returns paginated raw monthly records with topic and optional competitive-space identities, period bounds, mention/post/company counts, previous-month count, month-over-month change, and calculation timestamp.

Raw Yearly Trend Metrics

GET /api/v1/trends/metrics/yearly/

Auth: Active Accelerate or Lead subscription required.

Returns the equivalent raw yearly records with previous-year and year-over-year values.

Both raw metric endpoints accept: