---
title: "Get web crawl job results"
method: GET
path: "/api/web/crawl/{id}"
---

# Get web crawl job results

`GET /api/web/crawl/{id}`

Retrieves the status and results of a web crawl job. Results are paginated.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `batchSize` integer

## Response `200`

Web crawl job details retrieved successfully

- WebCrawlJobResponse
  - `jobId` string, uuid, required
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'stopped', required
  - `error` string, nullable
  - `totalPages` integer
  - `totalPageBatches` integer
  - `currentPageBatch` integer
  - `batchSize` integer
  - `data` WebCrawlPageData[]
    - `url` string, required
    - `status` 'completed' | 'failed' | 'pending' | 'running', required
    - `error` string, nullable
    - `metadata` object
    - `markdown` string
    - `html` string
    - `links` string[]
    - `screenshot` string
    - `json` object
    - `branding` BrandingProfile — Visual brand profile extracted via DOM analysis + LLM enhancement. All fields optional; the server may return a partial profile when the LLM refuses or fails.
      - `colorScheme` string — Page color scheme. Common values: light, dark.
      - `colors` object — Color role assignments. Common keys: primary, secondary, accent, background, textPrimary, textSecondary, link.
      - `fonts` object[] — Cleaned brand fonts with roles.
        - `family` string
        - `role` string
      - `typography` object — Font families, stacks, and sizes. Keys: fontFamilies, fontStacks, fontSizes, lineHeights, fontWeights.
      - `spacing` object — Spacing scale. Common keys: baseUnit, borderRadius, padding, margins, gridGutter.
      - `components` object — Per-component style dictionaries. Common keys: buttonPrimary, buttonSecondary, input. Each value has background, textColor, borderColor, borderRadius, borderRadiusCorners, shadow.
      - `images` object — Brand images. Common keys: logo, logoHref, logoAlt, favicon, ogImage.
      - `personality` object — Brand personality. Common keys: tone, energy, targetAudience.
      - `designSystem` object — Detected design system. Common keys: framework, componentLibrary.
      - `confidence` object — Confidence scores (0-1). Common keys: buttons, colors, overall.

## Other responses

- `404` — Crawl job not found
- `500` — Server error

---

[API](https://skmtc.net/hyperbrowser/apis/hyperbrowser-api.md) · [All operations](https://skmtc.net/hyperbrowser/apis/hyperbrowser-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperbrowser/hyperbrowser-api/versions/69aa004ce41b/schema)