Website Similarity Analysis — compare sites and SEO signals

Advanced Website Similarity Analysis API

What it does

Website Similarity Analysis compares a list of website URLs and returns a scored report for each one, plus an overall similarity result across the set.

Send one or more website URLs in the urls array. The response includes a tier value, the service name used for the report, and timestamp for when the analysis was generated. Under insights.global, you get an explanation of the match results and a similarityScore from 0 to 100.

For each submitted URL, insights.siteReports provides the url, an seoScore, an AI-generated aiSummary, and a list of suggestedImprovements. That makes it useful when you need to compare competitor pages, audit similar landing pages, or group websites by positioning before a content review.

Use it when you want a quick, structured read on how closely a set of sites align, without manually comparing page by page.

curl -X POST "http://localhost:8080/namastesumalya/analyze-website-similarity" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"urls":["https://notion.so","https://clickup.com"]}'

What you'll get back

Returns a JSON object with top-level tier, service, insights, and timestamp fields. insights is an object containing global similarity details and siteReports for each analyzed URL.

{
  "tier": "standard",
  "service": "analyze-website-similarity",
  "insights": {
    "global": {
      "explanation": "The submitted websites share similar content structure and topic focus.",
      "similarityScore": 78.4
    },
    "siteReports": [
      {
        "url": "https://example.com",
        "seoScore": 82,
        "aiSummary": "A concise business website with a clear value proposition.",
        "suggestedImprovements": ["Add more internal links", "Improve meta descriptions"]
      }
    ]
  },
  "timestamp": "2026-07-08T12:34:56Z"
}

About this endpoint

What it does

Analyzes and compares the website URLs you submit in the request body, then returns a similarity report with overall and per-site insights. The response includes the service tier used, the service name, analysis insights, and a generation timestamp.

Request Body

Parameter	Type	Mandatory	Description
urls	String Array	Yes	List of website URLs to analyze and compare. Each item must be a URI.

Response

Returns a JSON object with tier and service string fields, an insights object field, and a timestamp date-time string field. The insights object contains a global object with an explanation string and similarityScore number, plus a siteReports array of per-URL analysis objects.

Parameter	Type	Mandatory	Description
tier	ENUM	No	The service tier applied to this analysis. Allowed values: `standard`, `premium`.
service	String	No	The name of the analysis service used to generate this report.
insights	Object	No	Analysis results. Contains `global` and `siteReports`.
insights.global	Object	No	Global similarity summary. Contains `explanation` and `similarityScore`.
insights.global.explanation	String	No	A narrative explanation of the global similarity result.
insights.global.similarityScore	Number	No	Overall similarity score across all submitted websites, from 0 to 100.
insights.siteReports	Object Array	No	Individual analysis reports for each submitted URL.
insights.siteReports[].url	String	No	The URL of the analyzed website. Must be a URI.
insights.siteReports[].seoScore	Number	No	The SEO score for this website, from 0 to 100.
insights.siteReports[].aiSummary	String	No	An AI-generated summary of the website's content and positioning.
insights.siteReports[].suggestedImprovements	String Array	No	A list of suggested SEO/content improvements for this website.
timestamp	String	No	The timestamp at which the analysis was generated. Format: date-time.

Body

Name

Type

Description

bodyREQUIRED

object

—

Advanced Website Similarity Analysis 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