Getting Started
Feeds can get more complex than most endpoints, due to the various feed types, options, and pagination.
At the most simple level, you can load a community feed with the following endpoint:
GET: https://api.scored.co/api/v2/post/hotv2.json?community=meta
Sort Options
Feeds can be sorted in multiple ways. Each sorting method has a separate endpoint, but are functionally equivalent:
- hot (/api/v2/post/hotv2.json)
- new (/api/v2/post/newv2.json)
- active (/api/v2/post/activev2.json)
- rising (/api/v2/post/risingv2.json)
- top (/api/v2/post/topv2.json)
Common Parameters
The following parameters are valid for all feed requests.
| Value | Type | Required | Description |
|---|---|---|---|
| community | string | true | requested community feed |
| from | string | false | used for pagination |
| appSafe | boolean | false | return a censored set of content which is safe app stores |
| feedId | int | false | request a custom feed |
| blockedCommunities | string array | false | provide a list of communities to exclude¹ |
¹ When authenticated, you do not need to provide blockedCommunities. Communities which are blocked at an account level will be excluded without setting this parameter.
Trending, All, and Home
Trending, All, and Home feeds can be requested with the same endpoints.
To request Home, set community to Home.
To request Trending or All, set community to win.
View more Trending and All feed options.
Pagination
Use the from parameter to paginate feeds (get the next page of results).
Provide the uuid of the post from which you would like to fetch more posts.
This is typically the uuid of the last post in your previous page.
It is not possible to paginate backwards.
Top Sort
View how to use the Top sort.