이 페이지는 기계 번역되었습니다. 영어 버전이 원본이며 더 정확하거나 최신일 수 있습니다. 영어로 보기

고급 쿼리 작성

finlight.me API로 작업할 때, 고급 쿼리 작성 기법을 통해 필요한 데이터를 정확히 검색할 수 있습니다. 이 가이드는 데이터 검색 과정을 최적화하는 데 도움이 되도록 복잡한 필터링, 정렬, 페이지네이션 방법을 단계별로 안내합니다.

대시보드 - API 테스터를 사용하여 API에 빠르게 접근하고 쿼리를 테스트하세요.

언어 및 다국어 범위

finlight는 여러 언어의 뉴스를 색인하지만, 각 요청은 하나의 언어로 필터링됩니다. language 매개변수의 기본값은 **en**이므로, 설정하지 않으면 영어 기사만 받게 되며 — 다른 언어의 콘텐츠는 조용히 제외됩니다.

중요: language의 기본값은 en입니다. language 없는 요청은 영어만 반환합니다. 다른 언어로 게시된 기사(예: 많은 중국어 매체, zh)는 해당 언어를 명시적으로 요청하지 않는 한 반환되지 않습니다.

작동 방식

  • 기사 수준, 정확 일치. language는 각 기사의 ISO 639-1 코드를 정확 일치로 필터링합니다. language=en은 en 기사만 반환하고 de, zh 등은 절대 반환하지 않습니다.
  • 요청당 하나의 언어. language는 단일 값을 받습니다 — 배열/쉼표 목록은 지원되지 않으며 "모든 언어" 옵션도 없습니다. 여러 언어를 다루려면 언어당 하나의 요청을 보내고 결과를 병합하세요.
  • 출처는 다국어일 수 있습니다. 단일 출처가 둘 이상의 언어로 게시할 수 있습니다. 필터는 출처가 아니라 기사의 언어로 선택합니다. 매체의 비영어 기사는 해당 언어를 요청할 때만 표시됩니다.

예시

기본값(영어만) — 동일:

query=Alibaba
query=Alibaba&language=en

중국어 범위:

query=Alibaba&language=zh

영어 + 중국어 다루기 — 두 요청 후 병합:

query=Alibaba&language=en
query=Alibaba&language=zh

팁: ISO 639-1 코드(en, de, fr, zh 등)를 사용하세요. finlight의 기본 출처 세트는 여러 언어에 걸쳐 있습니다 — 영어는 기본 필터일 뿐, 범위의 한계가 아닙니다.

쿼리 필터링

query 매개변수는 유연한 키워드 기반 로직 과 필드 수준의 정밀도를 가능하게 합니다. 이제 ticker, exchange, isin, source, openfigi 등 특정 필드를 대상으로 할 수 있습니다.

기본 키워드 사용

단일 키워드:

query=Nvidia stock

정확한 구문: 정확한 일치를 검색하려면 구문을 큰따옴표로 묶으세요.

query="Elon Musk"

연산자를 이용한 포함 / 제외

포함(+) 및 제외(-) 강제:

+로 필수/포함하고, -로 용어 또는 필드별 값을 제외합니다.

query=stock +market -google

이는 "stock"과 "market"을 포함하는 기사를 반환하지만, "google"을 언급하는 기사는 제외합니다.

필드 수준 필터링

참고: 이는 query 매개변수 내에서 직접 특정 필드를 기준으로 결과를 필터링할 수 있게 하는 강력한 새 기능입니다.

이제 query 매개변수에서도 field:value 구문을 사용하여 특정 필드를 직접 쿼리할 수 있습니다. 이를 통해 더 정밀하고 복잡한 쿼리가 가능하며, 티커 심볼, 거래소, ISIN, 출처 등 특정 속성을 기준으로 결과를 필터링할 수 있습니다.

✨ 신규: source, ticker, exchange 필드에 와일드카드 *를 사용하여 모든 값에 일치시키세요(예: source:*, ticker:*, exchange:*).

지원되는 필드

  • ticker(와일드카드 * 지원)

  • isin

  • title

  • summary

  • content

  • openfigi

  • exchange(와일드카드 * 지원)

    • 모든 거래소는 MIC(시장 식별 코드) 표준입니다. 지원되는 코드는 다음과 같습니다: ASEX, BVCA, BVMF, DSMD, HSTC, XSTC, MISX, NEOE, PFTS, ROCO, XADS, XAMM, XAMS, XASX, XBAH, XBEL, XBEY, XBKK, XBOG, XBOM, XBOT, XBRA, XBRU, XBSE, XBUD, XBUE, XBUL, XCAS, XCNQ, XCOL, XCSE, XCYS, XDAR, XDFM, XDHA, XDUS, XETR, XFKA, XFRA, XGHA, XHAM, XHEL, XHKG, XICE, XIDX, XIST, XJAM, XJSE, XKAR, XKAZ, XKLS, XKOR, XKUW, XLIM, XLIS, XLIT, XLJS, XLUS, XLUX, XMAL, XMAU, XMEX, XMIL, XMSW, XMUN, XNAI, XNAM, XNAS, XNGM, XNGO, XNSA, XNSE, XNYS, XASE, XOSL, XPAR, XPHS, XPRA, XRIS, XSAP, XSAU, XSES, XSCA, XSGO, XSHE, XSHG, XKRX, XSTU, XSWX, XTAE, XTAI, XTAL, XTSE, XTSX, XTUN, XUBS, XUGA, XWAR, XWBO, XZAG, XZIM, XSTO, OTCM, BMEX, XDUB, XJPX, BCXE, XPAE, XLON, XMUS, XNZE, XCAI, XBRV

  • country

    • ISO 3166-1 alpha-2 국가 코드를 사용하여 회사 국가로 필터링합니다(예: US, GB, DE, JP, CN, FR, CA, AU, IN, BR 등)

  • category

    • 기사 카테고리로 필터링합니다. 가능한 값: markets, economy, business, politics, geopolitics, regulation, technology, energy, commodities, crypto, health, climate, security

  • source(와일드카드 * 지원)

