> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Design Search

> Search real web pages, app screens, and slides, and get the design values behind each.

For AI agents: [docs.octen.ai/capabilities/design-search.md](https://docs.octen.ai/capabilities/design-search.md)

Asked to build a landing page or a slide deck, a model designs from memory. Text search returns articles about design rather than the designs themselves, and a screenshot alone doesn't say which colors and font sizes produced it.

Octen Design Search searches real web pages, app screens, and slides, and returns each as an image with its design values, plus web results on the same query.

For the full list of parameters, see the [Design Search API reference](https://docs.octen.ai/api-reference/design-search.md).

## Why Octen Design Search

* **Real designs to look at.** Results are screenshots of real web pages, page sections, mobile app screens, and slides, ready for a vision model to read.
* **Values to build from.** Each image comes with its design values, such as the colors, fonts, and font sizes of a page or slide, or the components of an app screen, so a model doesn't have to guess them from pixels.
* **Code to start from.** Page sections come with their HTML.
* **Whole pages and decks.** A page section or slide knows the page or deck it belongs to, so the rest can be fetched in order.
* **Design writing in the same call.** Articles, guidelines, and tutorials on the same query come back as ranked web results.

For general images, use [Image Search](https://docs.octen.ai/capabilities/image-search.md). For general web pages, use [Web Search](https://docs.octen.ai/capabilities/web-search.md).

## How It Works

1. Send a query that describes what you're building.
2. Octen searches screenshots of real web pages, page sections, app screens, and slides, and searches the web on the same query.
3. The response returns ranked images, each with its design values and, for page sections, its HTML, plus ranked web results.

## Scenarios

### Build a landing page

Describe the page you're building. Each image comes with its colors, fonts, and font sizes.

```bash theme={null}
curl -X POST https://api.octen.ai/design-search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "landing page for an AI research tool, dark theme",
    "images": { "count": 10 }
  }'
```

### Redesign a section

Search for the kind of section you're changing. Page sections come with their HTML, ready to adapt.

```json theme={null}
{
  "query": "pricing section",
  "images": { "count": 10, "snippet": { "max_tokens": 20000 } },
  "web_search": { "enable": false }
}
```

### Design an app screen

App screen results are real screens from mobile apps, with the components each screen uses.

```json theme={null}
{
  "query": "iOS onboarding screen",
  "web_search": { "enable": false }
}
```

### Lay out a slide deck

Slide results come from real decks, with the deck's theme colors and fonts when available.

```json theme={null}
{
  "query": "seed round pitch deck",
  "images": { "count": 10 }
}
```

### Get the whole page or deck

Each page section and slide carries the id of its page or deck. Pass it to get every section of the page, or every slide of the deck, in order.

```json theme={null}
{
  "images": {
    "group_id": "deck_3b7f0e92c4a1d85f6e2b9c07a3d4f1e8b5c26a9d0f7e3b1c4a8d2e6f9b0c5a7d",
    "count": 30
  }
}
```

### Look up design guidance

To get only articles, guidelines, and tutorials, turn images off.

```json theme={null}
{
  "query": "dark mode color contrast guidelines",
  "images": { "enable": false }
}
```

## Next Steps

> [card] [Try in Console](https://octen.ai/platform/design-search)
>
> Run Design Search live in the Octen console.

> [card] [Design Search API Reference](https://docs.octen.ai/api-reference/design-search.md)
>
> Full request/response schema.

***

Last modified on November 19, 2026


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.