그노시스 (Gnosis) · Part of rld.kr Open API v1

오픈 API 개발자 센터

외부 웹사이트, 모바일 앱, 디스코드 봇, 위젯 등에서 그노시스(Gnosis)에 발행된 실시간 뉴스, 언론사, 소속 기자, 댓글 데이터를 자유롭게 조회할 수 있는 REST API입니다. 모든 엔드포인트는 CORS (Access-Control-Allow-Origin: *) 가 기본 허용되어 있습니다.

Base URL

https://nosis.rld.kr/api/v1

실시간 API 응답 테스트

외부 앱 연동 코드 예시 (JavaScript / TypeScript)

// 다른 웹사이트, 앱, 봇에서 그노시스(nosis) 최신 뉴스 불러오기
const response = await fetch("https://nosis.rld.kr/api/v1/articles?limit=5");
const { data: articles } = await response.json();

articles.forEach((article) => {
  console.log(`[${article.publisherName}] ${article.title} - ${article.reporterName} 기자`);
});

GET/api/v1/articles

기사 목록 및 검색 조회

그노시스(nosis)에 발행된 전체 뉴스 기사 목록을 최신순 또는 인기순으로 조회하며, 섹션·언론사·기자·검색어 필터링을 지원합니다.

Query Parameters (쿼리 파라미터)

파라미터	타입	설명
category	string (선택)	뉴스 섹션 필터 (정치, 경제, 사회, 생활/문화, 국제, IT/과학, 오피니언)
publisherId	string (선택)	특정 언론사 고유 ID로 필터링
publisherName	string (선택)	언론사 이름 부분 일치 필터링
reporter	string (선택)	작성 기자 이름으로 필터링
headline	boolean (선택)	true 설정 시 메인 헤드라인 기사만 조회
breaking	boolean (선택)	true 설정 시 주요속보 기사만 조회
q	string (선택)	제목·부제목·본문·언론사·기자명 통합 키워드 검색
sort	string (선택)	정렬 방식: latest(최신순, 기본값) 또는 popular(인기순)
limit	number (선택)	최대 반환 기사 수 (기본값 50, 최대 200)

응답 예시 (JSON Response)

{
  "status": "ok",
  "service": "nosis (Part of rld.kr) Open API",
  "total": 1,
  "count": 1,
  "data": [
    {
      "id": "art-1762345678901",
      "publisherId": "pub-1762345600000",
      "publisherName": "중앙일보",
      "publisherColor": "#035fe0",
      "reporterName": "홍길동",
      "reporterRole": "정치부 기자",
      "category": "정치",
      "title": "기사 제목",
      "subtitle": "기사 요약 부제목",
      "content": "기사 본문 텍스트...",
      "isHeadline": true,
      "isBreaking": false,
      "viewCount": 42,
      "commentCount": 3,
      "reactions": {
        "useful": 5,
        "interesting": 2,
        "empathy": 4,
        "analytical": 1,
        "followup": 0
      },
      "createdAt": "2026-11-05T12:00:00.000Z",
      "updatedAt": "2026-11-05T12:00:00.000Z"
    }
  ]
}

GET/api/v1/articles/{id}

단일 기사 상세 및 댓글 조회

특정 기사 ID의 전체 본문, 발행 언론사 정보, 그리고 해당 기사에 작성된 전체 댓글 목록을 한 번에 반환합니다.

응답 예시 (JSON Response)

{
  "status": "ok",
  "service": "nosis (Part of rld.kr) Open API",
  "data": {
    "article": {
      "id": "art-1762345678901",
      "title": "기사 제목",
      "reporterName": "홍길동",
      "content": "기사 본문..."
    },
    "publisher": {
      "id": "pub-1762345600000",
      "name": "중앙일보",
      "description": "공식 뉴스룸",
      "reporters": [
        { "id": "rep-1", "name": "홍길동", "role": "정치부 기자" }
      ]
    },
    "comments": [
      {
        "id": "cmt-1762345999999",
        "articleId": "art-1762345678901",
        "authorName": "독자닉네임",
        "content": "좋은 기사 감사합니다.",
        "likes": 3,
        "dislikes": 0,
        "createdAt": "2026-11-05T12:10:00.000Z"
      }
    ]
  }
}

GET/api/v1/publishers

언론사 및 소속 기자단 목록 조회

그노시스에 개설된 모든 언론사 목록과 각 언론사에 등록된 소속 기자 명단(`reporters`), 발행 기사 수(`articleCount`)를 반환합니다.

Query Parameters (쿼리 파라미터)

파라미터	타입	설명
id	string (선택)	특정 언론사 고유 ID로 조회
q	string (선택)	언론사명 또는 소개 문구 검색

응답 예시 (JSON Response)

{
  "status": "ok",
  "service": "nosis (Part of rld.kr) Open API",
  "total": 1,
  "data": [
    {
      "id": "pub-1762345600000",
      "name": "그노시스 타임즈",
      "description": "신속하고 정확한 보도",
      "themeColor": "#035fe0",
      "ownerName": "발행인",
      "articleCount": 12,
      "reporters": [
        {
          "id": "rep-1762345600001",
          "name": "김기자",
          "role": "편집장"
        }
      ],
      "createdAt": "2026-11-05T12:00:00.000Z"
    }
  ]
}

GET/api/v1/comments

댓글 목록 조회

전체 최신 댓글 또는 특정 기사(`articleId`)에 작성된 댓글 목록을 조회합니다.

Query Parameters (쿼리 파라미터)

파라미터	타입	설명
articleId	string (선택)	특정 기사 ID에 달린 댓글만 필터링
limit	number (선택)	최대 반환 댓글 수 (기본값 50, 최대 200)

응답 예시 (JSON Response)

{
  "status": "ok",
  "service": "nosis (Part of rld.kr) Open API",
  "total": 1,
  "count": 1,
  "data": [
    {
      "id": "cmt-1762345999999",
      "articleId": "art-1762345678901",
      "authorName": "독자",
      "content": "의견을 남깁니다.",
      "likes": 1,
      "dislikes": 0,
      "createdAt": "2026-11-05T12:10:00.000Z"
    }
  ]
}