curl --request POST \
--url https://api.octen.ai/design-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "pricing section for a SaaS landing page"
}
'{
"code": 0,
"msg": "success",
"request_id": "req_abc123def456",
"data": {
"query": "pricing section for a SaaS landing page",
"images": [
{
"type": "web_section",
"title": "Simple, transparent pricing",
"description": "A pricing section on a white background with three plan cards side by side; the middle card has a green border and a Most popular badge.",
"url": "https://cdn.octen.ai/octen-public-resource/data/design/web_page/8d2e5c41a07b93f6e1d4c28a5b90f3e7c6a1d2b4/s-004.png?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"thumbnail": "https://cdn.octen.ai/octen-public-resource/data/design/thumb/4a1c/4a1c9e07b52d83f6a0e1c7d94b28f5e3.jpg?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"source_page": "https://www.example-saas.com/pricing",
"width": 1440,
"height": 860,
"group": {
"group_id": "pg_8d2e5c41a07b93f6e1d4c28a5b90f3e7c6a1d2b4",
"type": "web_page",
"name": "Pricing | Example SaaS",
"position": 4,
"total": 9
},
"design_facts": {
"color": {
"background": {
"$type": "color",
"$value": {
"alpha": 1,
"colorSpace": "srgb",
"components": [
1,
1,
1
],
"hex": "#ffffff"
}
},
"text": {
"$type": "color",
"$value": {
"alpha": 1,
"colorSpace": "srgb",
"components": [
0.0627,
0.0941,
0.1569
],
"hex": "#101828"
}
},
"accent": {
"$type": "color",
"$value": {
"alpha": 1,
"colorSpace": "srgb",
"components": [
0.0863,
0.6392,
0.2902
],
"hex": "#16a34a"
}
}
},
"fontFamily": {
"heading": {
"$type": "fontFamily",
"$value": [
"Inter"
]
},
"body": {
"$type": "fontFamily",
"$value": [
"Inter"
]
}
},
"fontSize": {
"heading": {
"$type": "dimension",
"$value": {
"unit": "px",
"value": 40
}
},
"body": {
"$type": "dimension",
"$value": {
"unit": "px",
"value": 16
}
}
},
"radius": {
"default": {
"$type": "dimension",
"$value": {
"unit": "px",
"value": 12
}
}
}
},
"snippet": {
"format": "html",
"code": "<section class=\"pricing\"><h2 class=\"pricing-title\">Simple, transparent pricing</h2><div class=\"plans\"><div class=\"plan\">…</div></div></section>"
}
},
{
"type": "slide",
"title": "Market opportunity",
"description": "A slide with three nested circles on the left labeled TAM, SAM, and SOM, and a figure with a one-line note for each on the right.",
"url": "https://cdn.octen.ai/octen-public-resource/data/design/deck/3b7f0e92c4a1d85f6e2b9c07a3d4f1e8b5c26a9d0f7e3b1c4a8d2e6f9b0c5a7d/p-005.png?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"thumbnail": "https://cdn.octen.ai/octen-public-resource/data/design/thumb/9e5b/9e5b2c18f0a74d36b1e8c5a29d07f4b3.jpg?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"source_page": "https://www.example-startup.com/files/seed-deck.pptx",
"width": 1920,
"height": 1080,
"group": {
"group_id": "deck_3b7f0e92c4a1d85f6e2b9c07a3d4f1e8b5c26a9d0f7e3b1c4a8d2e6f9b0c5a7d",
"type": "deck",
"name": "Example Startup Seed Deck",
"position": 5,
"total": 14,
"master": {
"width": 1280,
"height": 720,
"majorFont": "Calibri Light",
"minorFont": "Calibri",
"palette": {
"dk1": "#000000",
"lt1": "#FFFFFF",
"dk2": "#0E2841",
"lt2": "#E8E8E8",
"accent1": "#156082",
"accent2": "#E97132",
"accent3": "#196B24",
"accent4": "#0F9ED5",
"accent5": "#A02B93",
"accent6": "#4EA72E",
"hlink": "#467886",
"folHlink": "#96607D"
}
}
},
"design_facts": {
"layoutFacts": {
"aspectRatio": 1.7778,
"elementCount": 12,
"imageCount": 0,
"textCount": 9
},
"styleFacts": {
"fontFamilies": [
"Calibri"
],
"fontSizes": [
"18pt",
"36pt"
],
"foregroundColors": [
"#0E2841"
]
},
"typographyMap": {
"title": {
"fontFamily": "Calibri Light",
"fontSizePt": 36,
"fontWeight": 400
},
"other": {
"color": "#0E2841",
"fontFamily": "Calibri",
"fontSizePt": 18,
"fontWeight": 400
}
}
}
}
],
"results": [
{
"title": "Pricing Page Design: 12 Patterns That Convert",
"url": "https://www.example-design-blog.com/pricing-page-patterns",
"highlight": "Three plans side by side, with the recommended plan raised and outlined, is the most common layout. Keep plan names short and put the price above the feature list.",
"authors": "Example Design Blog",
"time_published": "2026-09-08T00:00:00Z",
"time_last_crawled": "2026-11-02T06:15:00Z",
"favicon": "https://www.example-design-blog.com/favicon.ico",
"cover_image": {
"url": "https://img.example-design-blog.com/pricing-page-patterns/cover.png",
"description": "Three pricing cards side by side"
}
}
]
},
"meta": {
"usage": {
"num_search_queries": 1
},
"latency": 276
}
}{
"code": 400,
"msg": "Invalid params. Param images.count must be at most 100",
"request_id": "req_abc123def456"
}{
"code": 401,
"msg": "Invalid API Key",
"request_id": "req_abc123def456"
}{
"code": 403,
"msg": "Insufficient balance in account",
"request_id": "req_abc123def456"
}{
"code": 429,
"msg": "Exceeding the rate limit",
"request_id": "req_abc123def456"
}{
"code": 500,
"msg": "Internal error",
"request_id": "req_abc123def456"
}Octen Premier
Design Search API Reference
Searches for design references that match the query. Each reference is returned as an image result: a screenshot of a web page, page section, app screen, or slide, with its design values. Web results on the same query are returned alongside.
POST
/
design-search
curl --request POST \
--url https://api.octen.ai/design-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "pricing section for a SaaS landing page"
}
'{
"code": 0,
"msg": "success",
"request_id": "req_abc123def456",
"data": {
"query": "pricing section for a SaaS landing page",
"images": [
{
"type": "web_section",
"title": "Simple, transparent pricing",
"description": "A pricing section on a white background with three plan cards side by side; the middle card has a green border and a Most popular badge.",
"url": "https://cdn.octen.ai/octen-public-resource/data/design/web_page/8d2e5c41a07b93f6e1d4c28a5b90f3e7c6a1d2b4/s-004.png?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"thumbnail": "https://cdn.octen.ai/octen-public-resource/data/design/thumb/4a1c/4a1c9e07b52d83f6a0e1c7d94b28f5e3.jpg?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"source_page": "https://www.example-saas.com/pricing",
"width": 1440,
"height": 860,
"group": {
"group_id": "pg_8d2e5c41a07b93f6e1d4c28a5b90f3e7c6a1d2b4",
"type": "web_page",
"name": "Pricing | Example SaaS",
"position": 4,
"total": 9
},
"design_facts": {
"color": {
"background": {
"$type": "color",
"$value": {
"alpha": 1,
"colorSpace": "srgb",
"components": [
1,
1,
1
],
"hex": "#ffffff"
}
},
"text": {
"$type": "color",
"$value": {
"alpha": 1,
"colorSpace": "srgb",
"components": [
0.0627,
0.0941,
0.1569
],
"hex": "#101828"
}
},
"accent": {
"$type": "color",
"$value": {
"alpha": 1,
"colorSpace": "srgb",
"components": [
0.0863,
0.6392,
0.2902
],
"hex": "#16a34a"
}
}
},
"fontFamily": {
"heading": {
"$type": "fontFamily",
"$value": [
"Inter"
]
},
"body": {
"$type": "fontFamily",
"$value": [
"Inter"
]
}
},
"fontSize": {
"heading": {
"$type": "dimension",
"$value": {
"unit": "px",
"value": 40
}
},
"body": {
"$type": "dimension",
"$value": {
"unit": "px",
"value": 16
}
}
},
"radius": {
"default": {
"$type": "dimension",
"$value": {
"unit": "px",
"value": 12
}
}
}
},
"snippet": {
"format": "html",
"code": "<section class=\"pricing\"><h2 class=\"pricing-title\">Simple, transparent pricing</h2><div class=\"plans\"><div class=\"plan\">…</div></div></section>"
}
},
{
"type": "slide",
"title": "Market opportunity",
"description": "A slide with three nested circles on the left labeled TAM, SAM, and SOM, and a figure with a one-line note for each on the right.",
"url": "https://cdn.octen.ai/octen-public-resource/data/design/deck/3b7f0e92c4a1d85f6e2b9c07a3d4f1e8b5c26a9d0f7e3b1c4a8d2e6f9b0c5a7d/p-005.png?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"thumbnail": "https://cdn.octen.ai/octen-public-resource/data/design/thumb/9e5b/9e5b2c18f0a74d36b1e8c5a29d07f4b3.jpg?sdd=1&se=2026-11-19T13%3A00%3A00Z&sig=example",
"source_page": "https://www.example-startup.com/files/seed-deck.pptx",
"width": 1920,
"height": 1080,
"group": {
"group_id": "deck_3b7f0e92c4a1d85f6e2b9c07a3d4f1e8b5c26a9d0f7e3b1c4a8d2e6f9b0c5a7d",
"type": "deck",
"name": "Example Startup Seed Deck",
"position": 5,
"total": 14,
"master": {
"width": 1280,
"height": 720,
"majorFont": "Calibri Light",
"minorFont": "Calibri",
"palette": {
"dk1": "#000000",
"lt1": "#FFFFFF",
"dk2": "#0E2841",
"lt2": "#E8E8E8",
"accent1": "#156082",
"accent2": "#E97132",
"accent3": "#196B24",
"accent4": "#0F9ED5",
"accent5": "#A02B93",
"accent6": "#4EA72E",
"hlink": "#467886",
"folHlink": "#96607D"
}
}
},
"design_facts": {
"layoutFacts": {
"aspectRatio": 1.7778,
"elementCount": 12,
"imageCount": 0,
"textCount": 9
},
"styleFacts": {
"fontFamilies": [
"Calibri"
],
"fontSizes": [
"18pt",
"36pt"
],
"foregroundColors": [
"#0E2841"
]
},
"typographyMap": {
"title": {
"fontFamily": "Calibri Light",
"fontSizePt": 36,
"fontWeight": 400
},
"other": {
"color": "#0E2841",
"fontFamily": "Calibri",
"fontSizePt": 18,
"fontWeight": 400
}
}
}
}
],
"results": [
{
"title": "Pricing Page Design: 12 Patterns That Convert",
"url": "https://www.example-design-blog.com/pricing-page-patterns",
"highlight": "Three plans side by side, with the recommended plan raised and outlined, is the most common layout. Keep plan names short and put the price above the feature list.",
"authors": "Example Design Blog",
"time_published": "2026-09-08T00:00:00Z",
"time_last_crawled": "2026-11-02T06:15:00Z",
"favicon": "https://www.example-design-blog.com/favicon.ico",
"cover_image": {
"url": "https://img.example-design-blog.com/pricing-page-patterns/cover.png",
"description": "Three pricing cards side by side"
}
}
]
},
"meta": {
"usage": {
"num_search_queries": 1
},
"latency": 276
}
}{
"code": 400,
"msg": "Invalid params. Param images.count must be at most 100",
"request_id": "req_abc123def456"
}{
"code": 401,
"msg": "Invalid API Key",
"request_id": "req_abc123def456"
}{
"code": 403,
"msg": "Insufficient balance in account",
"request_id": "req_abc123def456"
}{
"code": 429,
"msg": "Exceeding the rate limit",
"request_id": "req_abc123def456"
}{
"code": 500,
"msg": "Internal error",
"request_id": "req_abc123def456"
}Authorizations
bearerAuthNoPaymentapiKeyAuthNoPayment
Body
application/json
Response
Successful design search response
Was this page helpful?