> ## 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.

# List map logs

> Your past maps with their settings, counts and credits.

## Request

```bash theme={null}
curl "https://api.spidra.io/api/map-logs?limit=20&page=1" \
  -H "Authorization: Bearer $SPIDRA_API_KEY"
```

## Response

Shortened to one log:

```json theme={null}
{
  "status": "success",
  "data": {
    "logs": [
      {
        "uuid": "c25cf706-80fa-4403-be7b-5a3b33afcb2a",
        "status": "success",
        "url": "https://docs.python.org/3/",
        "search": "asyncio",
        "sitemap_mode": "include",
        "url_limit": 20,
        "include_subdomains": false,
        "respect_robots": false,
        "total": 21,
        "scanned": 595,
        "sitemap_count": 7,
        "pages_count": 588,
        "message": null,
        "latency_ms": 9625,
        "credits_used": 1,
        "scraping_channel": "api",
        "created_at": "2026-10-25T03:19:23.000Z"
      }
    ],
    "total": 16
  }
}
```

`status` is `success`, `empty` (no URLs found, not charged) or `error`. The returned links are in [GET /map-logs/\{uuid}](https://docs.spidra.io/api-reference/logs/map-logs-detail.md).


## OpenAPI

````yaml GET /map-logs
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:
  /map-logs:
    get:
      tags:
        - Logs
      summary: List map logs
      description: Your past maps, newest first.
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Page number.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 10
            maximum: 100
          description: Logs per page.
      responses:
        '200':
          description: The logs.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    type: object
                    properties:
                      logs:
                        type: array
                        items:
                          type: object
                          additionalProperties: true
                      total:
                        type: integer
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.