# firecrawl.web.crawl.status

Crawl progress, credits used and pages by job id

> Get the status of a crawl job

Page: https://telipot.com/catalog/tasks/firecrawl.web.crawl.status · Markdown: https://telipot.com/catalog/tasks/firecrawl.web.crawl.status/md · JSON: https://telipot.com/catalog/tasks/firecrawl.web.crawl.status/json

| Field | Value |
| --- | --- |
| provider | [Firecrawl](https://telipot.com/catalog/providers/firecrawl) `firecrawl` |
| capability | [`web.crawl.status`](https://telipot.com/catalog/capabilities/web.crawl.status) |
| kind | data |
| tier | core |
| price | Free (Free from the tool) |
| identity | Your plan |
| auth | `bearer · Authorization: Bearer` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `GET https://api.firecrawl.dev/v2/crawl/{id}` |
| verification | Untestable. needs the id of a job that costs credits to start |
| status | live |
| docs | https://docs.firecrawl.dev/api-reference/endpoint/crawl-get |

## Preview the price · nothing runs

```bash
telipot run firecrawl.web.crawl.status \
  --input-json '{"id":"123e4567-e89b-12d3-a456-426614174000"}' \
  --quote
```

## Run it

```bash
telipot run firecrawl.web.crawl.status \
  --input-json '{"id":"123e4567-e89b-12d3-a456-426614174000"}'
```

```bash
curl https://api.telipot.com/v1/tasks/firecrawl.web.crawl.status/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"123e4567-e89b-12d3-a456-426614174000"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `id` | pathParams | string | yes |  | The ID of the crawl job (a UUID) |
| `skip` | queryParams | integer | no | at least 0 | Offset into the pages, as in the next URL of a truncated response; the docs describe it, the OpenAPI document does not list it |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the crawl job (a UUID)",
      "examples": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    },
    "skip": {
      "type": "integer",
      "description": "Offset into the pages, as in the next URL of a truncated response; the docs describe it, the OpenAPI document does not list it",
      "minimum": 0
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "status",
    "total",
    "completed",
    "creditsUsed"
  ],
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "scraping",
        "completed",
        "failed",
        "cancelled"
      ]
    },
    "total": {
      "type": "integer",
      "description": "Pages completed or still in flight, failed pages excluded"
    },
    "completed": {
      "type": "integer",
      "description": "Pages crawled so far"
    },
    "creditsUsed": {
      "type": "integer",
      "description": "Credits the crawl has used so far"
    },
    "expiresAt": {
      "type": "string"
    },
    "createdAt": {
      "type": "string"
    },
    "completedAt": {
      "type": "string",
      "description": "Present only once the crawl has ended"
    },
    "duration": {
      "type": "number",
      "description": "Seconds"
    },
    "next": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL of the next 10MB of pages; absent or null at the end, but also set while the crawl runs"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "markdown": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "properties": {
              "title": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                ]
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                ]
              },
              "sourceURL": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "statusCode": {
                "type": "integer"
              },
              "error": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      }
    }
  }
}
```