---
title: "Get homepage gaps"
method: GET
path: "/api/v1/analysis/{uuid}/homepage_gaps"
tags: ["Analysis"]
---

# Get homepage gaps

`GET /api/v1/analysis/{uuid}/homepage_gaps`

## Request

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

Compares what AI search engines searched for during a completed analysis with your live homepage. Returns the terms (words and two-word phrases) AI searched for that the homepage does not contain, weighted by search count, with example queries. Deterministic, no credits. Errors: 422 analysis_not_completed when the analysis has not finished, 422 homepage_unavailable when the homepage cannot be fetched.

## Path parameters

- `uuid` string, required

## Response `200`

Successful response.

- object
  - `homepage` object
    - `title` string
    - `url` string
  - `missing_terms` object[]
    - `ai_search_count` integer
    - `example_queries` string[]
    - `term` string
  - `present_terms_count` integer
  - `terms_checked` integer

## 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)