Trending Topics

The trending topics endpoint returns topics ranked by reader engagement within a specified time window. Topics are returned in descending order of popularity — the first item in the array is the most trending topic.

GET /api/v2/topics/trending/

Parameters

Parameter	Type	Default	Description
apiKey	string	required	Your API key
period	string	week	Time window: now (last 24 hours) or week (last 7 days)
companyType	string	(all)	Filter by audience segment: broker or carrier. Omit for all users.
excludeTopics	string	(none)	Comma-separated topic IDs to exclude from results
includeTopics	string	(none)	Comma-separated topic IDs to force include (overrides default exclusions)
limit	integer	20	Maximum number of topics to return (1-50)

Response

Returns a JSend success response containing an array of topic objects. The array is ordered by trending rank — the first element is the most popular topic, the second is the next most popular, and so on.

{
  "status": "success",
  "data": {
    "topics": [
      {
        "id": 16,
        "name": "Cyber",
        "slug": "cyber",
        "description": "News, insights and thought leadership for re/insurance professionals with an interest in cyber.",
        "category": 1
      },
      {
        "id": 47,
        "name": "Risk Management",
        "slug": "risk-management",
        "description": "News, insights and thought leadership for re/insurance professionals with an interest in risk management.",
        "category": 2
      }
    ]
  },
  "code": 200
}

Topic attributes

Attribute	Type	Description
id	integer	Unique Slipcase identifier for the topic
name	string	Human-readable topic name
slug	string	URL-friendly identifier; links to https://slipcase.com/topic/{slug}
description	string	Short description of the topic
category	integer	Topic category: 1 (Specialty Lines) or 2 (Interest Areas)

Note

Some broad topics (e.g. “Topical Trends”, ID 38) are excluded from results by default. Use the includeTopics parameter to force include them if needed.

Examples

Trending topics in the last 24 hours:

curl "https://widget.slipcase.com/api/v2/topics/trending/?apiKey=YOUR_API_KEY&period=now"

Top 5 trending topics among brokers this week, excluding topics 1 and 2:

curl "https://widget.slipcase.com/api/v2/topics/trending/?apiKey=YOUR_API_KEY&period=week&companyType=broker&excludeTopics=1,2&limit=5"

Force include a default-excluded topic:

curl "https://widget.slipcase.com/api/v2/topics/trending/?apiKey=YOUR_API_KEY&includeTopics=38"

Notes

• Trending data is based on article engagement and is updated in near real-time.
• The maximum supported time window is 7 days (week). Longer ranges may be supported in a future release.
• For the full list of available topics and their IDs, see Appendix A: Topics.