Enfathom v1.0
Sign Up Login

Quick start

This guide will walk you through the basics of working with the Enfathom API in three core steps:

  1. Find Recent News Mentioning an Entity
  2. Inspect a News Article in Detail

Before getting started,
Sign up to obtain an API key

Making a request


curl -X GET "https://api.enfathom.io/v1/articles/?persons=Einstein" \
  -H "Authorization: Bearer YOUR_API_KEY"

        

curl -X GET "https://api.enfathom.io/v1/articles/?persons=Einstein" ^
  -H "Authorization: Bearer YOUR_API_KEY"
Make sure to replace YOUR_API_KEY with your actual API key

1. Find Recent News That Mentions a Person

With the person name in hand, you can now search for news articles that mention that person. Each article is processed with tone, sentiment, and entity linking data.

Endpoint


https://api.enfathom.io/v1/articles/?persons=Albert%20Einstein&date=2025-04-20

Response


{
  "total_results": 33,
  "total_pages": 2,
  "next_page": "https://api.enfathom.io/v1/articles/?page=2&persons=Albert%20Einstein&date=2025-04-20",
  "previous_page": null,
  "results": [
    {
      "title": "New Theory Builds on Einstein's Work",
      "record_datetime": "2025-04-18T10:30:00Z",
      "article_id": "202504181030-1",
      "url": "https://sciencenews.org/article/new-theory-builds-on-einstein",
      "source": "sciencenews.org",
      "word_count": 773,
      "language": "eng"
    }
  ]
}
Use parameters from and to to define the time range (in YYYY-MM-DD HH:MM with an optional timezone offset)
You can also filter by a single or a list of persons and organizations.

2. Inspect an Article in Detail

Once you've found an article of interest, you can retrieve its full analytical breakdown—including tones, sentiment, and metadata.

Endpoint


https://api.enfathom.io/v1/articles/{article_id}/

Response


{
  "title": "Quantum Leap in AI Research",
  "record_datetime": "2025-05-01T14:20:00Z",
  "article_id": "202505011420-2",
  "url": "https://technews.example.com/2025/05/quantum-leap-in-ai-research",
  "source": "technews.example.com",
  "word_count": 850,
  "language": "eng",
  "tone": {
    "net": 3.14,
    "positive": 3.60,
    "negative": 0.46,
    "polarity": 2.89
  },
  "mentions": {
    "persons": {
      "John Doe": [512]
    },
    "organizations": {
      "OpenAI": [1024]
    },
    "locations": {
      "Silicon Valley, USA": [2048]
    }
  },
  "analysis": [
    {
      "method_id": 5,
      "name": "AI Sentiment Analyzer",
      "metrics": {
        "INNOVATION": 4.5,
        "ETHICS": 3.2,
        "IMPACT": 4.0
      }
    }
  ],
  "themes": {
    "INNOVATION": [768]
  }
}

Recap

Task Endpoint Purpose
Find articles about them /v1/articles/?persons={person_name} Pull related articles
Get article details /v1/articles/{article_id}/ Deep-dive into context and tone
Top