DeepStamp Detect

curl -X POST "https://api.factagora.com/api/v1/fingerprint/detect" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "ECB hiked rates 25bp Thursday due to stubborn inflation.",
    "top_k": 5,
    "min_score": 0.3
  }'

{
  "match_found": true,
  "confidence_score": 0.87,
  "query_fingerprint_id": "fp_tmpQueryId01",
  "matches": [
    {
      "fingerprint_id": "fp_l1p8OPCwGhvu",
      "content_type": "news",
      "metadata": { "author_id": "editor_jane", "source_id": "article_12345" },
      "embed_timestamp": "2024-06-15T08:01:23.456Z",
      "score": 0.87,
      "similarity_breakdown": {
        "entity_match": 0.92,
        "timeseries_match": 1.0,
        "causal_pattern_match": 0.78
      },
      "overlap": {
        "entities": ["european central bank", "interest rate", "goldman sachs"],
        "timeseries": ["2024-06-15"],
        "relations": ["european central bank|raises|interest rate"]
      },
      "watermark_match": false,
      "watermark_correlation": null
    }
  ],
  "meta": {
    "scanned": 156,
    "executionTimeMs": 342,
    "weights": { "entity": 0.5, "time": 0.2, "causal": 0.3 },
    "watermark_detected": false
  }
}

POST

api

fingerprint

detect

curl -X POST "https://api.factagora.com/api/v1/fingerprint/detect" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "ECB hiked rates 25bp Thursday due to stubborn inflation.",
    "top_k": 5,
    "min_score": 0.3
  }'

{
  "match_found": true,
  "confidence_score": 0.87,
  "query_fingerprint_id": "fp_tmpQueryId01",
  "matches": [
    {
      "fingerprint_id": "fp_l1p8OPCwGhvu",
      "content_type": "news",
      "metadata": { "author_id": "editor_jane", "source_id": "article_12345" },
      "embed_timestamp": "2024-06-15T08:01:23.456Z",
      "score": 0.87,
      "similarity_breakdown": {
        "entity_match": 0.92,
        "timeseries_match": 1.0,
        "causal_pattern_match": 0.78
      },
      "overlap": {
        "entities": ["european central bank", "interest rate", "goldman sachs"],
        "timeseries": ["2024-06-15"],
        "relations": ["european central bank|raises|interest rate"]
      },
      "watermark_match": false,
      "watermark_correlation": null
    }
  ],
  "meta": {
    "scanned": 156,
    "executionTimeMs": 342,
    "weights": { "entity": 0.5, "time": 0.2, "causal": 0.3 },
    "watermark_detected": false
  }
}

탐지는 숨겨진 워터마크와 텍스트의 인과 구조를 함께 사용해, 후보 콘텐츠를 저장된 모든 fingerprint와 대조합니다. 단어가 전부 바뀌어도 재사용을 잡아냅니다.

DeepStamp는 제품명이고, API 경로는 아직 fingerprint입니다. 엔드포인트는 /api/v1/fingerprint/embed와 /api/v1/fingerprint/detect이며 응답에도 fingerprint_id가 사용됩니다. /api/v1/deepstamp/* 엔드포인트는 없습니다.

POST /api/v1/fingerprint/detect

요청 본문

content, url, fingerprint_id 중 정확히 하나만 보냅니다. content와 url로 들어온 질의는 즉시 추출만 하고 저장하지 않습니다.

string

검사할 원문 텍스트. 보통 확인하려는 기사 본문입니다. 최대 50,000자.

string

검사할 문서의 URL.

string

이미 삽입해 둔 fingerprint id(fp_*)를 다시 채점합니다. 저장된 스냅샷을 재사용하므로 재추출이 없고, 주기적인 모니터링에 가장 저렴한 방식입니다.

number

기본값:"5"

반환할 매칭 개수. 범위: 1–50.

number

기본값:"0.3"

결과에 포함될 최소 종합 점수입니다. 공통 신호가 전혀 없는 후보는 이 값과 무관하게 항상 제외됩니다. match_found는 두 조건을 모두 통과한 매칭이 하나 이상일 때만 true입니다.

number

기본값:"1000"

최신순으로 훑을 저장된 fingerprint의 최대 개수. 범위: 1–5000.

object

사용자 지정 가중치. entity, time, causal의 합이 1.0이어야 합니다. 생략하면 content_type별 기본값이 적용됩니다. news 0.5 / 0.2 / 0.3, legal 0.3 / 0.1 / 0.6, report 0.4 / 0.3 / 0.3, internal 0.5 / 0.2 / 0.3.

object

대조할 fingerprint 범위를 좁힙니다.

표시 Filter fields

string

해당 작성자의 fingerprint만

string

embed_timestamp 하한(YYYY-MM-DD, 포함)

string

embed_timestamp 상한(YYYY-MM-DD, 포함)

string

특정 content_type만

curl -X POST "https://api.factagora.com/api/v1/fingerprint/detect" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "ECB hiked rates 25bp Thursday due to stubborn inflation.",
    "top_k": 5,
    "min_score": 0.3
  }'

응답

boolean

min_score를 통과한 후보가 하나 이상이면 true입니다.

number

최상위 매칭의 종합 점수입니다. 매칭이 없으면 0.

string

질의의 fingerprint id입니다. content나 url 질의의 경우 즉시 추출 과정에서 발급된 값이며 저장되지 않습니다.

array

종합 점수 내림차순으로 정렬된 상위 K개 후보입니다.

표시 Match fields

string

매칭된 fingerprint id

string

삽입 시점에 기록된 content_type

object

삽입 시점에 저장된 metadata. null일 수 있음

string

해당 후보가 fingerprint된 시각

number

가중 종합 점수

object

신호별 점수: entity_match, timeseries_match, causal_pattern_match

object

점수의 근거가 된 공통 개체·시점·from|rel|to 관계 목록

boolean

입력에 이 후보와 85% 이상 일치하는 워터마크가 있으면 true. 사실상 확정적인 출처 증거

number

비트 단위 상관도. 워터마크가 없으면 null

object

표시 Meta fields

number

필터 적용 후 실제로 채점된 fingerprint 수

number

응답 시간(밀리초)

object

이번 요청에 실제 적용된 가중치

boolean

입력에서 워터마크를 찾아 저장된 fingerprint와 일치했으면 true

{
  "match_found": true,
  "confidence_score": 0.87,
  "query_fingerprint_id": "fp_tmpQueryId01",
  "matches": [
    {
      "fingerprint_id": "fp_l1p8OPCwGhvu",
      "content_type": "news",
      "metadata": { "author_id": "editor_jane", "source_id": "article_12345" },
      "embed_timestamp": "2024-06-15T08:01:23.456Z",
      "score": 0.87,
      "similarity_breakdown": {
        "entity_match": 0.92,
        "timeseries_match": 1.0,
        "causal_pattern_match": 0.78
      },
      "overlap": {
        "entities": ["european central bank", "interest rate", "goldman sachs"],
        "timeseries": ["2024-06-15"],
        "relations": ["european central bank|raises|interest rate"]
      },
      "watermark_match": false,
      "watermark_correlation": null
    }
  ],
  "meta": {
    "scanned": 156,
    "executionTimeMs": 342,
    "weights": { "entity": 0.5, "time": 0.2, "causal": 0.3 },
    "watermark_detected": false
  }
}

삽입은 DeepStamp Embed에서 다룹니다.

개요

Endpoints

Best Practices

POST /api/v1/fingerprint/detect

요청 본문

응답

​POST /api/v1/fingerprint/detect

​요청 본문

​응답

POST /api/v1/fingerprint/detect

요청 본문

응답