DeepStamp Embed

curl -X POST "https://api.factagora.com/api/v1/fingerprint/embed" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The European Central Bank raised interest rates by 25 basis points on Thursday, citing persistent core inflation in the eurozone.",
    "content_type": "news",
    "metadata": {
      "author_id": "editor_jane",
      "published_at": "2024-06-15T08:00:00Z",
      "source_id": "article_12345"
    }
  }'

{
  "watermarked_content": "The European Central Bank raised interest rates by 25 basis points...",
  "fingerprint_id": "fp_l1p8OPCwGhvu",
  "tkg_snapshot": {
    "entities": ["European Central Bank", "Interest rate", "Goldman Sachs"],
    "timeseries": ["2024-06-15"],
    "relations": [
      { "from": "European Central Bank", "rel": "raises", "to": "Interest rate" }
    ],
    "argument_map": [
      {
        "premise": "Persistent core inflation in the eurozone",
        "evidence": "ECB policy meeting decision",
        "conclusion": "Interest rates raised by 25 basis points"
      }
    ]
  },
  "embed_timestamp": "2024-06-15T08:01:23.456Z",
  "meta": { "executionTimeMs": 1234 }
}

POST

api

fingerprint

embed

curl -X POST "https://api.factagora.com/api/v1/fingerprint/embed" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The European Central Bank raised interest rates by 25 basis points on Thursday, citing persistent core inflation in the eurozone.",
    "content_type": "news",
    "metadata": {
      "author_id": "editor_jane",
      "published_at": "2024-06-15T08:00:00Z",
      "source_id": "article_12345"
    }
  }'

{
  "watermarked_content": "The European Central Bank raised interest rates by 25 basis points...",
  "fingerprint_id": "fp_l1p8OPCwGhvu",
  "tkg_snapshot": {
    "entities": ["European Central Bank", "Interest rate", "Goldman Sachs"],
    "timeseries": ["2024-06-15"],
    "relations": [
      { "from": "European Central Bank", "rel": "raises", "to": "Interest rate" }
    ],
    "argument_map": [
      {
        "premise": "Persistent core inflation in the eurozone",
        "evidence": "ECB policy meeting decision",
        "conclusion": "Interest rates raised by 25 basis points"
      }
    ]
  },
  "embed_timestamp": "2024-06-15T08:01:23.456Z",
  "meta": { "executionTimeMs": 1234 }
}

DeepStamp proves that a piece of content originated from you, even after it has been rewritten or translated. Embedding extracts a Temporal Knowledge Graph (TKG) from your content and hides a watermark seeded by that structure.

DeepStamp is the product name; the API paths still say fingerprint. Endpoints are /api/v1/fingerprint/embed and /api/v1/fingerprint/detect, and responses return fingerprint_id. There is no /api/v1/deepstamp/* endpoint.

POST /api/v1/fingerprint/embed

Request Body

Provide either content or url, not both.

string

Raw text to fingerprint. Maximum 50,000 characters.

string

URL of the source document to fingerprint.

string

default:"news"

Category of the content. One of news, report, legal, internal. This also selects the default scoring weights used at detection time.

object

Your own identifiers, stored with the fingerprint and echoed back on every match.

Show Metadata fields

string

Internal author identifier

string

ISO 8601 publish timestamp

string

Upstream source identifier, such as a CMS article id

curl -X POST "https://api.factagora.com/api/v1/fingerprint/embed" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The European Central Bank raised interest rates by 25 basis points on Thursday, citing persistent core inflation in the eurozone.",
    "content_type": "news",
    "metadata": {
      "author_id": "editor_jane",
      "published_at": "2024-06-15T08:00:00Z",
      "source_id": "article_12345"
    }
  }'

Response

string

Your content with the TKG-seeded zero-width watermark embedded. Distribute this version, not the original.

string

Unique fingerprint identifier (fp_*). Store it alongside your internal article id.

object

The structure extracted from your content.

Show Snapshot fields

array

Distinct entities found in the content

array

Normalized time anchors (YYYY, YYYY-MM, or YYYY-MM-DD)

array

Causal or temporal relations as from / rel / to triples

array

Premise → evidence → conclusion chains

string

ISO 8601 timestamp of when the fingerprint was embedded.

{
  "watermarked_content": "The European Central Bank raised interest rates by 25 basis points...",
  "fingerprint_id": "fp_l1p8OPCwGhvu",
  "tkg_snapshot": {
    "entities": ["European Central Bank", "Interest rate", "Goldman Sachs"],
    "timeseries": ["2024-06-15"],
    "relations": [
      { "from": "European Central Bank", "rel": "raises", "to": "Interest rate" }
    ],
    "argument_map": [
      {
        "premise": "Persistent core inflation in the eurozone",
        "evidence": "ECB policy meeting decision",
        "conclusion": "Interest rates raised by 25 basis points"
      }
    ]
  },
  "embed_timestamp": "2024-06-15T08:01:23.456Z",
  "meta": { "executionTimeMs": 1234 }
}

Detection is covered in DeepStamp Detect.

Overview

Endpoints

Best Practices

POST /api/v1/fingerprint/embed

Request Body

Response

​POST /api/v1/fingerprint/embed

​Request Body

​Response

POST /api/v1/fingerprint/embed

Request Body

Response