Bulk-fetch articles by ID

Returns up to 50 published library articles by ID in a single call. Comma-separated IDs in the ids query parameter. Missing IDs are returned in not_found[] instead of producing a 404. Shares the 30 req/min IP budget with /api/articles.

get/api/articles/bulk

Request

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

Query parameters

idsstring required
Example:rec123abc,rec456def,rec789ghi

Comma-separated list of article IDs to fetch (max 50, deduped, order preserved). Modeled as a comma-delimited string because this is a GET query param; the pattern enforces the 50-item cap.

Response

Bulk article results. Missing IDs appear in not_found[].

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.