Skip to main content

Introdução

Referência da API do Firecrawl (v2)
2 min read
Note

Para agentes de IA: Use llms.txt para acessar um índice completo de toda a documentação.

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.

Recursos#

URL base#

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

Autenticação#

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

Inclua este cabeçalho em todas as chamadas à API. Você pode encontrar sua chave de API no painel do Firecrawl.

Se você for um agente sem uma chave de API, comece em Obter credenciais. Se sua plataforma oferecer suporte a WorkOS ID-JAG, use auth.md para obter instruções de registro.

Códigos de resposta#

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

Respostas 429#

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 para ver os limites por plano e Errors para orientações sobre novas tentativas.