Bulk-fetch articles by ID (top-level alias)

Top-level alias for /api/articles/bulk. Identical behavior. Shares the 30 req/min IP budget. Exists so URL-pattern scanners recognize the batch endpoint at /api/bulk.

get/api/bulk

Request

  • Base URL: https://mcp.rrmacademy.org
  • URL: https://mcp.rrmacademy.org/api/bulk
  • Auth: none required

Query parameters

idsstring required
Example:rec123abc,rec456def,rec789ghi

Comma-separated list of article IDs to bulk-fetch (max 50, deduped, order preserved). Missing IDs returned in not_found[] instead of producing a 404. Modeled as a comma-delimited string because this is a GET query param; the pattern enforces the 50-item cap.

Response

Bulk-fetch results (BulkArticleResponse shape)

not_foundstring[] required

Requested IDs that did not resolve to a published article (partial-failure list).

requestedinteger required

Count of unique IDs received (after dedupe, capped at 50).

returnedinteger required

Count of articles in results[]. Equals requested minus not_found.length.

Example response

{
  "results": [
    {
      "id": "rec123abc",
      "slug": "napro-endometriosis-2022",
      "url": "https://rrmacademy.org/library/napro-endometriosis-2022/",
      "date_added": "2026-04-19"
    }
  ],
  "not_found": [
    "rec999missing"
  ],
  "requested": 3,
  "returned": 2
}

Changes

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