---
title: "Fetch Specialized Data"
method: POST
path: "/data/web/fetch"
tags: ["Data APIs", "Data fetch"]
---

# Fetch Specialized Data

`POST /data/web/fetch`

## Request

- Base URL: `https://api.notte.cc` (the document declares no server; this is the origin it was published from)
- URL: `https://api.notte.cc/data/web/fetch`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

## Headers

- `X-Notte-Cache-Mode` string, nullable: Extraction cache: default, refresh, or bypass.
- `X-Notte-Cache-Max-Age-Ms` string, nullable: Maximum cached result age in milliseconds; zero forces refresh.
- `X-Notte-Cache-Ttl-Seconds` string, nullable: Shorten the server storage TTL; zero bypasses caching.
- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Request body

- DataScrapeRequest
  - `url` string, uri, required
  - `formats` ScrapeFormats, required
    - `html` boolean
    - `markdown` boolean
    - `product` boolean
    - `parse` boolean
  - `productParams` ProductParams
    - `dedupeImages` boolean
  - `markdownParams` MarkdownParams
    - `includeLinks` boolean
    - `includeImages` boolean
    - `inlineImages` 'placeholder' | 'preserve', nullable
  - `parseParams` MapsParseParams
    - `type` 'prebuilt', required
    - `parser` 'google-maps', required
  - `sharedParams` SharedParams
    - `theme` 'light' | 'dark'
    - `actions` union[]
      - union
        - NotteApiDataApisMonitorsModelsWaitAction
          - `do` 'wait', required
          - `timeMs` integer, required
        - PerformAction
          - `do` 'perform', required
          - `action` string, required
        - ScrollAction
          - `do` 'scroll', required
          - `direction` 'up' | 'down' | 'left' | 'right'
          - `amount` union
            - integer
            - 'viewport' | 'max'
          - `container` string, nullable
          - `maxScrolls` integer
    - `waitFor` union
      - integer
      - string
    - `mainContentOnly` boolean
    - `includeSelectors` string[]
    - `excludeSelectors` string[]
  - `timeoutOpts` StyleguideTimeout
    - `milliseconds` integer, required
    - `behavior` 'fail' | 'return-partial'
  - `maxAgeMs` integer, nullable: Maximum cached result age in milliseconds. Omit for server policy; zero forces fresh extraction.
  - `zdr` 'enabled' | 'disabled'
  - `tags` string[]

## Response `200`

Successful Response

- ScrapeResponse
  - `url` string, required
  - `html` ScrapeOutput
  - `markdown` ScrapeOutput
  - `screenshot` ScrapeOutput
  - `images` ScrapeOutput
  - `bytes` ScrapeOutput
  - `parsed` ParsedOutput
  - `highlights` ScrapeOutput
  - `json` ScrapeOutput
  - `product` ScrapeOutput
  - `profile` unknown
  - `metadata` object
  - `request_id` string, required
  - `cache_metadata` object
  - `isPartial` boolean

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-18** `20f8ac8dc733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/notte/apis/notte-api/changes/data/web/fetch/post.md)

---

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