What /agent by Firecrawl does
/agent is an endpoint of the Firecrawl API (POST https://api.firecrawl.dev/v2/agent) that Firecrawl describes as deep research for data. You send a prompt (up to 10,000 characters) describing what you need, such as a list of companies with founders and websites, and the agent searches the web, navigates sites, handles JavaScript pages, pagination and infinite scroll, and returns JSON. You can pass a JSON schema (Pydantic in Python, Zod in Node) to get typed output, and an optional list of urls to focus the run; strictConstrainToURLs keeps it on those pages only. Firecrawl says /agent replaces its older /extract endpoint, which it is deprecating, and that for a single known URL its JSON mode on /scrape is cheaper.
Every run now uses Firecrawl's Spark 2 model (the older Spark 1 Mini and Pro names still work but route to Spark 2), with an optional effort setting of low, medium or high. Jobs run asynchronously: you poll by job ID or receive webhooks, results stay available through the API for 24 hours, and a thread ID lets you send follow-up prompts that continue a run. Other options include a proxy country for the whole run, SafeSearch filtering, Zero Data Retention (billed at 2x), and access to paid Alexandria data providers with an approval step. You can try it without code in the playground at firecrawl.dev/agent, or call it from the Python and Node SDKs, the CLI and Firecrawl's MCP server. Parallel Agents batches hundreds or thousands of /agent queries as a spreadsheet-style grid.
