---
title: "List crawler runs"
method: GET
path: "/1/crawlers/{id}/crawl_runs"
tags: ["crawler"]
---

# List crawler runs

`GET /1/crawlers/{id}/crawl_runs`

The Crawler Logs feature lets you monitor and debug your crawler’s activity by recording
detailed logs for each crawl run. Logs are useful for troubleshooting crawl issues,
verifying site coverage, and monitoring crawler performance over time.

## Path parameters

- `id` string, required — Universally unique identifier (UUID) of the crawler.

## Query parameters

- `from` string — Unix string 'from' date.
- `until` string — Unix string 'until' date.
- `status` 'DONE' | 'SKIPPED' | 'FAILED' — Crawled URL status. For more information, see [Troubleshooting by crawl status](https://www.algolia.com/doc/tools/crawler/troubleshooting/crawl-status).
- `limit` integer — Limit of the query results.
- `offset` integer — Offset of the query results.
- `order` 'ASC' | 'DESC' — Order of the query.

## Response `200`

List Response of Crawler Logs.

- object
  - `logs` object[], required
    - `id` string — ID of the crawler log.
    - `configId` string — Crawler Config identifier.
    - `reindexId` string — Identifier of Reindex.
    - `fileSizeBytes` integer — Size of the compressed crawler log.
    - `uncompressedSizeBytes` integer — Size of the uncompressed crawler log.
    - `crawlStartedAt` string — Crawl started at date.
    - `crawlCompletedAt` string — Crawl started at date.
    - `fileCreatedAt` string — File created date.
    - `expiresAt` string — File expiration date.
    - `status` string — File status.
    - `accessCount` integer — File access count.
    - `lastAccessedAt` string, nullable — File last accessed date.
    - `urlsDone` integer — Crawler urls done.
    - `urlsSkipped` integer — Crawler urls skipped.
    - `urlsFailed` integer — Crawler urls failed.
  - `meta` object, required
    - `total` integer — Total of records found.

## Other responses

- `400` — Invalid request.
- `401` — Authorization information is missing or invalid.
- `403` — The user doesn't have enough rights on the specified Crawler, or it doesn't exists.

---

[API](https://skmtc.net/algolia/apis/crawler-api.md) · [All operations](https://skmtc.net/algolia/apis/crawler-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/algolia/crawler-api/versions/7f1df3bfe8bd/schema)