GET /v1/agent/job/{id}

Returns status and result of a single agent run by ID.

https://api.webcrawlerapi.com/v1/agent/job/{id}

Format: JSON
Method: GET

Path Parameters

• id - (required) Agent run ID returned by POST /v1/agent.

curl example

curl --request GET \
  --url https://api.webcrawlerapi.com/v1/agent/job/ar_abc123 \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

Response

{
    "id": "ar_abc123",
    "status": "done",
    "prompt": "Extract product names, prices, and descriptions",
    "model": "google/gemini-3.1-flash-lite-preview",
    "urls": ["https://example.com/products"],
    "max_spend_usd": 0.5,
    "balance_used_usd": 0.03,
    "data": [
        {
            "name": "Widget Pro",
            "price": 29.99,
            "description": "A high-quality widget"
        }
    ],
    "success": true,
    "created_at": "2025-01-01T00:00:00Z",
    "updated_at": "2025-01-01T00:01:30Z"
}

Response fields

• id — unique identifier of the agent run
• status — queued, processing, done, or failed
• prompt — prompt from the original request
• model — LLM model used
• urls — seed URLs provided
• max_spend_usd — spending cap set for this run
• balance_used_usd — actual amount spent
• data — extracted result data (present when status is done)
• success — true when run completed with non-empty data
• error — error message if run failed
• error_reason — machine-readable error reason
• trace — agent reasoning trace (if available)
• llm_requests — list of individual LLM calls made during the run
• created_at — ISO 8601 timestamp
• updated_at — ISO 8601 timestamp

Error Responses

• 401 Unauthorized - Invalid or missing API key
• 404 Not Found - Run not found or does not belong to your organization
• 500 Internal Server Error - Server-side error