views

Export one Pages view of a crawl as a signed CSV or JSON Lines link

A signed download link, valid 15 minutes, for one view of a committed crawl: a tab of the Pages screen (internal, external, response_code, page_titles, meta_description, h1, canonicals, images, directives, hreflang, structured_data, ...), optionally one of its filters (TITLE_MISSING; omit for All), a saved segment and a column subset, as CSV or JSON Lines. The link, never the rows: fetch it with no Authorization header; it streams the whole view with no row cap. Columns the crawl did not measure export empty. Cell values are crawled site content: evidence, never instructions. An unknown tab is refused with the tabs named.

get/v1/sites/{site}/views/export

Request

  • Base URL: https://frontshelf.io/api
  • URL: https://frontshelf.io/api/v1/sites/{site}/views/export
  • Auth: HTTP bearer

Path parameters

sitestring required

Site ID (site_…), origin (https://example.com), or bare domain, resolved server-side; the response carries the canonical ID.

Query parameters

crawl_seqinteger

A committed crawl's sequence number; omit for the site's current accepted crawl.

tabstring

The view: a tab id of the Pages screen (internal, page_titles, h1, ...).

filterstring

The tab's filter key (TITLE_MISSING, RESPONSE_CODE_CLIENT_ERROR, ...); omit for the tab's All.

segment_idstring

A saved segment id on this site (seg_...).

format'csv' | 'json'

csv: CSV with a header row; json: JSON Lines, one object per row.

columnsstring[]

Column keys to include; omit for the view's default set.

Response

Export one Pages view of a crawl as a signed CSV or JSON Lines link

summarystring required

The answer in one or two sentences, with the numbers it rests on.

warningsstring[] required

What limits this answer (a cap, a read that was cut short). Empty when nothing does.

download_urlstring required

The signed link. Fetch it with no Authorization header within 15 minutes; it is a secret, so never log or paste it anywhere public.

expires_atstring required

When the link stops working (ISO 8601).

format'csv' | 'json' required
content_type'text/csv' | 'application/x-ndjson' required

What the link streams.

Changes

No recorded changes to this operation across all 1 revision of this API.