---
title: "AI-Powered Web Analysis"
method: POST
path: "/v1/analyze"
tags: ["Analyze"]
---

# AI-Powered Web Analysis

`POST /v1/analyze`

Analyze any webpage using your own LLM API key (BYOK). Supports OpenAI and Anthropic. Optionally get structured JSON output via jsonSchema. Perfect for competitive intelligence, compliance audits, and data extraction.

## Request body

- AnalyzeRequest
  - `url` string, uri, required
  - `prompt` string, required — Analysis prompt for the LLM
  - `provider` 'openai' | 'anthropic'
  - `apiKey` string, required — Your own LLM provider API key (BYOK)
  - `model` string — Model override (e.g. gpt-4o, claude-sonnet-4-20250514)
  - `jsonSchema` object — JSON schema for structured LLM output
  - `timeout` integer
  - `waitFor` string
  - `blockAds` boolean
  - `blockCookieBanners` boolean
  - `includeScreenshot` boolean
  - `includeMetadata` boolean
  - `maxContentLength` integer

## Response `200`

Analysis complete

- AnalyzeResponse
  - `success` boolean
  - `url` string
  - `metadata` object
    - `url` string
    - `title` string
    - `description` string
  - `analysis` unknown
  - `provider` string
  - `model` string
  - `responseTime` integer

## Other responses

- `400` — Validation error
- `401` — Invalid SnapAPI key
- `502` — LLM provider error

---

[API](https://skmtc.dev/snapapi/apis/snapapi-screenshot-web-data-api.md) · [All operations](https://skmtc.dev/snapapi/apis/snapapi-screenshot-web-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snapapi/snapapi-screenshot-web-data-api/revisions/b12ff2791613/schema)