HIhify
Explore

Fetch a page of the Explore feed

Returns the viewer's ranked feed of clips, highlights and editorial posts. Paging is by opaque cursor; pass the previous response's next_cursor to continue. Only the item envelope is described here — source carries a different shape per type.

get/v1/explore

Request

  • Base URL
    https://api.hify.club
  • Auth
    API key in header X-User-Token

Query parameters

cursorstring

Opaque cursor from a previous response's next_cursor.

per_pageinteger

Items per page.

refresh'true'

Accepted for compatibility; the feed reads through on every request.

Response

A page of the feed

next_cursorstring nullable

Pass back as cursor for the next page. Null on the last page.

head_cursorstring nullable

Marks the top of the feed, for the new-items count.

empty_state'caught_up' | 'no_content' nullable

Why an empty page is empty. Null when the page has items.

Example response

{
  "items": [
    {
      "feed_item_id": "pm_8231",
      "badge": "throwback"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.