---
title: "List a site's FeelingSurfViewer screenshots"
method: GET
path: "/v1/sites/{id}/screenshots"
tags: ["Screenshots"]
---

# List a site's FeelingSurfViewer screenshots

`GET /v1/sites/{id}/screenshots`

## Request

- Base URL: `https://api.feelingsurf.fr`
- URL: `https://api.feelingsurf.fr/v1/sites/{id}/screenshots`
- Auth: HTTP bearer

Screenshots captured while the app surfed the site. Returns the most recent (up to 24); this list is not paginated.

## Path parameters

- `id` integer, required

## Response `200`

The site's screenshots.

- object
  - `data` Screenshot[]
    - `uid` string: Unique id for this visit's screenshot set.
    - `device` 'desktop' | 'mobile' | 'tablet': Device category the visit ran on.
    - `orientation` 'landscape' | 'portrait': Screen orientation.
    - `country_code` string, nullable: ISO country code of the visitor, or null.
    - `country_name` string, nullable: Localized country name, or null.
    - `visit_duration_seconds` integer: How long the visit lasted, in seconds.
    - `images` ScreenshotImage[]: The captured images, one per browser window.
      - `url` string: URL to fetch the screenshot image.
      - `preview_url` string, nullable: URL to fetch the blurred preview, or null.
      - `window` integer: Browser window index the image was captured from.
      - `width` integer: Image width in pixels.
      - `height` integer: Image height in pixels.
      - `delay_seconds` integer: Seconds into the visit when the image was captured.
      - `captured_at` string, date-time: When the image was captured.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The request is not allowed. A banned or disabled account is rejected with `forbidden`; a site setting your plan does not include is rejected with `premium_required`.
- `404`: Resource not found (or not owned by the caller).
- `429`: Too many requests — the per-account, per-minute rate limit was exceeded. Wait the number of seconds given in the `Retry-After` response header, then retry.

---

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