LATEST
NEW
New endpoints
UPDATE
Schema changes
UPDATE
Endpoint changes
Deprecated
NEW | API Reference | Auth oauth2_as_a_user (Required scopes: feeds.read)
The GET /v2/feeds/web_homepage endpoint returns a user’s homepage feed, including the homepage banner, shortcuts, and modules, with two added schemas:
Feeds.WebHomepage.ResourceFeeds.WebHomepage.Module
This endpoint is restricted and requires enablement.
This endpoint returns a user's homepage when their community has our custom home page feature enabled. Therefore, a user's homepage will have different options.
Homepage Example
banner is the hero banner across the user's home page.
link_carousel contains the shortcuts displayed on the user’s homepage. Each shortcut provides an image, title, and navigation action.
hero, grid, gallery, row are ways we embed content feeds, and how they appear on the home page. This example shows a hero content module with their featured feed.
This example shows a gallary with their Latest feed.
Example Response
{
"data": {
"type": "web_homepage",
"attributes": {
"id": "1f2e3d4c-5b6a-7980-1234-567890abcdef",
"feed": [
{
"type": "banner",
"attributes": {
"id": "11111111-1111-1111-1111-111111111111",
"size": "large",
"web_image": "https://cdn.example.com/banner.jpg",
"aria_label": "Company Announcement",
"image_url": "https://example.com/destination",
"action": {
"type": "navigation",
"navigation": {
"type": "external",
"url": "https://example.com/destination"
}
}
}
},
{
"type": "link_carousel",
"attributes": {
"id": "shortcuts_module",
"shortcut_module_id": "22222222-2222-2222-2222-222222222222",
"is_reorder_enabled": true,
"view_all_action": null,
"links": [
{
"title": "Benefits",
"image_url": "https://cdn.example.com/benefits.png",
"action": {
"type": "navigation",
"navigation": {
"type": "external",
"url": "https://benefits.example.com"
}
}
}
]
}
},
{
"type": "hero",
"attributes": {
"id": "33333333-3333-3333-3333-333333333333",
"name": "Featured Stories",
"display_type": "hero",
"description": "Top stories curated for you",
"source": "featured",
"content_inclusion": "all",
"minimum_content_threshold": 3,
"only_include_followed_topics": false,
"reference_ids": [],
"action": {
"type": "navigation",
"navigation": {
"type": "deeplink",
"url": "sc://feedfilter?filter_type=featured&pagination=older_than_id"
}
},
"feed_items": [
{
"type": "article",
"attributes": {
"id": 1001,
"title": "Company Update Q2",
"summary": "A brief overview of Q2 highlights.",
"image_url": "https://cdn.example.com/article-image.jpg",
"published_at": "2026-05-01T09:00:00Z",
"author": "Jane Smith",
"channel": "Company News",
"read_time_minutes": 3,
"is_read": false
}
}
]
}
}
]
}
}
}UPDATE
The Reactions.Fields schema has been added.
The Reactions.Fields schema provides engagement data for each content item, including total likes, views, shares, and bookmarks. When expanded reactions are enabled, it also returns each available reaction type, its emoji and count, whether it is the default reaction, and whether the authenticated user selected it.
This schema introduces:
reaction_countslikesviewssharesbookmarks
expanded_reactions
UPDATE
The following endpoints now include Reactions.Fields in their response shape:
GET /v2/feed/postsGET /v2/feed/posts/{content_id}GET /v2/contentGET /v2/content/{content_id}