/news/{id}/related

GET /news/id/related

Endpoint

curl -X GET "https://api.newsdatahub.com/v1/news/12345/related" \
  -H "X-Api-Key: your_api_key_here" \
  -H "User-Agent: docs-related/1.0-curl"

Discover contextually similar articles by analyzing title, description, topics, and keywords from a source article. This powerful matching system examines multiple dimensions of content similarity simultaneously to surface truly relevant related coverage.

Use it to build “related stories” features, track how stories evolve across different sources, compare coverage angles, or surface diverse perspectives on the same topic.

You can fine-tune precision with three relevance modes: “broad” casts a wider net returning more loosely related articles, “balanced” (default) provides optimal precision-recall tradeoff, and “precise” returns only highly similar matches.

Results are limited to articles published within the last 60 days (or your plan’s historical access period) and ranked by relevance score.

Try It Live

• Related Article Finder Tool — Interactive tool to test the related articles endpoint with real article IDs

Learn More

• Find Related Articles Guide — Complete tutorial with code examples and response optimization

Path Parameters

Parameter	Type	Description
article_id	uuid	The article identifier to match on. Use the id field returned by /v1/news.

Access Requirements

This endpoint requires a paid plan. Free tier users do not have access to this endpoint.

Query Parameters

Parameter	Type	Description
per_page	integer	Number of related articles to return (max 100, default 5)
fields	string	Comma-separated list of fields to include. Always returns id
relevance	string	Matching precision: broad (more results, looser matching), balanced (default, optimal tradeoff), precise (fewer results, stricter matching)

Response Format

The response includes information about the source article in the related_to field (id, title, source_title, article_link, and pub_date) and an array of related article objects in the data field.

{
  "related_to": {
    "id": "5b710ed2-caf0-4e33-bdf7-c9ff0eb37989",
    "title": "France investigates oil tanker linked to Russia's shadow fleet",
    "source_title": "Reuters",
    "article_link": "https://www.reuters.com/world/europe/france-investigates-oil-tanker-2025-09-30",
    "pub_date": "2025-09-30T14:30:00Z"
  },
  "count": 3,
  "data": [
    {
      "id": "d46f71c1-e434-4d8e-9b4d-2d9ffe232885",
      "title": "Macron says a tanker off France is linked to Russia's shadow oil fleet",
      "source_title": "Yahoo News",
      "source_link": "https://www.yahoo.com",
      "article_link": "https://www.yahoo.com/news/articles/macron-says-tanker-off-france-160208052.html",
      "keywords": [
        "shadow fleet",
        "russian oil",
        "benin-flagged tanker",
        "Pushpa"
      ],
      "topics": [
        "politics",
        "energy",
        "sanctions",
        "international"
      ],
      "description": "Macron says a tanker off France is linked to Russia's shadow oil fleet",
      "pub_date": "2025-10-01T16:02:08",
      "creator": "Yahoo News",
      "content": "PARIS (AP) French President Emmanuel Macron...",
      "media_url": "https://media.zenfs.com/en/ap.org/18c393b66741d827f83874fa155a6c86",
      "media_type": null,
      "language": "en",
      "sentiment": {
        "pos": 0.02,
        "neg": 0.068,
        "neu": 0.912
      },
      "source": {
        "id": "yahoo",
        "country": "US",
        "political_leaning": "center",
        "reliability_score": 7.0,
        "type": "digital_native"
      }
    }
  ]
}

Response Attributes

Root Level

• related_to (object) — Information about the source article
• count (number) — Number of related articles found
• data (array) — Array of related article objects

Related To Object

• id (string) — ID of the source article
• title (string) — Title of the source article
• source_title (string) — Source name
• article_link (string) — URL to the source article
• pub_date (string) — Publication date in ISO 8601 format

Article Object

Related articles include the same fields as the /news endpoint. See the /news endpoint documentation for a complete field reference.