---
title: "Unlock Results"
method: POST
path: "/api/v1/public/geo/unlock-results"
tags: ["geo-free-checker"]
---

# Unlock Results

`POST /api/v1/public/geo/unlock-results`

## Request body

- UnlockResultsRequest
  - `scan_id` string, required
  - `email` string, email, required

## Response `200`

Successful Response

- FreeCheckFullResponse
  - `brand_score` integer, required
  - `mention_rate` number, required
  - `mentions_count` integer, required
  - `total_queries` integer, required
  - `top_competitors` CompetitorSummary[], required
    - `name` string, required
    - `mention_count` integer, required
    - `avg_position` number, required
    - `sentiment` string, nullable
  - `sentiment_summary` string, nullable, required
  - `results` MonitoringResult[], required
    - `locations_mentioned` LocationMention[]
      - `name` string, required
      - `position` integer, required
      - `sentiment` 'positive' | 'neutral' | 'negative', required
      - `description_snippet` string, required
      - `is_primary_recommendation` boolean, required
    - `total_locations_mentioned` integer
    - `query_used` string, required
    - `platform` string, required
    - `checked_at` string, date-time, required
    - `citation_urls` string[]
    - `error` 'quota_exhausted' | 'auth_failed' | 'rate_limited' | 'timeout' | 'provider_unavailable' | 'invalid_model' | 'malformed_response' | 'retrieval_not_observed' | 'unknown' — Stable provider failure taxonomy persisted on monitoring tasks.
    - `attempt_count` integer
    - `retryable` boolean
    - `run_index` integer
    - `requested_model` string, nullable
    - `resolved_model` string, nullable
    - `adapter` string, nullable
    - `retrieval_policy` string, nullable
    - `retrieval_observed` boolean

## Other responses

- `422` — Validation Error

## Changes

> 19 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/public/geo/unlock-results/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/34f2d9e81b0b?raw)