Firecrawl Agent Status

0 credits/call
ae_firecrawl_agent_status

Check the progress or retrieve the completed result of an existing Firecrawl agent job. Input: `id` (required string), the job ID returned by `firecrawl_agent`. It is the only accepted parameter; the schema does not impose a UUID format. Returns: a JSON object that may contain `id`, `success`, `status`, `progress`, `data` when completed, and `error` when unsuccessful. `success` describes the API call, not whether the research has finished. `processing` means the job is still running; `completed` and `failed` are terminal states. Failed jobs may return an incomplete best-effort `partial` result and `partialSchemaValid`; partial output must not be presented as a completed answer. Optional metadata includes `sources`, `message`, `mode`, `model`, `threadId`, `threadTurn`, `conversationId`, `suggestions`, `creditsUsed`, `expiresAt`, `stopReason`, `notice`, `exchange`, `pendingApproval`, and `agent_hints`. Availability varies, and some values may be null. `credit_limit_reached` indicates that a failed run reached its credit limit. Results are no longer readable after their expiration. Asynchronous behavior: the underlying research runs asynchronously, but each invocation of this tool performs one status/result lookup. It does not submit a job, wait until completion, or automatically poll. While the status is `processing`, check again after 15–30 seconds if time permits. Typical runs take roughly 1–3 minutes; complex research can take 5 minutes or more. These durations are estimates, not guarantees, and elapsed time alone does not establish failure. Stop completion polling on `completed` or `failed`. Limitations: read-only lookup for an existing job. It cannot start, modify, cancel, or resume research, accept provider terms, or approve paid calls. Approval-related fields only report information; no approval input is supported here. No prompt, polling-interval, or timeout parameter is exposed.

Productivity
0 credits/call

Pricing

0 credits/call
ConditionCharge
Each call0 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
idstringYesNo parameter description.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_firecrawl_agent_status' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "id": "01a19cd5-868c-71c8-9c9a-10b3d5f517f5"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "conversationId": "4f0dbfff-4b42-40e9-989e-fce581578e9d",
  "data": {
    "benchmarks": [
      {
        "name": "BrowseComp",
        "publisher": "OpenAI",
        "release_month": "2025-04",
        "sample_size": 1266,
        "url": "https://arxiv.org/abs/2504.12516"
      }
    ]
  },
  "message": "Collected three public 2025 agent benchmarks with official paper URLs and task/example counts.",
  "status": "completed",
  "success": true
}

This example shows part of the response. Copied content is valid JSON.