api-demand.md
API Evangelist Network API
The demand-side view: what companies build, buy and hire for, and — inverted — which companies show demand for a given service, tool or standard.
GET https://api.apievangelist.com/v1
/insights/company/{slug}/dimensions
Each dimension read against the measured cohort: median, mean and max, this company's rank and percentile, and an index where 1.0 is exactly typical. A company with no dimension scores returns 422 rather than a fabricated zero — stack-only records sourced from blogs are not measured on this axis.
slug
string · required
200403404422
Dimensions with benchmark columns (Pro).
GET https://api.apievangelist.com/v1
/insights/company/{slug}/peers
Peers by sub-sector where the data supports it and by industry otherwise, each with signal totals and top dimensions. The response states which basis it used.
slug
string · required
limit
integer
200403404
Comparable companies (Pro).
GET https://api.apievangelist.com/v1
/insights/company/{slug}/whitespace
Ranked by how many peers carry each entity, with the peer share and the cohort-wide count so a peer-group artifact is visible as one.
slug
string · required
limit
integer
200403404
What peers run that this company does not (Pro).
GET https://api.apievangelist.com/v1
/insights/company/{slug}/signals
Every service, tool and standard on the company's stack, each with how many companies across the cohort carry it and its radar ring.
slug
string · required
200403404
The adopted stack, entity by entity (Pro).
GET https://api.apievangelist.com/v1
/insights/entities
Every service, tool and standard companies are measured against, ranked by reach. Free — this is the left-hand side of the inversion. Every response carries a basis block disclosing the corpus, the matcher, and the top-25 truncation that bounds what can be named.
kind
string · enum
Enum values: service
tool
standard
q
string
min_companies
integer
page
integer
limit
integer
200400
The demand-side entity catalog.
GET https://api.apievangelist.com/v1
/insights/entity/{kind}/{slug}
THE INVERSION. Every other insights route runs company -> stack; this one runs stack -> companies, broken down by industry — the prospecting query, and one that exists in no report, bundle or page. Returns BOTH the authoritative company count and the companies it can actually name. The two are measured on different bases and routinely disagree in either direction; naming_note explains which way and why, and named_by_source gives the corpus composition.
kind
string · enum · required
Enum values: service
tool
standard
slug
string · required
Entity slug or display name — either resolves.
industry
string
limit
integer
200400403404
Which companies show demand for this (Pro).