# Introdução

> Referência da API do Firecrawl

<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="Crawl" icon="spider" href="/pt-BR/api-reference/endpoint/crawl-post" color="FF713C">
    Faça o crawl de sites inteiros e extraia seu conteúdo e metadados.
  </Card>

  <Card title="Map" icon="map" href="/pt-BR/api-reference/endpoint/map" color="FF713C">
    Obtenha, de forma rápida e confiável, uma lista completa de URLs de qualquer site.
  </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 da página em qualquer formato.
  </Card>
</CardGroup>

<div id="agentic-features">
  ## Recursos com Agentes
</div>

<CardGroup cols={3}>
  <Card title="Extract" icon="barcode-read" href="/pt-BR/api-reference/endpoint/extract" color="FF713C">
    Extraia dados estruturados de páginas da web inteiras usando linguagem natural.
  </Card>

  {/* <Card title="Deep Research" icon="brain-circuit" href="/api-reference/endpoint/deep-research" color="FF713C">
      Pesquisa na web com IA que explora e sintetiza informações de forma autônoma.
    </Card> */}
</CardGroup>

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

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

```bash
https://api.firecrawl.dev 
```

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

Para autenticar, inclua um cabeçalho Authorization. Esse cabeçalho deve conter `Bearer fc-123456789`, em que `fc-123456789` é a sua chave de API.

```bash
Authorization: Bearer fc-123456789
```

​

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

Firecrawl utiliza códigos de status HTTP convencionais para indicar o resultado das suas solicitações.

Em geral, códigos 2xx indicam sucesso, 4xx representam erros relacionados ao cliente e 5xx sinalizam problemas de infraestrutura.

Status | Descrição
--- | ---
200 | Solicitação bem-sucedida.
400 | Verifique se os parâmetros estão corretos.
401 | A chave de API não foi fornecida.
402 | Pagamento necessário
404 | O recurso solicitado não foi encontrado.
429 | O limite de taxa foi excedido.
5xx | Indica um erro de servidor no Firecrawl.

Consulte a seção Códigos de erro para uma explicação detalhada de todos os erros de API possíveis.

<div id="rate-limit">
  ## Limite de taxa
</div>

A API do Firecrawl possui um limite de taxa para garantir a estabilidade e confiabilidade do serviço. O limite se aplica a todos os endpoints e é baseado no número de solicitações feitas em um determinado período.

Ao exceder o limite de taxa, você receberá o código de status 429.