Insights (Engagement Analytics)

The Insights endpoints expose Slipcase’s engagement analytics — what content and topics readers are actually clicking — derived from the click stream. They share the same base URL, apiKey authentication, and JSend response envelope as the rest of the v2 API.

GET /api/v2/insights/...

Common parameters

Parameter	Type	Default	Description
`apiKey`	string	required	Your API key
`period`	string	`7d`	Time window: `24h` (last 24 hours) or `7d` (last 7 days)
`limit`	integer	`10`	Maximum items to return (1–50)
`riskManagement`	boolean	`false`	When `true`, restrict to Risk-Management content (topic 47)

A content item in any response has this shape:

Items are listed most-engaged-first; the engagement (click) magnitude itself is not returned.

Attribute	Type	Description
`contentId`	integer	Slipcase content (article) id
`title`	string\|null	Headline
`url`	string\|null	Source article URL
`source`	string\|null	Source name
`contentType`	string\|null	e.g. `article`, `report`, `pressrelease`
`organisationType`	string\|null	e.g. `Carrier`, `Broker`, `Service Provider`
`client`	string\|null	Publisher/client; `Topic Article` denotes a 3rd-party publication

Most popular content

GET /api/v2/insights/popular-content/

Returns the most-clicked content. Without breakdown it returns a flat ranked list and supports both 24h and 7d. With breakdown it returns groups and is always over the last 7 days.

Parameter	Type	Default	Description
`breakdown`	string	(none)	One of `content-type`, `source-type`, `specialty-line`, `interest-area`, `audience-region`, `seniority`

breakdown values:

content-type — grouped by content type (article, report, …)
source-type — grouped by Carrier, Broker, Service Provider, and 3rd Party Publication
specialty-line — grouped by Specialty-Line topics (aerospace, cyber, marine, …)
interest-area — grouped by Interest-Area topics (AI in insurance, insurtech, …)
audience-region — grouped by the continent the click came from (audience geography)
seniority — grouped by the reader’s seniority (C-Suite, wider market, …)

Flat list response:

{
  "status": "success",
  "data": {
    "period": "7d",
    "items": [
      { "contentId": 100, "title": "Cyber breach at X",
        "url": "https://reuters.com/...", "source": "Reuters",
        "contentType": "article", "organisationType": "Carrier", "client": "Reuters" }
    ]
  },
  "code": 200
}

Breakdown response:

{
  "status": "success",
  "data": {
    "breakdown": "specialty-line",
    "period": "7d",
    "groups": [
      { "group": "Cyber", "slug": "cyber", "items": [ { "contentId": 100, "title": "..." } ] },
      { "group": "Marine", "slug": "marine", "items": [ { "contentId": 240, "title": "..." } ] }
    ]
  },
  "code": 200
}

# Top 10 content in the last 24h
curl "https://widget.slipcase.com/api/v2/insights/popular-content/?apiKey=YOUR_API_KEY&period=24h"

# Top content per specialty line (7d), risk-management only
curl "https://widget.slipcase.com/api/v2/insights/popular-content/?apiKey=YOUR_API_KEY&breakdown=specialty-line&riskManagement=true"

# Top content per audience continent
curl "https://widget.slipcase.com/api/v2/insights/popular-content/?apiKey=YOUR_API_KEY&breakdown=audience-region"

GET /api/v2/insights/trending-topics/

Topics ranked by reader engagement across their content in the window. Returns topics[] ordered most-popular-first.

{
  "status": "success",
  "data": {
    "period": "7d",
    "topics": [
      { "topicId": 16, "name": "Cyber", "slug": "cyber", "category": 1 },
      { "topicId": 47, "name": "Risk Management", "slug": "risk-management", "category": 2 }
    ]
  },
  "code": 200
}

category is 1 (Specialty Lines) or 2 (Interest Areas).

Co-topics within a topic

GET /api/v2/insights/topics/{id}/co-topics/

The topics that most frequently co-occur on the content clicked within topic {id}, ranked by engagement — e.g. within North American Property, the co-topics might be Climate Risk, Environmental Liability, and ESG.

{
  "status": "success",
  "data": {
    "topicId": 30,
    "period": "7d",
    "coTopics": [
      { "topicId": 51, "name": "Climate Risk", "slug": "climate-risk", "category": 2 }
    ]
  },
  "code": 200
}

curl "https://widget.slipcase.com/api/v2/insights/trending-topics/?apiKey=YOUR_API_KEY&period=7d"
curl "https://widget.slipcase.com/api/v2/insights/topics/16/content/?apiKey=YOUR_API_KEY"
curl "https://widget.slipcase.com/api/v2/insights/topics/16/co-topics/?apiKey=YOUR_API_KEY"

GET /api/v2/insights/trending-topics/growth/

Topics with the largest growth in reader engagement over the last 7 days versus the previous 7 days. Each qualifying topic includes the top content driving the rise and its top sources. Topics must clear a fixed minimum-engagement threshold to qualify (set server-side, not configurable).

Parameter	Type	Default	Description
`limit`	integer	`10`	Maximum topics to return (1–50)
`minContentItems`	integer	`5`	Minimum distinct content items in the current window to qualify
`riskManagement`	boolean	`false`	Restrict to Risk-Management content (topic 47)

{
  "status": "success",
  "data": {
    "period": "7d",
    "minContentItems": 5,
    "topics": [
      {
        "topicId": 51, "name": "Climate Risk", "slug": "climate-risk", "category": 2,
        "growthPercent": 200.0,
        "topContent": [ { "contentId": 980, "title": "..." } ],
        "topSources": [ "Reuters", "Bloomberg" ]
      }
    ]
  },
  "code": 200
}

growthPercent is the percentage change in engagement versus the previous window (no raw counts are exposed). It is null for a brand-new topic with no engagement in the previous window (a new spike); such topics rank first. topSources lists the most-engaged source names, in order. Topics are returned strongest-growth first.

curl "https://widget.slipcase.com/api/v2/insights/trending-topics/growth/?apiKey=YOUR_API_KEY"

Notes

Breakdowns are 7-day only. The period=24h window applies to the flat popular-content list and the trending-topics list; broken-down lists always use the last 7 days.
Risk Management (riskManagement=true) is available on every endpoint and filters to Risk-Management content (topic 47).
Source-type currently distinguishes Carrier, Broker, Service Provider, and 3rd Party Publication; finer “industry media” categorisation may be added later.
For the full list of topics and their ids, see Appendix A: Topics.

Insights (Engagement Analytics)

Common parameters

Most popular content

Trending topics

Top content within a topic

Co-topics within a topic

Trending growth

Notes