API 사용 방법

API 호출 주소

https://api.ddi.deepsearch.com

( GET 방식과 POST 방식을 모두 지원하며, 파라미터가 많은 경우 POST 로 호출 )

사용방법

HTTP/HTTPS 요청 시 HTTP 헤더에 다음 인증 키 추가 Authorization: Basic {인증키}

curl 예제

curl -H 'Authorization: Basic {인증키}' -XGET 'https://api.ddi.deepsearch.com/haystack/v1/news/_search?query=삼성전자'

주요 예시

기본 예시 )

삼성전자 검색 : 본문에 "삼성전자" 라는 단어가 포함된 뉴스 검색 ( 단어 매칭 ) api.ddi.deepsearch.com/haystack/v1/news/_search?query=삼성전자

관심 주제 (예:핀테크) 에 대한 뉴스 검색 api.ddi.deepsearch.com/haystack/v1/news/_search?query=핀테크 관심 주제 다수에 대한 뉴스 검색 api.ddi.deepsearch.com/haystack/v1/news/_search?query=핀테크;인공지능;딥서치;현대커머셜 특정 기간 검색 ( 예시 : 2019년 ) api.ddi.deepsearch.com/haystack/v1/news/economy/_search?query=삼성전자 and 반도체&from=20190101&to=20191231 페이지 이동 api.ddi.deepsearch.com/haystack/v1/news/economy/_search?query=삼성전자 and 반도체&from=20190101&to=20191231&page=2 개별뉴스에 대한 본문 확인 api.ddi.deepsearch.com/haystack/v1/news/economy/863648935535841448?summary=0 ( 뉴스/카테고리/uid_str 로 조회하고 summary=0 으로 지정)

증권사 활용 예시 )

1.보유 종목 뉴스

전체(뉴스/공시) 검색 "삼성전자(KRX:005930), LG전자(KRX:066570)" 등 사용자가 보유중인 기업 다수개에 대한 뉴스 및 공시를 동시에 검색 ( 단순한 단어 매칭이 아니라, ML 기반으로 기업 매칭하고, 경제/기술 분야로 뉴스를 제한하여 노이즈 제거 )

api.ddi.deepsearch.com/haystack/v1/news,company/economy,tech,disclosure/_search?summary=0&query=named_entities.entities.company.symbol:("KRX:005930" or "KRX:066570")

뉴스 검색 api.ddi.deepsearch.com/haystack/v1/news/economy,tech/_search?summary=0&query=named_entities.entities.company.symbol:("KRX:005930" or "KRX:066570")

공시 검색 api.ddi.deepsearch.com/haystack/v1/company/disclosure/_search?summary=0&query=named_entities.entities.company.symbol:("KRX:005930" or "KRX:066570")

사용자가 보유중인 기업 중 긍정 뉴스만을 조회 api.ddi.deepsearch.com/haystack/v1/news/economy,tech/_search?summary=0&query=named_entities.entities.company.symbol:("KRX:005930" or "KRX:066570") and polarity.name:긍정

사용자가 보유중인 기업 중 부정 뉴스만을 조회 api.ddi.deepsearch.com/haystack/v1/news/economy,tech/_search?summary=0&query=named_entities.entities.company.symbol:("KRX:005930" or "KRX:066570") and polarity.name:부정

2. 실시간 중요 이슈 실시간 경제 이슈 TOP 10 조회 ( 종합, 경제, 정치, 사회, 문화, 등등 섹션별로 가능 ) api.ddi.deepsearch.com/haystack/v1/topics/trending/news/economy?count=10

3. 특정 주제와 함께 언급되는 기업 리스트 조회

사물인터넷과 함께 언급되는 기업 리스트 TOP 10 조회api.ddi.deepsearch.com/haystack/v1/news/economy,tech/_aggregation?query=사물인터넷&groupby=securities.symbol:10&from=20200101&to=20201231

4. 특정 기업에 대한 뉴스 긍부정 추이

긍부정 점수 = ( 긍정 뉴스 개수 - 부정 뉴스 개수 ) / ( 긍정 뉴스 개수 + 중립 뉴스 개수 + 부정 뉴스 개수 )

ex) 삼성전자

• 긍정 뉴스 개수 : api.ddi.deepsearch.com/haystack/v1/news/_trends?query=삼성전자%20and%20polarity.name:긍정&interval=1M&from=20190101

• 부정 뉴스 개수: api.ddi.deepsearch.com/haystack/v1/news/_trends?query=삼성전자%20and%20polarity.name:부정&interval=1M&from=20190101

• 중립 뉴스 개수: api.ddi.deepsearch.com/haystack/v1/news/_trends?query=삼성전자%20and%20polarity.name:중립&interval=1M&from=20190101

5. 시황 뉴스만을 검색 api.ddi.deepsearch.com/haystack/v1/news/economy/_search?query=시황

비상장기업 관련 예시 )

비상장기업의 사업자번호( 예:딥서치) 를 활용한 뉴스 검색 api.ddi.deepsearch.com/haystack/v1/news/_search?query=named_entities.entities.company.business_rid:"603-81-82945"

비상장기업의 기업명 (예:딥서치) 이름을 통한 뉴스 검색 api.ddi.deepsearch.com/haystack/v1/news/_search?query=딥서치