Competitive Intelligence
Premium read-only competitive spaces and comparison dashboards.
Competitive Intelligence
These endpoints require an active Accelerate or Lead subscription.
List Competitive Spaces
GET /api/v1/competitive-spaces/
Returns the paginated competitive-space catalog.
| Parameter | Description |
|---|---|
search |
Search names and descriptions |
space_type |
Filter by competitive-space type code |
company |
Return spaces containing a company slug |
page, page_size |
Pagination; maximum page size is 200 |
Get Competitive Space
GET /api/v1/competitive-spaces/<slug>/
Returns descriptions, type, company count, and compact member-company records.
Competitive-Space Comparison
GET /api/v1/competitive-spaces/<slug>/comparison/
Returns dashboard data for all companies in a space or a selected member subset.
| Parameter | Default | Description |
|---|---|---|
section |
all |
blog, youtube, hackernews, or all |
companies |
all members | Comma-separated member company slugs |
start_year |
2022 |
First year, from 2019 through the current year |
Blog data includes monthly post series and publishing summaries. YouTube data includes monthly subscriber series and latest channel/share summaries. Hacker News data includes monthly counts for posts with at least 50 points.
Arbitrary Company Comparison
GET /api/v1/company-comparisons/
Compares two to ten company slugs, including monthly/yearly blog post and word counts, YouTube subscriber/view/video totals, and Hacker News post/point data.
| Parameter | Default | Description |
|---|---|---|
companies |
required | Comma-separated list of 2–10 company slugs |
section |
all |
blog, youtube, hackernews, or all |
start_year |
2022 |
First year, from 2019 through the current year |
keyword |
none | Optional title/body filter for the blog section |
Important Developer Trends
GET /api/v1/competitive-spaces/<slug>/trends/
Returns the published Core and Important trend rankings for a competitive space. Rankings always cover the whole space, independent of company filters.
| Parameter | Default | Description |
|---|---|---|
granularity |
weekly |
weekly, monthly, or yearly |
period |
latest | Calendar-period start in YYYY-MM-DD format |
periods |
8 |
Score-history length from 1 through 52 |
The response includes component scores, rank and tier changes, safe strategic rationales, confidence, score history, available periods, and reconstruction labels. Internal evidence and editorial override notes are never returned.