보강된 Webhook

보강된 Webhook은 회사 엔티티 해석, 감성 분석, 전체 필터링 옵션 집합이 포함된 AI 처리 기사 데이터를 전송합니다.

보강된 Webhook의 주요 기능:

전체 필터링 — 티커, 국가, 카테고리, 출처, 언어, query로 필터링
AI 보강 — 페이로드에 감성 점수, 회사 매칭, 신뢰도 값이 포함됨
유연한 콘텐츠 — includeContent / includeEntities로 전체 기사 텍스트와 추출된 엔티티를 선택적으로 포함
변경 불가 유형 — 전송 유형(enriched 또는 raw)은 생성 시 설정되며 이후 변경할 수 없음

기사 모델

보강된 Webhook은 AI 생성 회사 데이터, 감성 분석, 엔티티 해석을 포함한 전체 기사 페이로드를 전송합니다.

Name
link
Type
string
Description
전체 기사로의 URL.
Name
source
Type
string
Description
출처 웹사이트. 예: www.reuters.com
Name
title
Type
string
Description
기사 제목.
Name
summary
Type
string
Description
기사 요약(있는 경우). null일 수 있습니다.
Name
publishDate
Type
Date
Description
게시 날짜(ISO 8601 날짜 문자열).
Name
createdAt
Type
Date
Description
finlight 시스템에서 기사의 내부 생성 날짜(ISO 8601 날짜 문자열).
Name
revisedDate
Type
Date | null
Description
최초 게시 이후 기사가 마지막으로 수정된 날짜. 기사가 한 번도 수정되지 않은 경우 null. includeUpdates가 활성화되고 기사가 수정된 경우에 존재합니다.
Name
isUpdate
Type
boolean
Description
이 전송이 게시 후 업데이트에 의해 트리거된 경우 true. includeUpdates가 활성화된 경우에만 존재합니다.
Name
language
Type
string
Description
ISO 639-1 언어 코드. 예: en | de | fr
Name
sentiment
Type
string
Description
AI가 생성한 기사 감성. 가능한 값: positive | negative | neutral.
Name
confidence
Type
number
Description
감성 값에 대한 신뢰도 점수(0~1).
Name
images
Type
string[]
Description
기사의 이미지 URL 배열.
Name
countries
Type
string[]
Description
ISO 3166-1 alpha-2 형식의 국가 코드 배열. 예: ["US", "GB"]. 비어 있을 수 있습니다.
Name
categories
Type
string[]
Description
기사 카테고리 배열. 가능한 값: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security. 비어 있을 수 있습니다.
Name
companies
Type
Company[]
Description
AI 엔티티 매칭으로 해석된, 일치하는 회사 객체 배열. 각 회사에는 다음 필드가 포함됩니다:
- companyId number — finlight 내부 회사 식별자
- confidence string — 엔티티 매칭 신뢰도 점수
- name string — 회사 전체 이름
- ticker string — 주요 티커 심볼. 예: AAPL
- exchange string — 거래소 코드. 예: XNAS
- country string — 주요 상장 국가(ISO 3166-1 alpha-2)
- sector string — 섹터 분류. 예: Technology
- industry string — 산업 분류
- isin string — 주요 ISIN 코드
- openfigi string — OpenFIGI 식별자
- primaryListing object — { ticker, exchangeCode, exchangeCountry }
- isins string[] — 회사의 알려진 모든 ISIN
- otherListings object[] — [{ ticker, exchangeCode, exchangeCountry }]

WEBHOOK전송 유형

보강된 Webhook 만들기

finlight 대시보드에서 webhook을 만들 때 설정 마법사의 첫 단계에서 전송 유형으로 Enriched를 선택하세요. 이것이 기본 옵션입니다. 기준 단계에는 사용 가능한 모든 필터 매개변수가 표시됩니다.

보강된 Webhook은 귀하의 기준에 맞는 새로 게시된 기사만 전송합니다. 각 전송은 HTTP POST 요청으로 엔드포인트에 전송되는 단일 기사 페이로드입니다.

