diff --git a/advanced-scraping-guide.mdx b/advanced-scraping-guide.mdx index 80f408f6..0b063b2a 100644 --- a/advanced-scraping-guide.mdx +++ b/advanced-scraping-guide.mdx @@ -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). | diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index bd68843c..191d753c 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -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"] diff --git a/developer-guides/usage-guides/choosing-the-data-extractor.mdx b/developer-guides/usage-guides/choosing-the-data-extractor.mdx index 036b9185..3dfaa8f7 100644 --- a/developer-guides/usage-guides/choosing-the-data-extractor.mdx +++ b/developer-guides/usage-guides/choosing-the-data-extractor.mdx @@ -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 diff --git a/features/agent.mdx b/features/agent.mdx index 9ead660e..c98b1de1 100644 --- a/features/agent.mdx +++ b/features/agent.mdx @@ -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 | -**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. -### 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. @@ -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: @@ -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. | diff --git a/features/models.mdx b/features/models.mdx index b663abfb..b97211f6 100644 --- a/features/models.mdx +++ b/features/models.mdx @@ -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 | -**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. -## 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. @@ -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: diff --git a/sdks/cli.mdx b/sdks/cli.mdx index 00aba441..afec1f4e 100644 --- a/sdks/cli.mdx +++ b/sdks/cli.mdx @@ -300,7 +300,7 @@ Search and gather data from the web using natural language prompts. | Option | Description | |--------|-------------| | `--urls ` | Optional list of URLs to focus the agent on (comma-separated) | -| `--model ` | Model to use: `spark-1-mini` (default, 60% cheaper) or `spark-1-pro` (higher accuracy) | +| `--model ` | Model to use: `spark-1-pro` (default, higher accuracy) or `spark-1-mini` (60% cheaper) | | `--schema ` | JSON schema for structured output (inline JSON string) | | `--schema-file ` | Path to JSON schema file for structured output | | `--max-credits ` | Maximum credits to spend (job fails if limit reached) |