finlight Logo

Monday, July 13, 2026

finlight API로 국가와 분류별 글로벌 뉴스 가져오기

Kevin Bartsch
TutorialGuide

finlight API로 국가와 분류별 글로벌 뉴스 가져오기

시장은 글로벌하지만, 대부분의 뉴스 API는 구분 없는, 영어 일색의 정보 홍수를 그대로 안겨 줍니다. finlight는 보도를 국가와 분류라는 두 축으로 잘라 보게 해 주고, 당신이 관심 있는 시장의 언어로 읽을 수 있게 해 줍니다.

분류로 필터링하기

모든 기사는 13개 분류 중 하나 이상으로 태깅됩니다.

markets, economy, business, politics, geopolitics, regulation, technology, energy, commodities, crypto, health, climate, security

원하는 분류를 categories에 전달하세요.

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "categories": ["technology", "crypto"],
    "pageSize": 20
  }'

국가로 필터링하기

기사는 또한 영향을 미치는 국가별로 ISO 3166-1 alpha-2 코드(US, GB, DE, JP 등)를 사용해 태깅됩니다. countries와 categories를 결합하면 정밀하게 초점을 맞출 수 있습니다.

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countries": ["US", "GB"],
    "categories": ["regulation"],
    "pageSize": 20
  }'

이는 미국과 영국에 영향을 미치는 규제 관련 기사를 반환합니다. 국가와 분류 필터는 다른 모든 조건과 AND로 결합되므로, 그 위에 tickers, 날짜 범위, 또는 query를 추가할 수 있습니다.

현지 언어로 읽기

finlight는 9개 언어의 뉴스를 다룹니다. 영어(en), 중국어 간체(zh), 힌디어(hi), 스페인어(es), 일본어(ja), 한국어(ko), 포르투갈어(pt), 아랍어(ar), 러시아어(ru)입니다. language 필드를 설정해 어떤 언어의 보도를 받을지 선택하세요(기본값은 en).

# Python
from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesParams

client = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))

params = GetArticlesParams(
    countries=["JP"],
    categories=["markets", "economy"],
    language="ja",
    pageSize=20,
)
response = client.articles.fetch_articles(params)

이 요청은 영어 일색의 보도를 거치게 하는 대신, 일본에 관한 일본어 시장 및 경제 보도를 반환합니다.

이것이 중요한 이유

국가, 분류, 언어를 결합하면 진정으로 지역화된 뷰를 구성할 수 있습니다. 독일 에너지 정책은 독일어로, 일본 시장 동향은 일본어로, 미국 규제는 영어로 말이죠. 글로벌 데스크나 다지역 제품에게 이것은 "진짜 현지 보도"와 "번역된 근사치"의 차이입니다.

다음으로 볼 내용

무료 API 키 받기 →

Back to blog