Fact Search

curl -X GET "https://api.factagora.com/api/v1/fact-search?q=bitcoin&limit=5&language=english" \
  -H "Authorization: Bearer fag_your_api_key"

{
  "query": "bitcoin",
  "articles": [
    {
      "title": "Bitcoin surges past $100,000 amid institutional demand",
      "url": "https://reuters.com/...",
      "domain": "reuters.com",
      "publishedAt": "2026-03-29T10:00:00Z",
      "language": "english",
      "sourceCountry": "US",
      "snippet": "Bitcoin hit a new all-time high as institutional investors...",
      "source": "gnews"
    }
  ],
  "meta": {
    "total": 1,
    "executionTimeMs": 312,
    "source": "gnews",
    "cached": false
  }
}

GET

api

fact-search

curl -X GET "https://api.factagora.com/api/v1/fact-search?q=bitcoin&limit=5&language=english" \
  -H "Authorization: Bearer fag_your_api_key"

{
  "query": "bitcoin",
  "articles": [
    {
      "title": "Bitcoin surges past $100,000 amid institutional demand",
      "url": "https://reuters.com/...",
      "domain": "reuters.com",
      "publishedAt": "2026-03-29T10:00:00Z",
      "language": "english",
      "sourceCountry": "US",
      "snippet": "Bitcoin hit a new all-time high as institutional investors...",
      "source": "gnews"
    }
  ],
  "meta": {
    "total": 1,
    "executionTimeMs": 312,
    "source": "gnews",
    "cached": false
  }
}

GNews와 네이버 뉴스를 포함한 전 세계 뉴스 출처에서 최근 기사를 검색합니다. 기사 제목, URL, 게재일, 출처 도메인을 반환합니다.

쿼리 파라미터

string

필수

뉴스 기사 검색 쿼리. 정확한 결과를 얻으려면 핵심 키워드를 사용하세요.

limit

number

기본값:"10"

반환할 결과의 최대 개수. 범위: 1–50.

language

string

출처 언어로 필터링. 예: english, korean

country

string

출처 국가 코드로 필터링. 예: US, KR

sortBy

string

기본값:"relevance"

정렬 순서. 옵션: relevance, date

timespan

string

상대 시간 범위 필터. 예: 7d, 30d, 3months. from 또는 to가 지정되면 무시됩니다.

from

string

날짜 범위 시작 (ISO 8601). 지정 시 timespan보다 우선합니다. 예: 2025-01-01T00:00:00Z

string

날짜 범위 종료 (ISO 8601). 지정 시 timespan보다 우선합니다. 예: 2025-05-01T23:59:59Z

domains

string

포함할 출처 도메인 목록 (쉼표 구분). 해당 도메인의 기사만 반환합니다. 예: bbc.com,reuters.com

source

string

기본값:"default"

검색할 데이터 출처. 옵션:

default: 공개 뉴스 소스만 검색합니다. 기본값이며 기존 동작과 동일합니다.
ingest: 개인 수집 지식 베이스만 검색합니다. 개인 액세스 토큰이 필요합니다.
all: 뉴스와 개인 수집 지식 베이스를 합산하여 검색합니다. 개인 액세스 토큰이 필요합니다.

응답

query

string

사용된 검색 쿼리입니다.

articles

array

뉴스 기사 목록입니다.

표시 Article fields

title

string

기사 제목

url

string

기사 URL

domain

string

출처 도메인

publishedAt

string

게재 일시 (ISO 8601)

language

string

기사 언어

sourceCountry

string

출처 국가 코드

snippet

string

기사 발췌 (선택)

imageUrl

string

기사 이미지 URL (선택)

source

string

gnews 또는 naver

meta

object

표시 Meta fields

total

number

전체 결과 수

executionTimeMs

number

응답 시간(밀리초)

source

string

사용된 데이터 출처 (gnews, naver, mixed)

cached

boolean

캐시에서 응답되었는지 여부

curl -X GET "https://api.factagora.com/api/v1/fact-search?q=bitcoin&limit=5&language=english" \
  -H "Authorization: Bearer fag_your_api_key"

{
  "query": "bitcoin",
  "articles": [
    {
      "title": "Bitcoin surges past $100,000 amid institutional demand",
      "url": "https://reuters.com/...",
      "domain": "reuters.com",
      "publishedAt": "2026-03-29T10:00:00Z",
      "language": "english",
      "sourceCountry": "US",
      "snippet": "Bitcoin hit a new all-time high as institutional investors...",
      "source": "gnews"
    }
  ],
  "meta": {
    "total": 1,
    "executionTimeMs": 312,
    "source": "gnews",
    "cached": false
  }
}

인증

Fact Checker

개요

Intelligence APIs

Best Practices

쿼리 파라미터

응답

​쿼리 파라미터

​응답

쿼리 파라미터

응답