Article Comparison — compare web articles

Extract and Compare Multiple Articles from Web Pages API

What it does

Article Comparison compares multiple web articles and returns a structured breakdown of how they relate. Send an array of article URLs, and get back a comparison object you can use to summarise overlap, differences, and viewpoint.

The response includes shared themes, a numeric topic_overlap score, style_differences, a structural_contrast summary, and a perspective_analysis field. That makes it useful when you need to group similar coverage, compare competitor commentary, or build editorial workflows that surface how sources align or diverge.

Use Article Comparison when you want to analyse a set of links instead of reading them one by one. It fits research tools, content monitoring dashboards, and publishing systems that need a concise comparison of source articles.

Because the endpoint returns only comparison data, it stays focused on analysis rather than extraction or summarisation of full article text.

curl -X POST "http://localhost:8080/namastesumalya/compare-multiple-articles" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"urls":["https://example.com/article1","https://example.com/article2"]}'

What you'll get back

Returns a JSON object with a comparison object. That comparison object may include shared_themes as an array of strings, topic_overlap as an integer, style_differences as an array of strings, structural_contrast as a string, and perspective_analysis as a string.

{
  "comparison": {
    "shared_themes": ["AI tools", "automation"],
    "topic_overlap": 70,
    "style_differences": ["Article 1 is technical", "Article 2 is conversational"],
    "structural_contrast": "One is step-based, the other narrative",
    "perspective_analysis": "Both support AI adoption but differ in execution approach"
  }
}

About this endpoint

What it does

Compares multiple web articles from the URLs you submit and returns a JSON object with a comparison object containing the comparison results.

Request Body

Parameter	Type	Mandatory	Description
urls	String Array	Yes	The article URLs to compare.

Response

Returns a JSON object with a comparison object. The comparison object contains shared_themes as a string array, topic_overlap as an integer, style_differences as a string array, structural_contrast as a string, and perspective_analysis as a string.

Parameter	Type	Mandatory	Description
comparison	Object	No	Comparison results for the submitted articles.
comparison.shared_themes	String Array	No	Shared themes identified across the articles.
comparison.topic_overlap	Integer	No	Topic overlap score.
comparison.style_differences	String Array	No	Differences in writing style between the articles.
comparison.structural_contrast	String	No	Contrast in article structure.
comparison.perspective_analysis	String	No	Analysis of the perspectives presented in the articles.

Body

Name

Type

Description

bodyREQUIRED

object

—

Extract and Compare Multiple Articles from Web Pages API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return