Cancel a Crawl Job
Cancel a running crawl job.
Coming soon
This endpoint is documented but not yet available in production. The contract below reflects the planned behavior. Reach out via support for early access or launch notification.
DELETE /v1/crawl/{job_id} cancels a crawl that is still queued or processing. Cancellation stops new pages from being scheduled. Pages already in flight may continue briefly while they drain.
Use this endpoint when a crawl is too broad, was started by mistake, or no longer needs to finish.
Request
Replace the example job ID with the crawl job_id you want to cancel.
export SCRAPER_API_BASE_URL="https://scraper.geonode.io"
export GEONODE_SCRAPER_API_KEY="YOUR_API_KEY"
curl -X DELETE "$SCRAPER_API_BASE_URL/v1/crawl/9d7b2c8e-8a4b-4c10-9af3-65f4f8f6c019" \
-H "X-Api-Key: $GEONODE_SCRAPER_API_KEY"Response
A successful cancellation returns 202 with the cancelled job ID and the number of pages still draining.
{
"job_id": "9d7b2c8e-8a4b-4c10-9af3-65f4f8f6c019",
"status": "cancelled",
"status_url": "/v1/crawl/9d7b2c8e-8a4b-4c10-9af3-65f4f8f6c019",
"in_flight_pages": 0
}If the job is already completed or cannot be cancelled in its current state, the API can return 409.