> ## 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 scrape log

> Returns one past scrape with its settings, cost and result. Use it to get a result after the scrape job has expired from [Get a scrape](/api-reference/scraping/scrape-status).




## OpenAPI

````yaml GET /scrape-logs/{uuid}
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`.
servers:
  - url: https://api.spidra.io/api
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /scrape-logs/{uuid}:
    get:
      tags:
        - Scrape Logs
      summary: Get a scrape log
      description: >
        Returns one past scrape with its settings, cost and result. Use it to
        get a result after the scrape job has expired from [Get a
        scrape](/api-reference/scraping/scrape-status).
      parameters:
        - name: uuid
          in: path
          required: true
          description: >-
            The log's `uuid` from [List scrape
            logs](/api-reference/scraping/scrape-logs). Not the scrape's
            `jobId`.
          schema:
            type: string
            format: uuid
          example: 6fba5c8e-22f5-40f7-a335-9f7c20faa799
      responses:
        '200':
          description: The scrape log with its result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    $ref: '#/components/schemas/ScrapeLogDetail'
              example:
                status: success
                data:
                  uuid: 6fba5c8e-22f5-40f7-a335-9f7c20faa799
                  status: success
                  started_at: '2026-10-25T04:16:33.000Z'
                  finished_at: '2026-10-25T04:16:38.000Z'
                  error_message: ''
                  urls:
                    - url: >-
                        https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html
                      actions: []
                  extraction_prompt: null
                  input_tokens: 0
                  output_tokens: 0
                  tokens_used: 0
                  captcha_solved_count: 0
                  scraped_sites_count: 1
                  ai_output_format: markdown
                  latency_ms: 5747
                  credits_used: 1
                  use_proxy: 0
                  proxy_country: null
                  scrape_mode: default
                  extract_content_only: 0
                  schema_json: null
                  screenshot: 0
                  full_page_screenshot: 0
                  page_title: A Light in the Attic | Books to Scrape - Sandbox
                  result_data: |-
                    [Books to Scrape](../../index.html) We love being scraped! 

                    * [Home](../../index.html)
                    * [Books](../category/books%5F1/index.html)
                    ...
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: There's no scrape log with this ID on your account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: error
                message: Log not found
        '500':
          description: The log couldn't be loaded. Try again.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: error
                message: Something went wrong loading this. Try again.
components:
  schemas:
    ScrapeLogDetail:
      description: One past scrape with its result.
      allOf:
        - $ref: '#/components/schemas/ScrapeLogSummary'
        - type: object
          properties:
            result_data:
              type:
                - string
                - object
                - array
                - 'null'
              description: >-
                The scrape's result, like `result.content` from [Get a
                scrape](/api-reference/scraping/scrape-status). Markdown as a
                string, or the extracted data with a `prompt` or `schema`.
    ErrorResponse:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
        message:
          type: string
          description: What went wrong, as a sentence you can show to a person.
        code:
          type: string
          description: >-
            A stable code for the error, when there is one, such as
            `JOB_NOT_FOUND` or `SERVICE_BUSY`. Branch on this rather than on
            `message`.
        errors:
          description: >-
            On validation errors (`422`), every problem with the request.
            Scrape, batch, crawl, map and search return a list of sentences.
            Templates, presets and monitors return `{ field, message }` objects.
          oneOf:
            - type: array
              items:
                type: string
            - type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                  message:
                    type: string
        retry_after:
          type: integer
          description: >-
            On `503 SERVICE_BUSY`, how many seconds to wait before sending the
            request again.
    ScrapeLogSummary:
      type: object
      description: >-
        One past scrape, as returned to an API key. Logs use snake_case field
        names. Flags such as `use_proxy` are `0` or `1`.
      properties:
        uuid:
          type: string
          format: uuid
          description: >-
            The log's ID. Not the same as the scrape's `jobId`. Use it with `GET
            /scrape-logs/{uuid}`.
        status:
          type: string
          enum:
            - success
            - error
            - in_progress
          description: >-
            `success` (finished), `error` (failed, `error_message` says why) or
            `in_progress` (still running).
        started_at:
          type: string
          format: date-time
          description: When the scrape started.
        finished_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When it finished. `null` while it runs.
        error_message:
          type:
            - string
            - 'null'
          description: Why the scrape failed. Empty or `null` when it didn't.
        urls:
          type: array
          description: The URLs scraped, each with the browser actions it ran.
          items:
            type: object
            properties:
              url:
                type: string
                description: The URL.
              actions:
                type: array
                items:
                  type: object
                description: >-
                  The browser actions sent for this URL. Empty when there were
                  none.
        extraction_prompt:
          type:
            - string
            - 'null'
          description: The `prompt` sent, if any.
        input_tokens:
          type: integer
          description: Tokens the AI read. `0` when no AI was used.
        output_tokens:
          type: integer
          description: Tokens the AI wrote.
        tokens_used:
          type: integer
          description: '`input_tokens` plus `output_tokens`.'
        captcha_solved_count:
          type: integer
          description: CAPTCHAs solved across all URLs.
        scraped_sites_count:
          type: integer
          description: How many URLs were read.
        ai_output_format:
          type: string
          enum:
            - markdown
            - json
          description: The scrape's `output`.
        latency_ms:
          type:
            - integer
            - 'null'
          description: How long the scrape took, in milliseconds.
        credits_used:
          type: integer
          description: Credits the scrape cost.
        use_proxy:
          type: integer
          enum:
            - 0
            - 1
          description: '`1` when Stealth Mode was on.'
        proxy_country:
          type:
            - string
            - 'null'
          description: The country the scrape browsed from, when Stealth Mode was on.
        scrape_mode:
          type: string
          enum:
            - default
            - fast
          description: The scrape's `scrapeMode`.
        extract_content_only:
          type: integer
          enum:
            - 0
            - 1
          description: '`1` when `extractContentOnly` was on.'
        schema_json:
          type:
            - string
            - 'null'
          description: The `schema` sent, as a JSON string, if any.
        screenshot:
          type: integer
          enum:
            - 0
            - 1
          description: '`1` when a screenshot was asked for.'
        full_page_screenshot:
          type: integer
          enum:
            - 0
            - 1
          description: '`1` when a full-page screenshot was asked for.'
        page_title:
          type:
            - string
            - 'null'
          description: The title of the page that was read.
  responses:
    Unauthorized:
      description: The API key is missing, wrong, or turned off.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missing:
              summary: No key sent
              value:
                status: error
                message: Missing authentication
            invalid:
              summary: Wrong or turned-off key
              value:
                status: error
                message: Invalid token or API key
  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.