← Back to app

Methodology

How News Lens works. No black boxes. Full transparency.

1. Our Philosophy

News Lens exists to make news framing visible. We believe that understanding how a story is told is as important as understanding what happened.

We deliberately avoid making judgments about accuracy, bias, or trustworthiness. These are complex assessments that require context we don't have. Instead, we focus on showing you the raw material: the same event, covered by different sources, with different framings.

Our commitment: Every signal we surface is mechanically detectable, objectively defined, and fully inspectable. If you disagree with how we've tagged something, you can see exactly why we tagged it.

2. Source Selection

We track 33 news sources across 5 regions. Our selection criteria:

Each source is labeled with its editorial positioning: a brief, factual description of the outlet's ownership, funding model, and general editorial stance. These labels are not judgments; they're context.

Sources by Region

United States 6 sources

New York Times
Center-left editorial. Establishment US perspective.
Wall Street Journal
Business-focused. Center-right editorial.
Washington Post
Center-left. DC insider perspective.
Fox News
Right-leaning. Conservative US perspective.
CNN
Center-left. Breaking news focus.
Politico
Policy and politics focused. DC establishment.

Europe 7 sources

BBC News
UK public broadcaster. Global perspective.
The Guardian
Left-leaning. Progressive editorial stance.
The Telegraph
Right-leaning. UK conservative.
Deutsche Welle
German public broadcaster. EU perspective.
France 24
French state-funded. Francophone focus.
Der Spiegel
German newsmagazine. Investigative focus.
AFP (via partners)
French wire service. European perspective.

Full source list with RSS feeds and positioning notes available in our public data repository.

3. Story Clustering

We group articles about the same event using semantic similarity of headlines. Here's how it works:

  1. Ingestion: We poll RSS feeds every 15 minutes
  2. Embedding: Each headline is converted to a vector representation
  3. Matching: New articles are compared against recent clusters
  4. Clustering: Articles above a similarity threshold are grouped together

Parameters

Parameter Value Explanation
similarity_threshold 0.65 Minimum cosine similarity to join a cluster
time_window 48 hours Clusters older than this are harder to match
decay_factor 0.1 Similarity penalty per day for old clusters

Limitation: Clustering is imperfect. Articles about related but distinct events may be incorrectly grouped. Articles with very different headlines about the same event may end up in separate clusters. We're continuously improving.

4. Framing Tags

We detect 10 mechanical framing signals in each article. These are objective, detectable patterns, not subjective judgments about quality or bias.

Tag What We Detect
Quotes Government Article cites government officials, ministers, or spokespersons
Quotes Opposition Article includes critics, opposition leaders, or dissenting voices
Mentions Casualties Article reports deaths, injuries, or casualties
Cites Data Article includes specific numbers, percentages, or statistics
Cites Document Article references a specific report, filing, or primary source
Historical Context Article provides background or timeline information
Expert Quote Article quotes academics, analysts, or researchers
Future Speculation Article predicts or speculates about future outcomes
International Reaction Article includes responses from other countries
Economic Impact Article discusses financial or economic consequences

Detection Method

Tags are detected using a combination of:

Each tag includes a confidence score (0-1) based on the strength of the match. We only display tags with confidence above 0.3.

5. Limitations

News Lens has significant limitations you should understand:

We are not a fact-checker. News Lens shows you how stories are framed. It does not tell you what's true. Use this tool alongside, not instead of, your own critical reading.

6. Updates & Feedback

This methodology is a living document. We update it when we change our approach.

Last updated: January 2026
Version: 1.0

Found an error? Have a suggestion? Email us at [email protected]