Technical Comparison — compare website SEO signals

Technical Comparison of Webpages API

What it does

Technical Comparison analyzes two or more website URLs and returns a per-site technical and SEO report you can compare side by side. Send an array of URLs, and you get a structured result for each one with its status and report data.

For each URL, Technical Comparison can return page metadata such as the title, charset, keywords, language, canonical URL, and meta description. It also includes heading structure details like H1 text, H2 and H3 counts, plus total headings, so you can quickly compare page structure across sites.

The response also surfaces practical checks for modern web pages: whether the page is served over SSL, whether it appears mobile-friendly, how many links it contains, and how many of those are internal versus external. For accessibility review, it reports image counts, missing alt text, and an alt-text score.

Use Technical Comparison when auditing competitor landing pages, checking template consistency across a portfolio of sites, or spotting on-page SEO differences between pages before a redesign or migration.

Quickstart

Compare the technical and SEO details for at least two website URLs.

curl -X POST "http://localhost:8080/namastesumalya/technical-comparison" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com",
      "https://www.wikipedia.org"
    ]
  }'

What you'll get back

Returns a JSON object with results, service, version, and timestamp fields. results is an array of per-URL comparison objects; each item includes the analyzed url, status, and, when available, a technicalReport object with technical, SEO, accessibility, connectivity, and performance data.

{
  "results": [
    {
      "url": "https://example.com",
      "status": "success",
      "technicalReport": {}
    }
  ],
  "service": "Enhanced Technical Comparison",
  "version": "1.0",
  "timestamp": "2026-07-08T12:00:00Z"
}

About this endpoint

What it does

Compares the technical and SEO characteristics of multiple websites from a list of URLs and returns a per-website analysis report. The request accepts at least 2 website URLs.

Request Body

Parameter	Type	Mandatory	Description
urls	String Array	Yes	List of website URLs to compare for technical and SEO analysis. Minimum of 2 URLs required. Each item must be a URI.

Response

Returns a JSON object with results as an array of per-website analysis objects, plus service and version strings and a timestamp date-time field. Each item in results includes the analyzed url, a status string, and an optional technicalReport object with the technical findings for that URL.

Parameter	Type	Mandatory	Description
results	Object Array	No	The list of per-website technical comparison results. Each item includes `url` (URI), `status` (`success` or `failed`), and, when present, a `technicalReport` object.
results[].url	String	No	The URL of the analyzed website. Format: URI.
results[].status	ENUM	No	The status of the analysis for this URL. Allowed values: `success`, `failed`.
results[].technicalReport	Object	No	Technical analysis data for the URL. Contains nested objects for meta, structure, indicators, connectivity, accessibility, and performanceResources.
results[].technicalReport.meta	Object	No	Page metadata. Contains `title`, `charset`, `keywords`, `language`, `canonical`, and `description`.
results[].technicalReport.structure	Object	No	Heading structure data. Contains `h1`, `h2Count`, `h3Count`, and `totalHeadings`.
results[].technicalReport.indicators	Object	No	Page indicators. Contains `sslEnabled` and `mobileFriendly`.
results[].technicalReport.connectivity	Object	No	Link metrics. Contains `totalLinks`, `externalLinks`, and `internalLinks`.
results[].technicalReport.accessibility	Object	No	Image accessibility metrics. Contains `totalImages`, `imageAltScore`, and `missingAltTags`.
results[].technicalReport.performanceResources	Object	No	Resource and performance metrics. Contains `scripts`, `loadTimeMs`, and `stylesheets`.
service	String	No	The name of the comparison service used.
version	String	No	The version of the comparison service/report format.
timestamp	String	No	The timestamp at which the comparison was generated. Format: date-time.

Body

Name

Type

Description

bodyREQUIRED

object

—

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return