Name
query
Type
string
Description
관련 기사를 찾기 위한 검색 쿼리. 불리언 연산자와 필드 수준 필터링을 지원합니다. 고급 쿼리 작성 가이드를 참조하세요.
Name
sources
Type
string[]
Description
전송을 특정 출처의 기사로 제한합니다. 예: ["www.reuters.com", "www.cnbc.com"].
Name
excludeSources
Type
string[]
Description
특정 출처의 기사를 제외합니다. 예: ["www.example.com"].
Name
language
Type
string
Description
기사 언어로 필터링합니다(ISO 639-1). 기본값은 en으로, 영어만 반환하고 다른 언어는 제외합니다 — 언어 및 범위를 참조하세요.
Name
tickers
Type
string[]
Description
티커 심볼로 필터링합니다. AI 엔티티 해석으로 이 회사들과 매칭된 기사만 전송됩니다. 예: ["AAPL", "GOOGL", "TSLA"].
Name
countries
Type
string[]
Description
국가 코드로 필터링합니다(ISO 3166-1 alpha-2). 이 국가의 회사와 매칭된 기사만 전송됩니다. 예: ["US", "GB", "DE"].
Name
categories
Type
string[]
Description
기사 카테고리로 필터링합니다. 가능한 값: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security.
Name
includeContent
Type
boolean
Description
기사 본문 전체 텍스트를 페이로드에 포함합니다. 전체 기사 액세스가 포함된 플랜이 필요합니다.
Name
includeEntities
Type
boolean
Description
기사에서 발견된 추출 엔티티(회사, 인물, 위치)를 포함합니다.
Name
excludeEmptyContent
Type
boolean
Description
요약이 비어 있지 않은 기사만 전송합니다. 저품질 기사를 걸러내는 데 유용합니다.
Name
includeUpdates
Type
boolean
Description
기사가 최초 게시 후 업데이트될 때 다시 전송합니다. 업데이트된 페이로드에는 isUpdate=true와 revisedDate 타임스탬프가 포함됩니다.

Response

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs",
  "summary": "A brief summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "language": "en",
  "sentiment": "positive",
  "confidence": 0.95,
  "images": [
    "https://www.example.com/image1.jpg",
    "https://www.example.com/image2.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets", "health"],
  "companies": [
    {
      "companyId": 41494,
      "confidence": "0.9335401058197021",
      "country": "US",
      "exchange": "XNAS",
      "industry": "Biotechnology: Pharmaceutical Preparations",
      "name": "Summit Therapeutics Inc. Common Stock",
      "sector": "Health Care",
      "ticker": "SMMT",
      "isin": "US86627T1088",
      "openfigi": "BBG01PH11VP5",
      "primaryListing": {
        "ticker": "SMMT",
        "exchangeCode": "XNAS",
        "exchangeCountry": "US"
      },
      "isins": ["US86627T1088", "US86627T2088"],
      "otherListings": [
        {
          "ticker": "SMMT.L",
          "exchangeCode": "XLON",
          "exchangeCountry": "GB"
        }
      ]
    }
  ]
}

Response (includeUpdates: true)

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs — Updated",
  "summary": "An updated summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "revisedDate": "2023-10-02T08:00:00Z",
  "isUpdate": true,
  "language": "en",
  "sentiment": "positive",
  "confidence": 0.95,
  "images": [
    "https://www.example.com/image1.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"],
  "companies": []
}

EXAMPLES결합 필터

필터링 예시

보강된 Webhook은 모든 필터 매개변수의 조합을 지원합니다. 일반적인 패턴은 다음과 같습니다:

회사 리서치 피드:

tickers: ["AAPL", "GOOGL"]
sources: ["www.reuters.com", "www.bloomberg.com"]
includeEntities: true

속보 시장 뉴스:

query: "earnings OR revenue OR guidance"
categories: ["markets", "economy"]
language: "en"

지역별 섹터 집중:

countries: ["US", "CA"]
query: "tech OR technology OR semiconductor"
tickers: ["NVDA", "TSMC", "AMD"]

유럽 금융 뉴스:

countries: ["GB", "DE", "FR"]
sources: ["www.reuters.com", "www.ft.com"]
language: "en"

쿼리 구문은 불리언 연산자, 따옴표로 묶은 구문, 제외를 지원합니다:

"Apple earnings"                           simple phrase
(Apple OR iPhone) AND (earnings OR revenue)  boolean groups
Tesla NOT recall                           exclusion

쿼리 구문의 전체 참조는 고급 쿼리 작성 가이드를 참조하세요.

GUIDE결정 도움말

보강된 Webhook을 사용해야 할 때

다음의 경우 Enriched를 선택하세요:

회사/티커 수준의 필터링이 필요한 경우(tickers, countries, categories)
페이로드에 감성 점수, 신뢰도 값 또는 엔티티 해석이 필요한 경우
includeContent / includeEntities를 통해 전체 기사 내용이나 추출된 엔티티를 포함해야 하는 경우
주식 모니터링, 실적 추적 또는 섹터별 뉴스 피드를 구축하는 경우

다음의 경우 Raw를 선택하세요:

가능한 한 낮은 전송 지연이 필요한 경우
보강 데이터가 필요 없는 고처리량 파이프라인을 구축하는 경우
키워드, 출처, 언어로만 필터링하면 되는 경우
자체 처리 오버헤드를 줄이기 위해 더 가벼운 페이로드를 원하는 경우

원시 Webhook 필터링 옵션에 대한 자세한 내용은 원시 Webhook 가이드를 참조하세요.