Article Analysis — score and classify web articles

Extract and Analyze Content from Web Page API

What it does

Article Analysis lets you send a web page URL and get back structured signals about the article behind it. Use it when you need a quick read on content type, reading level, emotional tone, SEO score, key entities, and quality indicators without building your own parser.

Provide the url as a query parameter. The response includes the original url, an entities object with extracted people, locations, and organizations, plus a numeric seo_score. You also get content_type, reading_level, emotional_tone, and quality_signals for clarity, engagement, and originality.

This is useful for newsroom workflows, content review pipelines, competitive monitoring, and editorial dashboards. For example, you can score incoming articles, flag pieces with weak clarity, or group stories by tone and named entities before further processing.

Use Article Analysis when you need a compact, machine-readable summary of an article from a public web page and want to route it into search, moderation, or analytics systems.

What you'll get back

Returns a JSON object with optional top-level fields such as url, entities, seo_score, content_type, reading_level, emotional_tone, and quality_signals.

url is a string with the analyzed article URL.

entities is an object that may include people, locations, and organizations arrays.

seo_score is an integer.

content_type, reading_level, and emotional_tone are strings.

quality_signals is an object that may include clarity, engagement, and originality strings.

{
  "url": "https://example.com/article",
  "entities": {
    "people": ["Elon Musk"],
    "locations": ["USA"],
    "organizations": ["OpenAI"]
  },
  "seo_score": 85,
  "content_type": "Opinion",
  "reading_level": "Intermediate",
  "emotional_tone": "Positive",
  "quality_signals": {
    "clarity": "High",
    "engagement": "Strong",
    "originality": "Moderate"
  }
}

About this endpoint

What it does

Analyzes an article from a web page URL and returns structured metadata about the page, including entities, SEO score, content characteristics, and quality signals.

Query Parameter(s)

Attribute	Type	Mandatory	Description
url	String	Yes	The web page URL to analyze.

Response

Returns a JSON object containing the analyzed page URL plus article analysis fields. The top-level response includes url as a string, entities as an object, seo_score as an integer, content_type as a string, reading_level as a string, emotional_tone as a string, and quality_signals as an object.

Parameter	Type	Mandatory	Description
url	String	No	The analyzed page URL.
entities	Object	No	Named entities extracted from the article. Includes `people`, `locations`, and `organizations` as arrays of strings.
entities.people	String Array	No	People mentioned in the article.
entities.locations	String Array	No	Locations mentioned in the article.
entities.organizations	String Array	No	Organizations mentioned in the article.
seo_score	Integer	No	SEO score for the article.
content_type	String	No	Content type of the article.
reading_level	String	No	Reading level of the article.
emotional_tone	String	No	Emotional tone of the article.
quality_signals	Object	No	Quality-related signals for the article. Includes `clarity`, `engagement`, and `originality` as strings.
quality_signals.clarity	String	No	Clarity signal.
quality_signals.engagement	String	No	Engagement signal.
quality_signals.originality	String	No	Originality signal.

Query parameters

Name

Type

Description

urlREQUIRED

string

—

Extract and Analyze Content from Web Page API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Query Parameter(s)

Response

Query parameters

Errors any endpoint can return