연합뉴스·한국경제·매일경제를 그대로 구조화된 데이터로

연합뉴스·한국경제·매일경제를 그대로 구조화된 데이터로

국내 매체 기사를 시스템에서 쓰려고 하면 보통 크롤러부터 만들게 됩니다. 매체마다 HTML을 파싱하고, 본문과 날짜를 뽑아내고, 종목을 매칭하고, 레이아웃이 바뀔 때마다 고칩니다. 정작 뉴스를 쓰기 전 단계에서 시간이 다 나갑니다.

finlight는 연합뉴스, 연합인포맥스, 매일경제, 한국경제, 서울경제, 조선비즈, 뉴스핌을 블룸버그나 로이터와 완전히 동일한 스키마로 반환합니다. 한국어 그대로, 하나의 API에서 받을 수 있습니다.

지원하는 국내 소스

인덱스에 들어 있는 국내 매체 가운데 일부입니다.

한국어 매체는 기본 소스 세트로 들어옵니다. 별도 계약이나 개별 온보딩이 필요 없습니다. The Korea Herald 같은 국내 영문 매체는 기본 세트 밖에 있으며, 같은 날의 보도를 두 언어로 함께 보고 싶을 때 optInSources로 추가하면 됩니다. 실제 목록은 소스 목록에서 확인할 수 있고, 각 소스의 언어와 기본 세트 포함 여부가 함께 표시됩니다. 목록은 계속 늘어납니다.

연합인포맥스는 특히 다른 층을 채웁니다. 원화와 국고채 커브를 실제로 움직이는 금리·크레딧·외환 데스크의 기사인데, 이 취재는 영어로 거의 다시 쓰이지 않습니다.

한국어 기사에도 동일한 증강 정보가 붙습니다

언어에 따라 정보가 빠지지 않습니다. 한국어 기사에도 영어 기사와 똑같이 감성(sentiment), 카테고리, 그리고 해결된 기업 엔티티(티커, ISIN, OpenFIGI, 상장 거래소)가 붙습니다.

한국어 헤드라인을 직접 형태소 분석해서 종목에 연결하는 작업이 필요 없다는 뜻입니다. 기사는 이미 KOSPI 및 KOSDAQ 종목에 연결된 상태로 도착합니다.

해외에서 어떻게 보도하는지도 같은 쿼리로

같은 스키마로 나란히 놓이는 것은 블룸버그, 로이터, WSJ, FT, CNBC, 배런스, 마켓워치, 야후 파이낸스, 벤징가입니다. 일본어로는 니혼게이자이신문, NHK, 지지통신. 중국어로는 차이신, 둥팡차이푸, 차이롄서. 아랍어로는 아르캄, 알 이크티사디야, 알 아라비야. 보도자료로는 AP, PR Newswire, GlobeNewswire. 디지털 자산으로는 CoinDesk와 The Block입니다. 이 밖에도 여러 매체가 있고, 매달 늘어납니다.

한국에서는 같은 기업에 대한 국내 서사와 해외 서사가 자주 갈립니다. 해외에서는 반도체 사이클 기사인 사안이 국내에서는 지배구조 기사인 날이 있습니다. 두 언어가 같은 인덱스에 있으면 둘 중 하나를 고르는 대신 나란히 놓고 볼 수 있습니다.

서울장은 미국장이 열리기 전에 마감합니다. 미국 지표에 대한 국내 해석이 영어 후속 기사보다 몇 시간 먼저 나온다는 뜻이고, 그 시차는 추정이 아니라 측정할 수 있는 값이 됩니다.

사용 방법

기사는 /v2/articles에 POST로 요청합니다. language의 기본값은 en이므로, 한국어 보도를 받으려면 명시적으로 지정하세요.

curl -X POST 'https://api.finlight.me/v2/articles' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -d '{ "language": "ko", "query": "한국은행" }'

국내 상장사로 좁히려면 쿼리 안에서 거래소를 지정합니다. XKRX는 한국거래소의 MIC 코드이며 KOSPI와 KOSDAQ을 모두 포함합니다.

curl -X POST 'https://api.finlight.me/v2/articles' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -d '{ "language": "ko", "query": "exchange:XKRX", "includeEntities": true }'

includeEntities는 기사에 연결된 기업을 해결해서 반환합니다(유료 플랜). 한국어 매체는 기본 소스 세트로 들어오므로 새 엔드포인트도, 마이그레이션도 필요 없습니다. 언어 파라미터만 추가하면 됩니다.

실시간으로 받고 싶다면 동일한 필터를 WebSocket과 webhook에서도 지정할 수 있습니다. 한국어 기사도 게재 시점에 그대로 흘러옵니다.

코드를 쓰기 전에 대시보드에서 확인하세요

먼저 붙여 보고 나서 확인할 필요는 없습니다. 대시보드의 API Tester가 요청을 만들어 주고 language를 설정한 뒤 실제 응답을 그 자리에서 보여 줍니다. 직접 보는 종목으로 몇 분이면 커버리지를 검증할 수 있습니다. 소스 목록에서는 각 소스의 언어와, 그 소스가 내 기본 소스 세트에 포함되는지를 확인할 수 있습니다. 실시간 전송은 WebSocket Tester에서 동일하게 시험해 볼 수 있습니다.

아랍어 보도도 함께 제공합니다

아르캄, 알 이크티사디야, 알 아라비야, 알샤르크 비즈니스, 무바셔, 자우야, 스카이뉴스 아라비아를 같은 시점에 추가했습니다. 걸프와 중동·북아프리카 보도를 아랍어 그대로 다루려면 아랍어 금융 매체를 참고하세요.

일본어와 중국어 보도는 이미 제공 중입니다. 일본 금융 매체와 중국 금융 매체를 보세요.

무료 API 키부터 시작하세요

한국어 보도는 무료 플랜을 포함한 모든 플랜에서 이용할 수 있습니다. 키를 만들고, 쿼리를 한 번 실행하고, 무엇이 돌아오는지 확인해 보세요. 신용카드도, 영업 미팅도 필요 없습니다.

규모가 커지면 Pro Light가 소규모 프로덕션 워크로드를, Pro Standard와 Pro Scale이 트레이딩과 리서치 팀에 필요한 요청량과 한도를 커버합니다.

필요한 소스가 보이지 않나요? 연락 주세요. 이 목록이 늘어난 큰 이유는 고객 요청입니다.

다음으로 읽을 것

• 티커와 거래소를 제대로 다루기.
• 고급 필터링: finlight API로 정밀한 쿼리 만들기.
• 아랍어 금융 매체.
• 전체 문서.

무료 API 키 받기 →