---
title: "Analyze AI Disclosure"
method: GET
path: "/api/v1/ai-disclosure"
tags: ["Analysis"]
---

# Analyze AI Disclosure

`GET /api/v1/ai-disclosure`

## Request

- Base URL: `https://llmse.ai`
- URL: `https://llmse.ai/api/v1/ai-disclosure`
- Auth: one of:
  - none
  - HTTP bearer

Analyzes a website for AI transparency compliance, detecting AI disclosure statements, AI usage policies, and chatbot labeling. Checks are conditional: issues are only raised when AI or chatbot technology is detected on the page. Sites with no AI footprint score 100/A. Supports EU AI Act readiness assessment. Detects 23 chatbot/AI technologies.

## Query parameters

- `url` string, uri, required

## Response `200`

AI Disclosure analysis result

- AIDisclosureResult: AI Disclosure compliance analysis for EU AI Act readiness. All checks are conditional — issues only raised when AI/chatbot technology is detected. Non-AI sites score 100/A. Grade thresholds: A>=90, B>=80, C>=70, D>=60, F<60.
  - `url` string
  - `cached` boolean
  - `score` integer, required: AI Disclosure score (0-100). Deduction-based: chatbot unlabeled -15, no disclosure -5, no policy -5, vague disclosure -1.
  - `grade` 'A' | 'B' | 'C' | 'D' | 'F', required
  - `issues` CategorizedIssues, required: Issues grouped by severity level
    - `critical` Issue[], required
      - `code` string, required: Machine-readable issue code (e.g., 'SEO_NO_TITLE', 'EEAT_NO_AUTHOR')
      - `message` string, required: Human-readable issue description
      - `impact` string, required: Impact level of the issue
    - `warnings` Issue[], required
      - `code` string, required: Machine-readable issue code (e.g., 'SEO_NO_TITLE', 'EEAT_NO_AUTHOR')
      - `message` string, required: Human-readable issue description
      - `impact` string, required: Impact level of the issue
    - `info` Issue[], required
      - `code` string, required: Machine-readable issue code (e.g., 'SEO_NO_TITLE', 'EEAT_NO_AUTHOR')
      - `message` string, required: Human-readable issue description
      - `impact` string, required: Impact level of the issue
  - `meta` object, required: Detected AI disclosure metadata
    - `has_explicit_disclosure` boolean: Strong AI disclosure statement found (e.g., 'AI-generated', 'powered by AI')
    - `has_vague_disclosure` boolean: Weaker disclosure language found (e.g., 'AI assistance', 'machine-generated')
    - `has_policy_link` boolean: Link to AI usage policy page found
    - `has_chatbot_tech` boolean: Chatbot/AI technology detected (e.g., Intercom, Drift, ChatGPT Widget)
    - `has_chatbot_label` boolean: AI attribution found on chatbot widget (aria-label, title, or visible text)
    - `detected_chatbot_apps` string[]: Names of detected chatbot/AI technologies
    - `disclosure_texts` string[]: Matched disclosure text snippets (up to 120 chars each)
    - `policy_urls` string[]: URLs of detected AI policy pages
  - `recommendations` string[], required
  - `signals` object, required: Summary of detected positive signals
    - `disclosure` string[]
    - `policy_links` string[]
    - `chatbot_apps` string[]

## Other responses

- `400`: Invalid request
- `429`: Rate limited

---

[API](https://skmtc.dev/llmse/apis/llmse-api.md) · [All operations](https://skmtc.dev/llmse/apis/llmse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/llmse/apis/llmse-api/revisions/8aedf67208e4?raw)
