For the complete documentation index, see llms.txt. This page is also available as Markdown.

Analysis Data

Analysis Data

Both Analysis Results and Organization Analysis expose a structured privacy analysis payload through their data field. The two features differ in scope and retrieval, but the payload itself is identical. This page documents that shared payload.

The data field is populated when the analysis status is COMPLETE or PARTIAL. For other statuses, data will be undefined.

Analysis Status

An analysis reports one of the following statuses:

Status
Description

PENDING

The analysis is queued or an asynchronous source is still resolving. Re-query for the terminal result.

COMPLETE

The analysis has completed successfully with full data.

PARTIAL

The analysis has completed with partial data available.

FAILED

The analysis encountered an error and could not complete.

UNAVAILABLE

The analysis data is not available.

Privacy Score

The privacy score provides an overall numeric assessment (0–100) of the organization's privacy practices. A higher score indicates better privacy practices. The breakdown field reports how the privacy score was determined. The coverage field reports how much of the scoring-relevant input had a known value; a low ratio means the score rests on few known signals and should be treated as lower-confidence.

const privacyScore = analysisData?.privacyScore
if (privacyScore) {
  const { score, breakdown, coverage } = privacyScore
  console.log(`Overall score: ${score}/100`)
  console.log(`Coverage: ${coverage.evaluated}/${coverage.total} aspects`)
  for (const contribution of breakdown) {
    console.log(`  ${contribution.aspect}: ${contribution.contribution}`)
  }
}
Property
Type
Description

score

number

Numeric score (0–100). Higher is better.

breakdown

ScoreContribution[]

How each aspect contributed to the score.

coverage

ScoreCoverage

How much of the scoring-relevant input had a known value.

Each ScoreContribution has an aspect identifier (e.g. dataCollection, dataSharing) and a numeric contribution (negative = penalty, positive = bonus). ScoreCoverage reports evaluated (aspects with a known value) out of total (aspects the calculator considers).

Privacy Summary

A concise human-readable summary of privacy findings, including up to 5 key takeaways. An example of this might be:

  • Collects 13 categories of personal data including location data, biometric data, background check data and 10 other categories.

  • Collects sensitive data (location data) for non-essential purposes.

  • Shares location data, other data, personal identifiers and 7 more with third parties.

  • Sells personal information (opt-out available).

  • Uses location data, other data, personal identifiers and 4 more for advertising.

Property
Type
Description

bulletPoints

string[]

Up to 5 key takeaways.

sourceUrl

string

URL of the source material that was analyzed.

sourceLastUpdated

string | undefined

When the source material was last updated, as reported by the organization.

Organization Identity

When identified, the analysis includes the organization behind the domain — its consumer-facing brand, legal company name, and business categories.

Property
Type
Description

brandName

string

The consumer-facing brand name of the organization.

companyName

string

The legal or corporate name of the organization.

primaryCategory

OrganizationCategory

The primary business category of the organization.

categories

OrganizationCategory[]

All business categories the organization belongs to.

Category Signals

Per-category breakdown of how specific types of personal data are handled. Each category includes signals for collection, sharing, monetization, retention, and opt-out capability.

Property
Type
Description

category

DataCategory

The data category these signals apply to.

collected

SignalValue

Whether this category of data is collected.

dataLabels

string[]

Descriptive labels for the collected data within this category.

sharedWithThirdParties

ShareStyle

How this category is shared with third parties.

monetized

SignalValue

Whether this category is used for monetization.

retained

SignalValue

Whether this category is retained.

retention

RetentionInfo | undefined

Retention details when data is retained.

userCanOptOut

SignalValue

Whether the user can opt out of this category's collection.

requiredForService

SignalValue

Whether this data is required for the core service to function.

requiredForLaw

SignalValue

Whether this data is collected to comply with legal requirements.

Data Categories:

Category
Description

ACCOUNT_PROFILE

Account and profile information.

