---
title: "List analyses"
method: GET
path: "/api/v1/sites/{site_uuid}/analysis"
tags: ["General"]
---

# List analyses

`GET /api/v1/sites/{site_uuid}/analysis`

## Request

- Base URL: `https://botsee.io`
- URL: `https://botsee.io/api/v1/sites/{site_uuid}/analysis`
- Auth: HTTP bearer

Lists analysis runs for a site with optional filters.

## Path parameters

- `site_uuid` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `persona_uuid` string
- `model` string
- `from` string
- `to` string

## Response `200`

Successful response.

- object
  - `analyses` Analysis[]
    - `completed_at` string, date-time, nullable
    - `credits_used` integer
    - `models` string[]
    - `recommendations` object[]: Generated recommendations; empty until POST /analysis/:uuid/recommendations succeeds.
      - `action` string
      - `priority` 'high' | 'medium' | 'low'
      - `reasoning` string
      - `target_keywords` string[]
      - `target_urls` string[]
    - `recommendations_generated_at` string, date-time, nullable
    - `response_count` integer
    - `scope` 'site' | 'customer_type' | 'persona' | 'questions'
    - `site_uuid` string
    - `started_at` string, date-time
    - `status` 'pending' | 'running' | 'completed' | 'failed'
    - `uuid` string
  - `cursor` string, nullable

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but lacks permission (e.g. botsee_disabled).
- `404`: The requested resource does not exist or is not accessible.
- `422`: Request body or parameters failed validation.
- `429`: Too many requests. Wait and retry per Retry-After header.

---

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