Get Category's Feed

This endpoint retrieves the category feed.

info

This operation requires authentication only if content_availability community option is false.

HTTP Request

GET /api/v2/category/{id}/feed/

Parameters

Name	In	Type	Required	Description
id	path	string	true	A unique integer value identifying this category
limit	query	integer	false	Number of results to return per page
offset	query	integer	false	The initial index from which to return the results
ordering	query	string	false	The ordering of the feed. Default is based on stream_order_by field in Category object

Enumerated Values

Parameter	Value	Description
» ordering	recent	Order by recent creation datetime
» ordering	last_activity	Order by last activity in the Feed object
» ordering	relevance	Order by relevance algorithm

Example Request

JavaScript

const headers = {
  'Accept':'application/json',
  'Authorization': 'Bearer {access_token}'
};

fetch('/api/v2/category/{id}/feed/',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

Bash

# You can also use wget
curl -X GET /api/v2/category/{id}/feed/ \
  -H 'Accept: application/json'
  -H 'Authorization: Bearer {access_token}'

Responses

Status	Meaning	Description	Schema
200	OK	Response status code	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» count	integer	false	none	Total results count
» next	string(uri)¦null	false	none	Next page url
» previous	string(uri)¦null	false	none	Previous page url
» results	[Feed]	false	none	List of results

Example responses

200

{
  "count": "integer",
  "next": "string(uri)",
  "previous": "string(uri)",
  "results": [
        {
            "type": "string",
            "post": {
                "id": "integer",
                "type": "string",
                "last_activity_at": "string",
                "author": {User},
                "added_at": "string",
                "last_edited_at": "string",
                "html": "string",
                "summary": "string",
                "deleted": "boolean",
                "collapsed": "boolean",
                "comment_count": "integer",
                "view_count": "integer",
                "vote_count": "integer",
                "reactions_count": [{Reaction}],
                "voted": "boolean",
                "reaction": {Reaction},
                "follower_count": "integer",
                "followed": "boolean",
                "suspended": "boolean",
                "flag_count": "integer",
                "share_count": "integer",
                "slug": "string",
                "categories": [{Category}],
                "medias": [{Media}],
                "location": "string",
                "addressing": ["integer"],
                "tags": ["integer"],
                "poll": {Poll}
            },
            "seen_by_id": ["integer"],
            "has_boost": "boolean"
        },
  ]
}