Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion advanced-scraping-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -368,7 +368,7 @@ Use the `/v2/agent` endpoint for autonomous, multi-page data extraction. The age
| `schema` | `object` | — | JSON schema to structure the extracted data. |
| `maxCredits` | `number` | `2500` | Maximum credits the agent can spend. The dashboard supports up to 2,500; for higher limits, set this via the API (values above 2,500 are always billed as paid requests). |
| `strictConstrainToURLs` | `boolean` | `false` | When `true`, the agent only visits the provided URLs. |
| `model` | `string` | `"spark-1-mini"` | AI model to use. `"spark-1-mini"` (default, 60% cheaper) or `"spark-1-pro"` (higher accuracy). |
| `model` | `string` | `"spark-1-pro"` | AI model to use. `"spark-1-pro"` (default, higher accuracy) or `"spark-1-mini"` (60% cheaper). |

<CodeGroup>

Expand Down
4 changes: 2 additions & 2 deletions api-reference/v2-openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -1473,8 +1473,8 @@
"model": {
"type": "string",
"enum": ["spark-1-mini", "spark-1-pro"],
"default": "spark-1-mini",
"description": "The model to use for the agent task. spark-1-mini (default) is 60% cheaper, spark-1-pro offers higher accuracy for complex tasks"
"default": "spark-1-pro",
"description": "The model to use for the agent task. spark-1-pro (default) offers higher accuracy for complex tasks, spark-1-mini is 60% cheaper"
}
},
"required": ["prompt"]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ The `/agent` endpoint is Firecrawl's most advanced offering—the successor to `
- **Autonomous Navigation**: The agent searches and navigates deep into sites to find your data
- **Deep Web Search**: Autonomously discovers information across multiple domains and pages
- **Parallel Processing**: Processes multiple sources simultaneously for faster results
- **Models Available**: `spark-1-mini` (default, 60% cheaper) and `spark-1-pro` (higher accuracy)
- **Models Available**: `spark-1-pro` (default, higher accuracy) and `spark-1-mini` (60% cheaper)

### Example

Expand Down
32 changes: 16 additions & 16 deletions features/agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,28 +116,18 @@ You can share agent runs directly from the Agent playground. Shared links are pu

## Model Selection

Firecrawl Agent offers two models. **Spark 1 Mini is 60% cheaper** and is the default — perfect for most use cases. Upgrade to Spark 1 Pro when you need maximum accuracy on complex tasks.
Firecrawl Agent offers two models. **Spark 1 Pro** is the default, offering higher accuracy for complex tasks. Switch to **Spark 1 Mini** when cost efficiency is a priority — it's **60% cheaper**.

| Model | Cost | Accuracy | Best For |
|-------|------|----------|----------|
| `spark-1-mini` | **60% cheaper** | Standard | Most tasks (default) |
| `spark-1-pro` | Standard | Higher | Complex research, critical extraction |
| `spark-1-pro` | Standard | Higher | Complex research, critical extraction (default) |
| `spark-1-mini` | **60% cheaper** | Standard | Cost-sensitive tasks |

<Tip>
**Start with Spark 1 Mini** (default) — it handles most extraction tasks well at 60% lower cost. Switch to Pro only for complex multi-domain research or when accuracy is critical.
**Spark 1 Pro** (default) offers higher accuracy for complex tasks. Switch to Mini when cost efficiency is a priority — it's 60% cheaper and handles most straightforward extraction tasks well.
</Tip>

### Spark 1 Mini (Default)

`spark-1-mini` is our efficient model, ideal for straightforward data extraction tasks.

**Use Mini when:**
- Extracting simple data points (contact info, pricing, etc.)
- Working with well-structured websites
- Cost efficiency is a priority
- Running high-volume extraction jobs

### Spark 1 Pro
### Spark 1 Pro (Default)

`spark-1-pro` is our flagship model, designed for maximum accuracy on complex extraction tasks.

Expand All @@ -147,6 +137,16 @@ Firecrawl Agent offers two models. **Spark 1 Mini is 60% cheaper** and is the de
- Accuracy is critical for your use case
- Dealing with ambiguous or hard-to-find data

### Spark 1 Mini

`spark-1-mini` is our efficient model, ideal for straightforward data extraction tasks.