와일드카드 지원

와일드카드 *를 사용하면 쿼리에 모든 출처, 티커, 거래소를 명시적으로 포함할 수 있습니다. 이는 광범위한 범위를 보장하거나 다른 필터와 결합할 때 특히 유용합니다.

예시:

query=source:*

사용 가능한 모든 출처의 기사를 반환합니다.

query=ticker:* country:US

미국 회사의 모든 티커에 대한 기사를 반환합니다.

query=exchange:* -crypto

암호화폐 콘텐츠를 제외하고 모든 거래소의 기사를 반환합니다.

필드 필터 예시

API 테스터에서 작동 방식을 확인하고 자신만의 복잡한 쿼리를 쉽게 만들어 보세요.

정확한 출처로 필터링:

query=source:www.some-source.de

출처 제외:

query=-source:www.some-source.de

특정 티커를 요구하고 일부 출처 제외:

query=ticker:AAPL -source:www.some-source.de

콘텐츠가 "earnings"를 언급하고 거래소가 NASDAQ인 결과 찾기:

query=content:earnings exchange:nasdaq

특정 국가의 회사로 필터링:

query=country:US

독일 회사에 대한 뉴스를 찾되 Schulden 제외:

query=country:DE -Schulden

국가와 티커 필터링 결합:

query=country:US ticker:NVD

필드 필터링과 일반 검색 결합:

query="quarterly report" source:www.some-source.com -crypto

불리언 연산자

참고: 단어는 기본적으로 AND로 결합되므로, OR이나 NOT과 결합하려는 경우가 아니면 AND를 명시적으로 사용할 필요가 없습니다.

AND / OR / NOT 로직이 완전히 지원됩니다:

query=stock AND google
query=amazon OR google
query=market AND NOT bitcoin

그룹화에는 괄호 사용: 고급 필터링을 위해 논리 표현식을 결합하세요.

query=("Elon Musk") AND (twitter OR tesla)

강력한 쿼리를 위해 와일드카드와 결합:

query=ticker:* AND (country:US OR country:GB) -crypto
query=source:* exchange:XNAS

💡 고급 사용자를 위한 팁

  • 필드 필터는 필수 값과 제외 값에 대해 +와 -를 지원합니다.
  • **와일드카드 ***는 source, ticker, exchange 필드와 함께 사용하여 모든 값에 일치시킬 수 있습니다.
  • 고도로 타기팅된 쿼리를 위해 여러 필드와 키워드를 결합할 수 있습니다.
  • AND, OR, NOT 같은 불리언 연산자는 대소문자를 구분하지 않습니다.
  • 괄호 ()는 복잡한 쿼리에서 우선순위 제어에 도움이 됩니다.
  • 부분 일치를 피하려면 여러 단어로 된 구문을 큰따옴표 "로 묶으세요.

결론 - 모두 결합하기

예시: 신뢰할 수 있는 출처에서 암호화폐가 아닌 테슬라(ticker:TSLA) 뉴스를 원하시나요?

query=+ticker:TSLA -crypto AND (+source:www.bloomberg.com OR +source:www.reuters.com)

예시: Bloomberg에서 테슬라(ticker:TSLA) 또는 애플(ticker:AAPL) 뉴스를 원하시나요?

query=source:www.bloomberg.com AND ticker:TSLA OR source:www.bloomberg.com AND ticker:APPL

예시: NASDAQ에 상장된 미국 회사에 대한 뉴스를 원하되 암호화폐 콘텐츠는 제외하시나요?

query=country:US exchange:XNAS -crypto

예시: 실적 언급이 있는 유럽 기술 기업(독일, 프랑스 또는 영국) 뉴스를 원하시나요?

query=earnings AND (country:DE OR country:FR OR country:GB)

예시: 암호화폐를 제외하고 모든 출처에서 모든 티커 관련 뉴스를 원하시나요?

query=ticker:* source:* -crypto

API 테스터에서 작동 방식을 확인하고 자신만의 복잡한 쿼리를 쉽게 만들어 보세요.

Raw WebSocket 쿼리 필드

Raw WebSocket은 간소화된 데이터 모델에 맞춰진 필드 수준 필터의 하위 집합을 지원합니다. 보강된 WebSocket 및 REST API와 달리, Raw WebSocket은 티커, 거래소 또는 회사 관련 필드 필터를 지원하지 않습니다.

지원되는 필드

  • source - 기사 출처 도메인으로 필터링
  • title - 기사 제목 내용으로 필터링
  • summary - 기사 요약 내용으로 필터링

예시

제목 내용으로 필터링:

query=title:Nvidia

제목과 요약 필터 결합:

query=summary:earnings +title:Tesla

출처로 필터링하고 키워드 제외:

query=source:www.reuters.com -crypto

여러 필드 필터를 불리언 연산자로 결합:

query=title:Apple AND summary:revenue

참고: 표준 쿼리 연산자(+, -, AND, OR, NOT, 괄호, 큰따옴표)는 모두 Raw WebSocket 필드 필터와 함께 작동합니다.

도움이 필요하신가요?

막히거나 궁금한 점이 있거나 개선할 부분이 보이면 주저하지 말고 연락해 주세요. 여러분의 연락을 기다리며 finlight.me API와 함께하는 성공을 지원하겠습니다.