Actions7
Overview
This node integrates with the Firecrawl API to retrieve data related to crawl jobs. Specifically, the "Get crawl status" operation fetches the current status of a specified crawl job by its unique Crawl ID. This is useful in scenarios where users need to monitor or track the progress and results of web crawling tasks initiated through Firecrawl.
Practical examples include:
- Checking if a crawl job has completed successfully.
- Retrieving intermediate status updates for long-running crawls.
- Automating workflows that depend on crawl completion before proceeding.
Properties
| Name | Meaning |
|---|---|
| Crawl ID | The unique identifier of the crawl job whose status you want to retrieve. |
| Use Custom Body | A boolean flag indicating whether to send a custom request body (true) or not (false). |
Output
The node outputs JSON data representing the status information of the requested crawl job. This typically includes fields such as the crawl's current state, progress metrics, timestamps, and any relevant metadata returned by the Firecrawl API.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the Firecrawl API.
- The base URL for the API can be configured via credentials; defaults to
https://api.firecrawl.dev/v2. - The node sends requests with JSON content type and expects JSON responses.
Troubleshooting
- Invalid Crawl ID: If the provided Crawl ID does not exist or is malformed, the API may return an error. Verify the Crawl ID format and ensure the crawl job exists.
- Authentication Errors: Missing or invalid API credentials will cause authentication failures. Ensure the API key credential is correctly set up.
- Network Issues: Connectivity problems or incorrect base URL configuration can prevent successful API calls.
- Custom Body Usage: Enabling "Use Custom Body" without providing a valid body might lead to unexpected errors. Use this option only if you intend to customize the request payload.
Links and References
- Firecrawl API Documentation (assumed official docs for further details)
- n8n Documentation on Creating Custom Nodes