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

# Introdução

> Referência da API do Evocrawl (v2)

A API do Evocrawl 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="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.evocrawl.com
```

<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 Evocrawl](https://www.evocrawl.com/app/api-keys).

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

  ```python Python theme={null}
  from evocrawl import Evocrawl

  evocrawl = Evocrawl(api_key="fc-YOUR-API-KEY")

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

  ```js Node theme={null}
  import Evocrawl from '@mendable/evocrawl-js';

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

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

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

O Evocrawl 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.

| Status | Descrição                                |
| ------ | ---------------------------------------- |
| `200`  | Requisição bem-sucedida.                 |
| `400`  | Parâmetros de requisição inválidos.      |
| `401`  | Chave de API ausente ou inválida.        |
| `402`  | Pagamento necessário.                    |
| `404`  | O recurso solicitado não foi encontrado. |
| `429`  | Limite de requisições excedido.          |
| `5xx`  | Erro de servidor no Evocrawl.            |

Quando ocorre um erro `5xx`, o corpo da resposta inclui um código de erro específico para ajudar você a diagnosticar o problema.

<div id="rate-limit">
  ## Limite de taxa de requisições
</div>

A API do Evocrawl impõe limites de taxa de requisições em todos os endpoints para garantir a estabilidade do serviço. Esses limites são definidos com base no número de requisições em uma janela de tempo específica.

Quando você ultrapassa o limite de taxa, a API retorna o código de status `429`. Aguarde um pouco e tente fazer a requisição novamente após um breve intervalo.