DocsAPI ReferenceNewsroom/bff/newsroom/shortlist
getNewsroomAdmin BFF

/bff/newsroom/shortlist

Returns the daily TOP-N candidate articles for the authenticated organisation, ranked by score. Each item exposes scores, source, status and (if generated) draft reference.

NewsroomgetBffNewsroomShortlist

Parameters

3 query

3 total
Query · 3
datestring

YYYY-MM-DD shortlist date filter.

statusstring

Status filter: pending, generating, generated, dismissed.

limitstring

Maximum number of items to return.

Request

GET /bff/newsroom/shortlist

get
curl -X GET "https://api.bizkithub.com/bff/newsroom/shortlist?date=example_date&status=example_status&limit=example_limit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

JSON payload

{
  "items": [
    {
      "id": "example_id",
      "rank": 0,
      "title": "example_title",
      "source": "example_source",
      "sourceUrl": "example_sourceUrl",
      "feedId": "example_feedId",
      "hotnessScore": 0,
      "czRelevanceScore": 0,
      "cctvFitScore": 0,
      "totalScore": 0,
      "reason": "example_reason",
      "status": "example_status",
      "draftId": "example_draftId",
      "draftStatus": "example_draftStatus",
      "topicType": "example_topicType",
      "severity": "example_severity"
    }
  ],
  "itemCount": 0
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key