Explore

Mark feed items as watched

Records that the viewer finished watching one or more feed items so they drop out of their Explore feed. Batched so a fast-scrolling client need not issue one request per item. Idempotent — re-posting an already-viewed item is a no-op. Unparseable ids are skipped and returned under rejected_feed_item_ids rather than failing the whole batch.

post/v1/explore/viewed

Request

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

Request body

feed_item_idsstring[] required

Feed item ids to mark watched (e.g. "pm_8231").

Example request

{
  "feed_item_ids": [
    "pm_8231",
    "pm_8242"
  ]
}

Response

Views recorded

accepted_feed_item_idsstring[]

Ids that were recorded (de-duplicated).

rejected_feed_item_idsstring[]

Ids whose prefix did not name a known feed source.

Example response

{
  "accepted_feed_item_ids": [
    "pm_8231",
    "pm_8242"
  ],
  "rejected_feed_item_ids": [
    "xx_999"
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.