요청주소 : https://www.newstore.or.kr/api/search.json
기본인자
| 변수명 | 타입 | 설명 |
|---|---|---|
| apiKey | String | API 요청 시 검증을 위한 키값 |
요청인자
| 변수명 | 타입 | 변수설명 |
|---|---|---|
| query | String | 검색 질의어를 지정합니다.(검색어 없이 검색 가능) |
| from | String | 검색시작일 [yyyy-MM-dd] |
| until | String | 검색종료일 [yyyy-MM-dd] |
| category | String | 한국언론진흥재단에서 지정한 뉴스 통합 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.) |
| category_incident | String | 한국언론진흥재단에서 지정한 뉴스 사건/사고 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.) |
| provider_subject | String | 언론사에서 제공한 News의 주제 분류 값을 조건으로 지정 합니다.(,를 구분자로 나열할 수 있습니다.) |
| byline | String | 기자 이름을 조건으로 지정합니다. |
| subject_info | String | 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.) |
| subject_info1 | String | 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.) |
| subject_info2 | String | 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.) |
| subject_info3 | String | 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.) |
| subject_info4 | String | 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.) |
| sort | String | 검색된 뉴스기사의 정렬 방식을 지정합니다. |
| hilight | Integer | 기사에서 검색어가 포함된 영역을 찾아 지정한 범위(최대 200자)를 출력 결과로 제공합니다. |
| return_from | Integer | 검색된 결과 목록에서 반환할 시작 위치를 지정합니다. return_from 필드는 최대 20000까지만 가능합니다. |
| return_size | Integer | 검색된 결과 목록에서 반환할 시작 위치부터 반환할 개수를 지정합니다. 최대 10000까지 가능합니다. 특정 언론사는 최대 15000까지 제한을 두고 있습니다. |
| fields | String | 출력 결과에서 반환할 필드 값을 지정합니다.(,를 구분자로 나열할 수 있습니다.) |
출력값
| 출력명 | 설명 |
|---|---|
| total_hits | 검색된 전체 문서 건수를 반환합니다. |
| documents | 요청인자값의 fields에서 지정한 필드들을 포함한 배열 |
| documents[].news_id | 언론진흥재단내에서 관리하는 뉴스 식별자입니다. |
| documents[].title | 뉴스기사 제목 |
| documents[].content | 뉴스기사 본문 |
| documents[].published_at | 뉴스기사 발행일을 세계표준시간 기준으로 반환합니다. |
| documents[].enveloped_at | 언론사로부터 뉴스기사를 수집한 시간 |
| documents[].dateline | 언론사로부터 전달받은 언론사의 뉴스 출고시간 |
| documents[].provider | 언론사 |
| documents[].category | 뉴스통합분류체계 |
| documents[].hilight | 검색어가 포함된 영역입니다. 요청파라메터에서 지정한 경우에만 반환합니다. |
| documents[].byline | 기자 이름 |
| documents[].images | 이미지가 포함된 뉴스 기사의 경우 이미지 파일 이름을 반환 |
| documents[].provider_subject | 언론사에서 제공한 뉴스 분류 값(코드) |
| documents[].subject_info | NewsML에서 정의한 프로퍼티 SubjectInfo 의 값 |
| documents[].subject_info1 | NewsML에서 정의한 프로퍼티 SubjectInfo1 의 값 |
| documents[].subject_info2 | NewsML에서 정의한 프로퍼티 SubjectInfo2 의 값) |
| documents[].subject_info3 | NewsML에서 정의한 프로퍼티 SubjectInfo3 의 값 |
| documents[].subject_info4 | NewsML에서 정의한 프로퍼티 SubjectInfo4 의 값 |
| documents[].provider_news_id | 언론사에서 제공한 뉴스 고유 식별값 |
| documents[].publisher_code | 언론사에서 제공한 뉴스 고유 식별값 |
| documents[].provider_link_page | 언론사 원본 링크페이지(없는 경우 존재) |
| documents[].printing_page | 지면번호(없는 경우 존재) |
메시지 설명
| 구분 | 설명 |
|---|---|
| ERROR | 잘못된 API Key입니다. |
| ERROR | 구매한 API호출수를 모두 소진했습니다. |
| ERROR | 알수없는 에러가 발생했습니다. |