> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a monitor's snapshot

> Returns what the monitor holds now: for each source, the rows (template and preset sources) or pages (URL sources) its last check saw, with when that was. Each check is compared with this, so it's the monitor's current view of the data. Use it to sync your own database, for example a job board's current jobs.

Free, and not rate limited. Before a source's first check finishes, it has `kind: "none"`.




## OpenAPI

````yaml GET /monitors/{monitorId}/snapshot
openapi: 3.1.0
info:
  title: Spidra API
  version: 1.0.0
  description: >-
    Public API endpoints for web scraping via Spidra. Authenticate with
    `Authorization: Bearer YOUR_API_KEY` or `x-api-key: YOUR_API_KEY`; both work
    on every endpoint.
servers:
  - url: https://api.spidra.io/api
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /monitors/{monitorId}/snapshot:
    get:
      tags:
        - Monitors
      summary: Get a monitor's snapshot
      description: >
        Returns what the monitor holds now: for each source, the rows (template
        and preset sources) or pages (URL sources) its last check saw, with when
        that was. Each check is compared with this, so it's the monitor's
        current view of the data. Use it to sync your own database, for example
        a job board's current jobs.


        Free, and not rate limited. Before a source's first check finishes, it
        has `kind: "none"`.
      parameters:
        - name: monitorId
          in: path
          required: true
          description: The monitor's `id`.
          schema:
            type: string
            format: uuid
          example: d6761e12-b011-4633-a593-fa6be2ef466c
        - name: source
          in: query
          required: false
          description: One source's `id`, to get only that source.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: The most rows (or pages) to return per source.
          schema:
            type: integer
            minimum: 1
            maximum: 5000
            default: 500
      responses:
        '200':
          description: The monitor's current data, per source, in the monitor's order.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  monitorId:
                    type: string
                    format: uuid
                  sources:
                    type: array
                    items:
                      type: object
                      properties:
                        sourceId:
                          type: string
                          description: The source's `id`.
                        label:
                          type: string
                          description: The source's label.
                        kind:
                          type: string
                          enum:
                            - rows
                            - pages
                            - none
                          description: >-
                            `rows` for template and preset sources, `pages` for
                            URL sources, `none` before the first check finishes.
                        updatedAt:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          description: When the last check saved this data.
                        rowCount:
                          type: integer
                          description: '`rows` only: how many rows the monitor holds.'
                        rows:
                          type: array
                          items:
                            type: object
                          description: '`rows` only: the rows, up to `limit`.'
                        pageCount:
                          type: integer
                          description: '`pages` only: how many pages.'
                        pages:
                          type: array
                          items:
                            type: object
                            properties:
                              url:
                                type: string
                              text:
                                type: string
                                description: The page's text as compared between checks.
                              fields:
                                type:
                                  - object
                                  - 'null'
                                description: >-
                                  The page's data, for pages a [popular
                                  site](/sites/overview) reader understands.
                          description: '`pages` only: the pages, up to `limit`.'
                        truncated:
                          type: boolean
                          description: >-
                            `true` when there were more rows or pages than
                            `limit`.
                        message:
                          type: string
                          description: '`none` only: why there''s nothing yet.'
              example:
                status: success
                monitorId: d6761e12-b011-4633-a593-fa6be2ef466c
                sources:
                  - sourceId: 4849f762b267
                    label: example.com
                    kind: pages
                    updatedAt: '2026-11-10T10:06:26.000Z'
                    pageCount: 1
                    pages:
                      - url: https://example.com
                        text: >-
                          Example Domain

                          This domain is for use in documentation examples
                          without needing permission.
                        fields: null
                    truncated: false
        '404':
          description: No monitor with this ID, or no source with that `source` ID.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.