**Use Mini when:**
- Extracting simple data points (contact info, pricing, etc.)
- Working with well-structured websites
- Cost efficiency is a priority
- Running high-volume extraction jobs

### Specifying a Model

Pass the `model` parameter to select which model to use:
Expand All @@ -164,7 +164,7 @@ Pass the `model` parameter to select which model to use:
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompt` | string | **Yes** | Natural language description of the data you want to extract (max 10,000 characters) |
| `model` | string | No | Model to use: `spark-1-mini` (default) or `spark-1-pro` |
| `model` | string | No | Model to use: `spark-1-pro` (default) or `spark-1-mini` (60% cheaper) |
| `urls` | array | No | Optional list of URLs to focus the extraction |
| `schema` | object | No | Optional JSON schema for structured output |
| `maxCredits` | number | No | Maximum number of credits to spend on this agent task. Defaults to **2,500** if not set. The dashboard supports values up to **2,500**; for higher limits, set `maxCredits` via the API (values above 2,500 are always treated as paid requests). If the limit is reached, the job fails and **no data is returned**, though credits consumed for work performed are still charged. |
Expand Down
40 changes: 20 additions & 20 deletions features/models.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,30 +16,14 @@ Firecrawl Agent offers two models optimized for different use cases. Choose the

| Model | Cost | Accuracy | Best For |
|-------|------|----------|----------|
| `spark-1-mini` | **60% cheaper** | Standard | Most tasks (default) |
| `spark-1-pro` | Standard | Higher | Complex research, critical extraction |
| `spark-1-pro` | Standard | Higher | Complex research, critical extraction (default) |
| `spark-1-mini` | **60% cheaper** | Standard | Cost-sensitive tasks |

<Tip>
**Start with Spark 1 Mini** (default) — it handles most extraction tasks well at 60% lower cost. Switch to Pro only for complex multi-domain research or when accuracy is critical.
**Spark 1 Pro** (default) offers higher accuracy for complex tasks. Switch to Mini when cost efficiency is a priority — it's 60% cheaper and handles most straightforward extraction tasks well.
</Tip>

## Spark 1 Mini (Default)

`spark-1-mini` is our efficient model, ideal for straightforward data extraction tasks.

**Use Mini when:**
- Extracting simple data points (contact info, pricing, etc.)
- Working with well-structured websites
- Cost efficiency is a priority
- Running high-volume extraction jobs

**Example use cases:**
- Extracting product prices from e-commerce sites
- Gathering contact information from company pages
- Pulling basic metadata from articles
- Simple data point lookups

## Spark 1 Pro
## Spark 1 Pro (Default)

`spark-1-pro` is our flagship model, designed for maximum accuracy on complex extraction tasks.

Expand All @@ -55,6 +39,22 @@ Firecrawl Agent offers two models optimized for different use cases. Choose the
- Extracting nuanced information from multiple sources
- Critical business intelligence gathering

## Spark 1 Mini

`spark-1-mini` is our efficient model, ideal for straightforward data extraction tasks.

**Use Mini when:**
- Extracting simple data points (contact info, pricing, etc.)
- Working with well-structured websites
- Cost efficiency is a priority
- Running high-volume extraction jobs

**Example use cases:**
- Extracting product prices from e-commerce sites
- Gathering contact information from company pages
- Pulling basic metadata from articles
- Simple data point lookups

## Specifying a Model

Pass the `model` parameter to select which model to use:
Expand Down
2 changes: 1 addition & 1 deletion sdks/cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -300,7 +300,7 @@ Search and gather data from the web using natural language prompts.
| Option | Description |
|--------|-------------|
| `--urls <urls>` | Optional list of URLs to focus the agent on (comma-separated) |
| `--model <model>` | Model to use: `spark-1-mini` (default, 60% cheaper) or `spark-1-pro` (higher accuracy) |
| `--model <model>` | Model to use: `spark-1-pro` (default, higher accuracy) or `spark-1-mini` (60% cheaper) |
| `--schema <json>` | JSON schema for structured output (inline JSON string) |
| `--schema-file <path>` | Path to JSON schema file for structured output |
| `--max-credits <number>` | Maximum credits to spend (job fails if limit reached) |
Expand Down