---
title: "Analyze GARM Brand Safety"
method: GET
path: "/api/v1/garm"
tags: ["Analysis"]
---

# Analyze GARM Brand Safety

`GET /api/v1/garm`

## Request

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

Maps content to the GARM Brand Suitability Framework. Accepts either a URL (classification fetched from cache) or explicit category/sentiment parameters. Returns a brand safety score (0-100, higher = safer), letter grade (A-F), matched GARM category, risk level, and recommendations. Floor categories (e.g., Adult) always score 0/F.

## Query parameters

- `url` string, uri
- `category` string
- `sentiment` 'Good' | 'Neutral' | 'Bad'

## Response `200`

GARM brand safety analysis result

- GARMResult: GARM Brand Suitability Framework analysis. Grade thresholds: A>=80, B>=60, C>=40, D>=20, F<20. Higher score = safer for advertising.
  - `url` string, nullable: The analyzed URL, or null if category was provided directly
  - `category` string: LLMSE content category used for GARM mapping
  - `sentiment` 'Bad' | 'Neutral' | 'Good': Content sentiment used for score adjustment
  - `score` integer, required: Brand safety score (0-100, higher = safer)
  - `grade` 'A' | 'B' | 'C' | 'D' | 'F', required
  - `garm_category` string, nullable, required: Matched GARM category name, or null if brand-safe
  - `risk_level` 'none' | 'low' | 'medium' | 'high' | 'floor', required: GARM risk level
  - `is_floor` boolean, required: Whether this category is not suitable for any advertising
  - `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
  - `recommendations` string[], required

## Other responses

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