AUTHENTICATION

Authentication credentials and tokens.

BACKGROUND

Background/employment history.

BIOMETRIC

Biometric data (fingerprints, face, voice).

COMMUNICATION

Communication content (messages, emails).

CONTACTS

Contact lists and address books.

DEMOGRAPHIC

Demographic information (age, gender).

DEVICE_IDENTIFIER

Device identifiers and hardware info.

FINANCIAL

Financial data (payment methods, transactions).

GOVERNMENT_ISSUED

Government-issued IDs (SSN, passport).

HEALTH

Health and medical data.

INFERENCES

Inferred data derived from other categories.

LOCATION

Location and geolocation data.

OTHER

Data not fitting other categories.

PII

Personally identifiable information (name, email, phone).

THIRD_PARTY_DATA

Data received from third parties.

USAGE

Usage and behavioral data.

Signal Values:

Most signals use a tri-state value:

Value
Description

YES

The determination is affirmative.

NO

The determination is negative.

UNKNOWN

Insufficient information to determine.

Share Styles:

The sharedWithThirdParties signal indicates how a category is shared:

Style
Description

SHARED

Data is shared with third parties.

SHARED_WITH_CONSENT

Data is shared with third parties only with user consent.

INFERENCE_SHARED

Inferred data is shared with third parties.

NONE

Data is not shared with third parties.

UNKNOWN

Insufficient information to determine.

Capability Signals

Action-derived signals indicating what privacy capabilities the organization supports.

Signal
Description

supportsAccountCreation

Whether the organization supports creating an account.

supportsAccountDeletion

Whether the organization supports account deletion.

supportsDataDeletionRequests

Whether the organization accepts data deletion requests.

supportsDataExport

Whether the organization allows users to export their data.

supportsSubscriptions

Whether the organization supports subscription management.

sellsPersonalInformation

Whether the organization sells personal information.

usesCookiesOrTracking

Whether the organization uses cookies or tracking technologies.

supportsTwoFactorAuth

Whether the organization supports two-factor auth for logins.

Each capability signal uses the same tri-state SignalValue (YES / NO / UNKNOWN) described above.

Risk Indicators

Aggregated risk indicators derived from category signals and capabilities.

Indicator
Type
Description

dataCollectionBreadth

number

Total number of data categories collected.

collectsSensitiveDataForNonEssentialPurposes

SignalValue

Whether sensitive categories are collected for non-essential purposes.

sellsPersonalInformation

SignalValue

Whether data selling is indicated.

maxRetentionDays

number | undefined

Longest known retention period in days.

hasIndefiniteRetention

SignalValue

Whether any category has indefinite retention.

encryptionPractices

SignalValue

Whether strong encryption practices are in place.

breachRisk

SignalValue

Whether there is an elevated risk of data breach.

Retention Styles

When retention information is available for a category, the style field indicates how the retention period is expressed:

Style
Description

INDEFINITE

Data is retained indefinitely with no defined end date.

RELATIVE_TO_ACCOUNT_CLOSURE_TIME

Retention period starts when the account is closed.

RELATIVE_TO_DATA_STORAGE_TIME

Retention period starts when the data is stored.

OTHER

Retention policy does not fit standard categories.

RetentionInfo carries the style, an optional timeInDays, and optional free-text additionalInfo from the policy.

Analysis Data Object

Property
Type
Description

privacyScore

PrivacyScore | undefined

Overall privacy score. Undefined when scoring is disabled.

privacySummary

PrivacySummary

Concise human-readable summary of privacy findings.

categories

CategorySignals[]

Per-category signal breakdown.

capabilities

CapabilitySignals

Action-derived capability signals.

riskIndicators

RiskIndicators

Aggregated risk indicators.

organizationIdentity

OrganizationIdentity | undefined

Organization identity (brand, company, business categories).

attribution

string[]

Information describing where the analysis result is derived from.

Last updated