Trends

List Trend Topics

GET /api/v1/trends/topics/

Auth: None.

Returns active trend topics, ordered by name.

Query parameters:

Parameter	Type	Description
`page`	integer	Page number
`page_size`	integer	Results per page, max `200`

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:

Parameter	Type	Default	Description
`weeks`	integer	`12`	Number of weeks to analyze

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:

Parameter	Type	Default	Description
`weeks`	integer	`12`	Number of weeks to analyze

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
    }
  ]
}

Plushcap, by Matt Makai. 2021-2026.