# What changed in firecrawl-py

> 16 changes in firecrawl-py 2 from its official release notes, upgrade guides and advisories: 1 breaking, 1 security, 11 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/pypi/firecrawl-py/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## firecrawl-py 2

### Breaking changes

- The org flag now uses `disabled` / `allowed` / `forced` values, and the legacy boolean request shape has been removed. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)

### Security

- Adds missing negative-limit validation in the Python, Java, and Go SDKs. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)

### New APIs and options

- Adds an org flag for custom robots user agents independently of `ignoreRobots`. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds a `/v2/search` parameter for excluding specific domains from results. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Exposes the Docker harness startup timeout through docker-compose for self-hosted users needing longer startup windows. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds a `/scrape` format that returns matching sentences, code blocks, and table rows from the source page. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds a `/v2/search` parameter for scoping results to specific domains. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds a `/scrape` option that serves results exclusively from Firecrawl's index, with cache misses returning 404. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds multipart file parsing for uploads up to 50 MB, returning a standard Document with clean, LLM-ready output. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds search-result feedback submissions, with accepted submissions refunding a credit subject to a daily cap and age limit. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds a `/scrape` format that returns a grounded answer in `data.question`. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds a crawl option for evaluating robots.txt rules and crawl delays against a custom agent string. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Adds a `/scrape` format that returns `document.video` as a signed URL; unsupported URLs raise an error. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)

### Behavior and default changes

- PDF billing now reflects pages processed instead of raw page count. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)
- Raises the PDF upload size limit from 10 MB to 30 MB. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)

### Fixes and other changes

- Fixes the native link filter and JS SDK crawl payload so they honor and include the custom robots user agent. (2.10) — [release notes](https://github.com/firecrawl/firecrawl/releases/tag/v2.10)