Trends
Public read-only endpoints for trend topics and trend analysis.
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 |
space |
string | none | Competitive space slug filter |
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 |
space |
string | none | Competitive space slug filter |
projections |
boolean | false |
Include projected values for the current incomplete period |
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:
| Parameter | Type | Default | Description |
|---|---|---|---|
weeks |
integer | 52 |
Number of weekly trend periods to return |
post_limit |
integer | 50 |
Maximum matching blog posts to return |
post_days |
integer | none | Only include posts from the last N days |
post_weeks |
integer | none | Only include posts from the last N weeks |
post_months |
integer | none | Only include posts from the last N months |
space |
string | none | Competitive space slug filter |
Blog post evidence includes title, URL, company, date, mention count, summary, word count, optional text preview, and company competitive-space metadata.