> ## 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 Template Runs

> Your template runs, newest first, with their status and cost.

Lists your template runs, newest first, without their rows. Filter by template with `?template=google-maps-leads` and page with `page` and `limit`.

```bash theme={null}
curl "https://api.spidra.io/api/template-runs?template=google-maps-leads&limit=20" \
  -H "Authorization: Bearer $SPIDRA_API_KEY"
```

```json theme={null}
{
  "status": "success",
  "total": 3,
  "page": 1,
  "runs": [
    {
      "runId": "dfefa844-ad1f-4400-b127-dc17a186d9c2",
      "template": "google-maps-leads",
      "title": "Google Maps leads",
      "site": { "key": "google-maps", "name": "Google Maps", "domain": "google.com" },
      "presetId": null,
      "tool": "batch",
      "status": "completed",
      "inputs": { "query": "dentist", "areas": ["Lekki, Lagos"], "pages": 1, "findContacts": false, "language": "en" },
      "creditsUsed": 1,
      "rowCount": 20,
      "urlCount": 1,
      "createdAt": "2026-10-24T18:46:01.000Z",
      "finishedAt": "2026-10-24T18:46:05.000Z"
    }
  ]
}
```

Get a run's rows with [GET /template-runs/\{runId}](https://docs.spidra.io/api-reference/templates/get-run.md).


## OpenAPI

````yaml GET /template-runs
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:
  /template-runs:
    get:
      tags:
        - Templates
      summary: List Template Runs
      description: Your template runs, newest first, without their rows.
      parameters:
        - name: template
          in: query
          required: false
          schema:
            type: string
          description: Only runs of this template (slug).
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 100
          description: Runs per page.
      responses:
        '200':
          description: The runs.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  total:
                    type: integer
                  page:
                    type: integer
                  runs:
                    type: array
                    items:
                      type: object
                      properties:
                        runId:
                          type: string
                        template:
                          type: string
                        title:
                          type: string
                        site:
                          $ref: '#/components/schemas/TemplateSite'
                        presetId:
                          type:
                            - string
                            - 'null'
                        tool:
                          type: string
                        status:
                          type: string
                        inputs:
                          type: object
                          additionalProperties: true
                        creditsUsed:
                          type:
                            - number
                            - 'null'
                        rowCount:
                          type:
                            - integer
                            - 'null'
                        urlCount:
                          type:
                            - integer
                            - 'null'
                        createdAt:
                          type: string
                          format: date-time
                        finishedAt:
                          type:
                            - string
                            - 'null'
                          format: date-time
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TemplateSite:
      type:
        - object
        - 'null'
      properties:
        key:
          type: string
        name:
          type: string
        domain:
          type: string
      description: >-
        The site the template reads. Null for templates that work on any
        website.
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - error
        message:
          type: string
      required:
        - status
        - message
  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.