---
title: "Run Spider"
method: POST
path: "/spiders/{id}/run"
tags: ["Spiders"]
---

# Run Spider

`POST /spiders/{id}/run`

Run a task for the given spider

## Path parameters

- `id` string, objectid, required — Spider ID

## Request body

- RunSpiderInput
  - `cmd` string — Command
  - `mode` 'random' | 'all-nodes' | 'selected-nodes' | 'selected-node-groups' — Run mode: random,all-nodes,selected-nodes,selected-node-groups
  - `node_group_ids` string[] — Node group IDs, used in selected-node-groups mode
  - `node_ids` string[] — Node IDs, used in selected-nodes mode
  - `param` string — Parameters
  - `priority` integer — Priority
  - `schedule_id` string, objectid — Schedule ID

## Response `200`

OK

- ControllersResponseGoMongodbPrimitiveObjectID
  - `data` string[]
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

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