Skip to main content
GET
/
v1
/
crawl
cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v1/crawl" \
  -H "x-api-key: $CATALOG_API_KEY"

# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v1/crawl?status=completed" \
  -H "x-api-key: $CATALOG_API_KEY"

# Get first 50 executions
curl -X GET "https://api.getcatalog.ai/v1/crawl?limit=50" \
  -H "x-api-key: $CATALOG_API_KEY"

{
  "executions": [
    {
      "execution_id": "crawl-skims-com-9b68e2c1",
      "status": "processing",
      "created_at": "2026-01-09T23:05:29.401291+00:00"
    }
  ]
}
When to use: Monitor all your crawl operations in one place. Use this endpoint to:
  • See all crawl executions you’ve started
  • Filter by status (processing, completed, failed)
  • Track when crawls were initiated
  • Find execution IDs for status checks

​
Request

​
x-api-key
string
required
Your API key for authentication

​
Query Parameters

​
status
string
Filter executions by status. Possible values: "processing", "completed", "failed"Note: If not provided, all executions are returned regardless of status.
​
limit
number
Number of executions to return (default: 20)Note: Executions are returned in reverse chronological order (most recent first).

​
Response

​
executions
array
Array of execution summary objects
cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v1/crawl" \
  -H "x-api-key: $CATALOG_API_KEY"

# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v1/crawl?status=completed" \
  -H "x-api-key: $CATALOG_API_KEY"

# Get first 50 executions
curl -X GET "https://api.getcatalog.ai/v1/crawl?limit=50" \
  -H "x-api-key: $CATALOG_API_KEY"

{
  "executions": [
    {
      "execution_id": "crawl-skims-com-9b68e2c1",
      "status": "processing",
      "created_at": "2026-01-09T23:05:29.401291+00:00"
    }
  ]
}