Skip to main content
Get your free API key — You get 100 welcome API Credits for free. No credit card required. Get started

​
Step 1: Login

Sign in or create a free account at Login. No credit card required — you get 100 welcome credits automatically.

​
Step 2: Get your API key

Navigate to Settings → API Keys and generate a new API key. Your API key will look like this: 
fct_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Keep your API key secret. Do not expose it in client-side code or public repositories.

​
Step 3: Make your first request

Use the News Search API to search for recent news articles. 
curl -X GET "https://api.factagora.com/api/v1/news/search?q=artificial+intelligence" \
  -H "Authorization: Bearer fct_your_api_key"

​
Step 4: Understand the response

A successful response returns a list of news articles with metadata: 
{
  "articles": [
    {
      "title": "OpenAI releases new model",
      "url": "https://example.com/article",
      "source": "TechCrunch",
      "publishedAt": "2025-03-30T12:00:00Z",
      "summary": "OpenAI has announced..."
    }
  ],
  "total": 42
}

​
Step 5: Fingerprint your content

Protect your content by embedding an invisible watermark. The Fingerprint API extracts a TKG (Temporal Knowledge Graph) and embeds a zero-width Unicode watermark seeded by the content’s causal structure. 
curl -X POST "https://api.factagora.com/api/v1/fingerprint/embed" \
  -H "Authorization: Bearer fct_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The Bank of Korea raised interest rates by 25 basis points, citing persistent inflation.",
    "content_type": "news"
  }'
The response includes watermarked_content (distribute this instead of the original), fingerprint_id (store this for later detection), and a tkg_snapshot showing the extracted entities, timelines, and argument chains. Later, when you encounter suspicious content, use /fingerprint/detect to check it: 
curl -X POST "https://api.factagora.com/api/v1/fingerprint/detect" \
  -H "Authorization: Bearer fct_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"content": "Korea central bank hiked rates 25bp due to inflation concerns."}'
Even though the wording is completely different, the API matches the underlying causal structure and returns the original fingerprint_id with a confidence score. See the Fingerprint Guide for the full walkthrough.

​
Next steps

That’s all it takes to start using Factagora’s API! To go further, explore the full list of available endpoints and parameters on our API Reference page. You can also learn about Credits & Pricing to understand how usage is measured, or check Rate Limits to ensure your integration stays within limits.