Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

docs(php-sdk): note HTTP 200 success=false failure mode in client and changelog

Kris Oeid2e856bc4ef3
diff --git a/apps/php-sdk/CHANGELOG.md b/apps/php-sdk/CHANGELOG.md
index 6559882a9..415a3cdb5 100644
--- a/apps/php-sdk/CHANGELOG.md
+++ b/apps/php-sdk/CHANGELOG.md
@@ -14,6 +14,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
array; API key and config are reused from the existing Laravel integration.
Requires `laravel/ai ^0.9` (PHP 8.3+, Laravel 12+) in the consuming app.
+### Fixed
+- `scrape()`, `search()`, and `map()` now throw `FirecrawlException` when the API
+ returns an HTTP 200 response with `success: false` (for example DNS resolution
+ failures), instead of silently hydrating an empty result.
+
## [1.3.0] - 2026-05-12
### Added
diff --git a/apps/php-sdk/src/Client/FirecrawlClient.php b/apps/php-sdk/src/Client/FirecrawlClient.php
index c704af504..251e65752 100644
--- a/apps/php-sdk/src/Client/FirecrawlClient.php
+++ b/apps/php-sdk/src/Client/FirecrawlClient.php
@@ -730,6 +730,10 @@ final class FirecrawlClient
}
/**
+ * The API reports some failures (for example DNS resolution errors) as
+ * HTTP 200 with a `success: false` body, verified against production, so
+ * status-code handling alone is not enough to detect them.
+ *
* @param array<string, mixed> $response
* @return array<string, mixed> the same response, if it does not signal failure
*/