---
title: "Classify a URL"
method: GET
path: "/api/v1/classify"
tags: ["Classification"]
---

# Classify a URL

`GET /api/v1/classify`

## Request

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

Fetches the URL and uses AI to determine category, subcategory, language, sentiment, and target demographics. Results are cached for fast subsequent lookups. Optional fields (age, gender, server, app, grade fields) are present only if detected or previously analyzed.

## Query parameters

- `url` string, uri, required

## Response `200`

Classification result

- ClassifyResult
  - `url` string, required: The normalized URL
  - `cached` boolean, required: Whether result was from cache
  - `category` string, required: Main category (e.g., Sports, Technology)
  - `subcategory` string, required: Specific subcategory
  - `language` string, required: Detected content language
  - `sentiment` 'Good' | 'Neutral' | 'Bad', required: Content sentiment
  - `age` string: Target age group (present only if detected)
  - `gender` string: Target gender (present only if detected)
  - `server` string: Detected web server (present only if detected)
  - `app` string: Detected web application/CMS (present only if detected)
  - `seo_grade` string: SEO grade A-F (present only if previously analyzed)
  - `eeat_grade` string: E-E-A-T grade A-F (present only if previously analyzed)
  - `aeo_grade` string: AEO grade A-F (present only if previously analyzed)
  - `readability_grade` string: Readability grade A-F (present only if previously analyzed)
  - `wcag_grade` string: WCAG 2.1 accessibility grade A-F (present only if previously analyzed)
  - `garm_grade` string: GARM brand safety grade A-F (present only if previously analyzed)
  - `ai_disclosure_grade` string: AI Disclosure grade A-F (present only if previously analyzed)
  - `privacy_grade` string: Privacy Compliance grade A-F (present only if previously analyzed)

## Other responses

- `400`: Missing or invalid url parameter
- `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)