---
title: "{homepage}: read the site and draft the listing (name, tagline, description, proven surfaces, icon); says if the site is already listed. No row is written."
method: POST
path: "/api/ai-tools/preview"
---

# {homepage}: read the site and draft the listing (name, tagline, description, proven surfaces, icon); says if the site is already listed. No row is written.

`POST /api/ai-tools/preview`

## Request

- Base URL: `https://shapelessai.com`
- URL: `https://shapelessai.com/api/ai-tools/preview`
- Auth: none required

## Request body

- DirectoryPreviewInput
  - `homepage` string, uri, required

## Response `200`

OK

## Other responses

- `400`: The homepage could not be read; problems.homepage says why.
- `429`: 20 previews an hour per address.

---

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