> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Referência da API do Firecrawl (v2)

<Note>
  **Para agentes de IA:** Use [llms.txt](/pt-BR/llms.txt) para acessar um índice completo de toda a documentação.
</Note>

A API do Firecrawl oferece acesso programático a dados da web. Todos os endpoints compartilham uma URL base comum, um esquema de autenticação e um formato de resposta descritos nesta página.

<div id="features">
  ## Recursos
</div>

<CardGroup cols={3}>
  <Card title="Scrape" icon="markdown" href="/pt-BR/api-reference/endpoint/scrape" color="FF713C">
    Extraia conteúdo de qualquer página da web em formato Markdown ou JSON.
  </Card>

  <Card title="Parse" icon="markdown" href="/pt-BR/api-reference/endpoint/parse" color="FF713C">
    Envie arquivos e converta-os em Markdown ou outros formatos.
  </Card>

  <Card title="Crawl" icon="spider" href="/pt-BR/api-reference/endpoint/crawl-post" color="FF713C">
    Faça o rastreamento de sites inteiros e obtenha conteúdo de todas as páginas.
  </Card>

  <Card title="Map" icon="map" href="/pt-BR/api-reference/endpoint/map" color="FF713C">
    Obtenha rapidamente uma lista completa de URLs de qualquer site, de forma confiável.
  </Card>

  <Card title="Search" icon="magnifying-glass" href="/pt-BR/api-reference/endpoint/search" color="FF713C">
    Pesquise na web e obtenha o conteúdo completo das páginas em qualquer formato.
  </Card>
</CardGroup>

<div id="agentic-features">
  ## Recursos de agentes
</div>

<CardGroup cols={3}>
  <Card title="Agent" icon="robot" href="/pt-BR/api-reference/endpoint/agent" color="FF713C">
    Coleta autônoma de dados da web com IA.
  </Card>

  <Card title="Browser" icon="browser" href="/pt-BR/api-reference/endpoint/browser-create" color="FF713C">
    Crie e controle sessões de navegador para tarefas interativas na web.
  </Card>
</CardGroup>

<div id="base-url">
  ## URL base
</div>

Todas as requisições usam a seguinte URL base:

```bash theme={null}
https://api.firecrawl.dev
```

<div id="authentication">
  ## Autenticação
</div>

Toda requisição exige um cabeçalho `Authorization` com sua chave de API:

```bash theme={null}
Authorization: Bearer fc-YOUR-API-KEY
```

Inclua este cabeçalho em todas as chamadas à API. Você pode encontrar sua chave de API no [painel do Firecrawl](https://www.firecrawl.dev/app/api-keys).

Se você for um agente sem uma chave de API, comece em [Obter credenciais](/pt-BR/ai-onboarding#get-credentials). Se sua plataforma oferecer suporte a WorkOS ID-JAG, use [`auth.md`](https://www.firecrawl.dev/auth.md) para obter instruções de registro.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Authorization: Bearer fc-YOUR-API-KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://example.com"}'
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

  result = firecrawl.scrape("https://example.com")
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

  const result = await firecrawl.scrape('https://example.com');
  ```
</CodeGroup>

<div id="response-codes">
  ## Códigos de resposta
</div>

O Firecrawl usa códigos de status HTTP convencionais para indicar o resultado das suas requisições. Códigos na faixa `2xx` indicam sucesso, códigos `4xx` indicam erros do cliente e códigos `5xx` indicam erros do servidor.

Consulte [Erros](/pt-BR/api-reference/errors) para ver a referência completa, incluindo a string `error` retornada para cada tipo de falha, orientações sobre novas tentativas e um snippet de backoff pronto para copiar e colar.

<div id="429-responses">
  ## Respostas 429
</div>

Quando você excede os limites de taxa ou de concorrência do seu plano, a API retorna um código de status `429`. Consulte [Rate Limits](/pt-BR/rate-limits) para ver os limites por plano e [Errors](/pt-BR/api-reference/errors) para orientações sobre novas tentativas.