# Enviar um job de scrape em lote assíncrono.

**API:** Data API

**Endpoint:** `POST /v1/beta/firecrawl/batch-scrape`

**Tags:** Firecrawl

Envia um scrape em lote assíncrono. Informe urls; opcionalmente, as opções de scrape documentadas. Idempotency-Key é obrigatório. HTTP 202 retorna um job; use seu id com o endpoint de consulta correspondente da Felo até completed, failed ou cancelled. Os campos de preço do job são metadados de autorização e liquidação do provedor, não registros de cobrança da Felo.

### Referência de preços

- Medição: referência por resultado medido.
- Estimativa de referência por requisição indisponível.
- Preço unitário de referência do cliente: USD 0.005.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `Idempotency-Key` | header | yes | string | O comprimento UTF-8 aparado deve ser de 1 a 191 bytes. |

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "additionalProperties": false,
  "properties": {
    "excludeTags": {
      "items": {
        "description": "Não vazio após remover espaços; sem CR/LF; o comprimento em bytes UTF-8 é limitado. Comprimento máximo em UTF-8: 128 bytes.",
        "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
        "type": "string"
      },
      "maxItems": 50,
      "type": [
        "array",
        "null"
      ]
    },
    "includeTags": {
      "items": {
        "description": "Não vazio após remover espaços; sem CR/LF; o comprimento em bytes UTF-8 é limitado. Comprimento máximo em UTF-8: 128 bytes.",
        "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])",
        "type": "string"
      },
      "maxItems": 50,
      "type": [
        "array",
        "null"
      ]
    },
    "maxAge": {
      "maximum": 31536000000,
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "maxConcurrency": {
      "maximum": 20,
      "minimum": 1,
      "type": [
        "integer",
        "null"
      ]
    },
    "minAge": {
      "maximum": 31536000000,
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "onlyMainContent": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "timeout": {
      "maximum": 300000,
      "minimum": 1000,
      "type": [
        "integer",
        "null"
      ]
    },
    "urls": {
      "description": "As URLs também devem ser exclusivas após remover espaços em branco e barras finais.",
      "items": {
        "description": "URL HTTPS com um nome de host, sem credenciais nem fragmento. Entradas sem espaços nas extremidades terminadas em .pdf (sem diferenciar maiúsculas de minúsculas) não são suportadas.",
        "pattern": "^\\s*[hH][tT][tT][pP][sS]://",
        "type": "string"
      },
      "maxItems": 1000,
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    }
  },
  "required": [
    "urls"
  ],
  "type": "object"
}
```

Example:

```json
{
  "urls": [
    "https://example.com"
  ]
}
```

## Responses

### 202 — Sucesso

Headers:
- `X-Request-Id` (string) — Identificador da requisição a incluir ao contatar o suporte da Felo.

**application/json**

Schema: object

```json
{
  "properties": {
    "completedAt": {
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "createdAt": {
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "endpoint": {
      "type": [
        "string",
        "null"
      ],
      "description": "Identificador de operação do provedor; use o caminho de job documentado da Felo para o polling."
    },
    "error": {
      "properties": {
        "code": {
          "type": [
            "string",
            "null"
          ]
        },
        "message": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": [
        "object",
        "null"
      ]
    },
    "id": {
      "type": [
        "string",
        "null"
      ]
    },
    "object": {
      "const": "integration_async_job",
      "type": "string"
    },
    "output": {},
    "outputExpired": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "pricing": {
      "properties": {
        "authorizedMicrosUSD": {
          "type": [
            "integer",
            "null"
          ]
        },
        "billingMode": {
          "type": [
            "string",
            "null"
          ]
        },
        "currency": {
          "type": [
            "string",
            "null"
          ]
        },
        "finalMicrosUSD": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "type": [
        "object",
        "null"
      ],
      "description": "Metadados de autorização e liquidação do provedor em micro-USD; não é saldo, retenção nem recibo de cobrança da Felo."
    },
    "status": {
      "enum": [
        "queued",
        "running",
        "completed",
        "failed",
        "cancelled"
      ],
      "type": "string"
    }
  },
  "required": [
    "completedAt",
    "createdAt",
    "endpoint",
    "error",
    "id",
    "object",
    "output",
    "pricing",
    "status"
  ],
  "type": "object"
}
```

### 400 — Não foi possível processar a requisição. Verifique os parâmetros da requisição.

### 401 — É necessária uma chave de API da Felo válida.

### 402 — A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

### 403 — A conta não tem permissão para realizar esta operação.

### 429 — Um limite de requisições ou de gastos foi atingido.

### 502 — O serviço não pôde concluir a requisição.

### 503 — A API ou o serviço de cobrança está temporariamente indisponível.

### 504 — O serviço atingiu o tempo limite ao processar a requisição.

### default — A operação falhou. Guarde o ID de requisição da resposta ao contatar o suporte da Felo.
