> ## 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 Search Log Details

> Retrieve the full details of a single search log, including the original query and the complete result set.

This endpoint returns everything about a single search.

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.spidra.io/api/search-logs/log-uuid-1 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.spidra.io/api/search-logs/log-uuid-1",
      headers={"Authorization": "Bearer YOUR_API_KEY"}
  )
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.spidra.io/api/search-logs/log-uuid-1",
    { headers: { Authorization: "Bearer YOUR_API_KEY" } }
  );
  ```
</CodeGroup>

## Response Fields

| Field           | Type           | Description                                                               |
| --------------- | -------------- | ------------------------------------------------------------------------- |
| `uuid`          | string         | Unique identifier for this log record                                     |
| `status`        | string         | `success`, `error`, or `in_progress`                                      |
| `started_at`    | string         | ISO 8601 timestamp when the search started                                |
| `finished_at`   | string or null | ISO 8601 timestamp when the search completed                              |
| `query`         | string         | The original search query                                                 |
| `sources`       | string or null | Comma-separated list of sources requested (e.g. `"web,news"`)             |
| `country`       | string or null | The `country` value from the original request, if any                     |
| `result_limit`  | number or null | The `limit` value from the original request                               |
| `error_message` | string or null | Details about the failure if `status` is `error`                          |
| `latency_ms`    | number or null | Total duration of the search in milliseconds                              |
| `credits_used`  | number         | Credits deducted from your account                                        |
| `result_data`   | object or null | The full result set, shaped like `result.data` in the job-status response |

## Example Response

```json theme={null}
{
  "status": "success",
  "data": {
    "uuid": "log-uuid-1",
    "status": "success",
    "started_at": "2026-09-13T23:10:17Z",
    "finished_at": "2026-09-13T23:10:21Z",
    "query": "how do airplanes fly",
    "sources": "web",
    "country": null,
    "result_limit": 10,
    "error_message": null,
    "latency_ms": 4041,
    "credits_used": 1,
    "result_data": {
      "web": [
        { "title": "Dynamics of Flight", "url": "https://www.grc.nasa.gov/...", "position": 1 }
      ]
    }
  }
}
```


## OpenAPI

````yaml GET /search-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:
  /search-logs/{uuid}:
    get:
      tags:
        - Search
      summary: Get Search Log Details
      parameters:
        - name: uuid
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Full search log record, including result_data
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    $ref: '#/components/schemas/SearchLogDetail'
        '404':
          description: Log not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: error
                message: Search log not found
components:
  schemas:
    SearchLogDetail:
      allOf:
        - $ref: '#/components/schemas/SearchLogSummary'
        - type: object
          properties:
            result_data:
              type: object
              nullable: true
              description: The full result set, shaped like SearchResult.data
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - error
        message:
          type: string
      required:
        - status
        - message
    SearchLogSummary:
      type: object
      properties:
        uuid:
          type: string
        status:
          type: string
          enum:
            - success
            - error
            - in_progress
        started_at:
          type: string
        finished_at:
          type: string
          nullable: true
        query:
          type: string
        sources:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
        result_limit:
          type: integer
          nullable: true
        error_message:
          type: string
          nullable: true
        latency_ms:
          type: integer
          nullable: true
        credits_used:
          type: integer
        scraping_channel:
          type: string
          nullable: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````