---
title: "List Crawl Jobs"
method: GET
path: "/site-crawl"
tags: ["site-crawl"]
---

# List Crawl Jobs

`GET /site-crawl`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/site-crawl`
- Auth: API key in header `X-Agent-Key`

## Query parameters

- `limit` integer
- `site_id` string, uuid, nullable
- `email` string, nullable

## Response `200`

Successful Response

- CrawlJobListResponse
  - `jobs` CrawlJobStatus[]
    - `job_id` string, required
    - `seed_url` string, required
    - `status` 'queued' | 'running' | 'completed' | 'partial' | 'failed' | 'cancelled', required
    - `stage` string
    - `status_detail` string, nullable
    - `pages_crawled` integer
    - `pages_discovered` integer
    - `counts` CrawlCounts
      - `fetched_pages` integer
      - `recorded_urls` integer
      - `not_fetched_urls` integer
    - `errors_count` integer
    - `health_score` number, nullable
    - `health_breakdown` object, nullable
    - `coverage` object, nullable
    - `error_message` string, nullable
    - `retry_count` integer
    - `last_heartbeat_at` string, date-time, nullable
    - `dispatch_required` boolean
    - `started_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `created_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)