Pay-Per-Use Search EndpointThis endpoint allows you to use Firecrawl’s powerful search capabilities without a subscription by paying per search using cryptocurrency. Perfect for one-off searches or testing before committing to a subscription.
Experimental FeatureThis is an experimental endpoint. Features, pricing, and availability may change without notice. We recommend using the standard subscription-based search endpoint for production use cases.
Authentication
This endpoint requires a special payment header instead of the standard API key:How it Works
The On-Demand Search endpoint combines web search (SERP) with Firecrawl’s scraping capabilities to return full page content for any query, just like the regular/search
endpoint, but with pay-per-use pricing.
Include scrapeOptions
with formats: ["markdown"]
to get complete markdown content for each search result otherwise you will default to getting the SERP results (url, title, description).
Request Parameters
All parameters from the standard/search
endpoint are supported with the following exception:
Important Limitation: The
limit
parameter is capped at 10 results maximum for the wallet endpoint (compared to 100 for the standard endpoint).Example Request
Response
The response format is identical to the standard/search
endpoint:
Pricing
Current price: $0.01 per requestPricing Notice: The current pricing of $0.01 per request is subject to change at any time without prior notice. Please check the latest pricing when generating your payment header.
See Also
- Search Feature Documentation - Detailed search functionality guide
- Standard Search Endpoint - Subscription-based search endpoint