---
title: "Read one public page and learn its records and fields from 3 to 8 example rows. The preview explains how each field was inferred and marks the example rows. Nothing becomes a list until you save it."
method: POST
path: "/v1/imports/web/sources"
---

# Read one public page and learn its records and fields from 3 to 8 example rows. The preview explains how each field was inferred and marks the example rows. Nothing becomes a list until you save it.

`POST /v1/imports/web/sources`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/imports/web/sources`
- Auth: API key in header `Authorization`

## Request body

- TeachWebSource
  - `url` string, required
  - `name` string, required
  - `name_column` string
  - `examples` object[], required
  - `exclude` string[]
  - `project_id` string, nullable

## Response `201`

Read one public page and learn its records and fields from 3 to 8 example rows. The preview explains how each field was inferred and marks the example rows. Nothing becomes a list until you save it.

- object
  - `data` WebSourcePreview, required
    - `source_id` string, required
    - `preview_id` string, required
    - `preview_hash` string, required
    - `name` string, required
    - `source_url` string, required
    - `source_sha256` string, required
    - `fetched_at` string, required
    - `headers` string[], required
    - `name_column` string, required
    - `rows` WebSourceRow[], required
      - `id` string, required
      - `provided` object, required
      - `cells` object, required
      - `missing` string[]
      - `example` boolean
    - `count` integer, required
    - `missing_cells` integer, required
    - `reuse` 'local_relationships' | 'same_snapshot_only', required
    - `notice` string, required
    - `explanation` WebSourceExplanation: What the customer reviews before saving: what was learned, from what, and what a changed page does to it.
      - `example_rows` integer, required
      - `inferred_rows` integer, required
      - `left_out` string[]
      - `fields` WebSourceFieldExplanation[], required
        - `column` string, required
        - `relationship` 'anchor' | 'same_element' | 'within_record' | 'positional_example', required
        - `how` string, required
        - `on_change` string, required
        - `pattern` string
        - `found` integer
        - `missing` integer
      - `on_change` string, required
      - `page_kept_until` string, nullable
    - `qualification_authority` false

## Other responses

- `default`: Error envelope

---

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