Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Poll a crawl job.

服务器:https://openapi.felo.ai
客户端库

Firecrawl

​

Search, scrape, map, file parsing and asynchronous crawling.

Poll a crawl job.

​

Fetch a crawl job submitted by post_firecrawl_crawl, by its jobId. Returns the same envelope the submission returned — id, status, createdAt, completedAt, pricing, output, error. Repeat until status is completed, failed or cancelled; on success output is an array of pages with markdown and metadata. This tool only reads a job — it cannot start one.

路径参数
  • jobId
    类型: string
    必填

    The job id returned by the submit call.

响应
  • 200
    类型: object · AsyncJob

    The current state of the crawl job.

    An asynchronous integration job. Returned by the submit call (HTTP 202) and by the poll/detail call. Poll the job by its id until status is a terminal value (completed, failed, or cancelled).

    • completedAt
      类型: string 格式: date-time可为 null

      When the job reached a terminal status. Null while the job is still queued or running.

    • createdAt
      类型: string 格式: date-time

      When the job was accepted.

    • endpoint
      类型: string

      Provider operation identifier stored with the job. This metadata is not a Felo polling URL; use the documented Felo job path or Location header.

    • error
      类型: object 可为 null

      Present when status is failed. Null otherwise.

      • code
        类型: string

        Machine-readable error code.

      • message
        类型: string

        Human-readable error message.

    • id
      类型: string

      Job identifier. Use it with the corresponding Felo polling endpoint.

    • object
      类型: string

      Always "integration_async_job".

    • output
      可为 null

      Job result payload. Present only once status is completed. For Agent Runs this is the structured research result.

    • outputExpired
      类型: boolean

      True when the result has been retained past its retention window and is no longer retrievable.

    • pricing
      类型: object
      • authorizedMicrosUSD
        类型: integer

        Provider authorization metadata in micro-USD. This is not a Felo credit hold or billing record.

      • billingMode
        类型: string

        Provider job billing mode. Felo charges follow Felo billing records.

      • currency
        类型: string
      • finalMicrosUSD
        类型: integer 可为 null

        Provider settlement metadata in micro-USD, nullable before settlement. This is not the Felo charge.

    • status
      类型: string 枚举

      Customer-facing lifecycle status. queued and running are non-terminal; completed, failed, and cancelled are terminal.

      值
      • queued
      • running
      • completed
      • failed
      • cancelled
    application/json
  • 400

    The request could not be processed. Check the request parameters.

  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/firecrawl/crawl/{jobId}
curl 'https://openapi.felo.ai/v1/beta/firecrawl/crawl/{jobId}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "iaj_01HZY8Q2M4K7N9V3T6W1X0B2C3",
  "object": "integration_async_job",
  "endpoint": "/apis/v1/exa/agent/runs",
  "status": "queued",
  "createdAt": "2026-09-30T03:09:45.799Z",
  "completedAt": "2026-09-30T03:09:45.799Z",
  "pricing": {
    "currency": "USD",
    "authorizedMicrosUSD": 1,
    "finalMicrosUSD": 1,
    "billingMode": "flat_per_call"
  },
  "output": null,
  "outputExpired": true,
  "error": {
    "code": "string",
    "message": "string"
  }
}
Poll a crawl job.