> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Migración de v1 a v2

> Cambios clave, correspondencias y ejemplos de antes y después para actualizar tu integración a v2.

<div id="overview">
  ## Visión general
</div>

<div id="key-improvements">
  ### Mejoras clave
</div>

* **Más rápido de forma predeterminada**: Las solicitudes se almacenan en caché con `maxAge` establecido por defecto en 2 días, y están habilitados valores predeterminados sensatos como `blockAds`, `skipTlsVerification` y `removeBase64Images`.

* **Nuevo formato de resumen**: Ahora puedes especificar `"summary"` como formato para recibir directamente un resumen conciso del contenido de la página.

* **Extracción JSON actualizada**: La extracción en JSON y el seguimiento de cambios ahora usan un formato de objeto: `{ type: "json", prompt, schema }`. El antiguo formato `"extract"` pasó a llamarse `"json"`.

* **Opciones de captura de pantalla mejoradas**: Usa el formato de objeto: `{ type: "screenshot", fullPage, quality, viewport }`.

* **Nuevas fuentes de búsqueda**: Busca en `"news"` e `"images"`, además de los resultados web, configurando el parámetro `sources`.

* **Rastreo inteligente con prompts**: Pasa un `prompt` en lenguaje natural para el rastreo y el sistema derivará rutas y límites automáticamente. Usa el nuevo punto de conexión /crawl/params-preview para inspeccionar las opciones derivadas antes de iniciar un trabajo.

<div id="quick-migration-checklist">
  ## Lista rápida de verificación de migración
</div>

* Reemplaza el uso del cliente v1 por los clientes v2:
  * JS: `const firecrawl = new Firecrawl({ apiKey: 'fc-YOUR-API-KEY' })`
  * Python: `firecrawl = Firecrawl(api_key='fc-YOUR-API-KEY')`
  * API: usa los nuevos puntos de conexión `https://api.firecrawl.dev/v2/`.
* Actualiza los formatos:
  * Usa `"summary"` cuando sea necesario
  * modo JSON: usa `{ type: "json", prompt, schema }` para la extracción en modo JSON
  * Screenshot y Screenshot\@fullPage: usa el formato de objeto de captura de pantalla al especificar opciones
* Adopta flujos asíncronos estandarizados en los SDK:
  * Crawls: `startCrawl` + `getCrawlStatus` (o el “waiter” `crawl`)
  * Batch: `startBatchScrape` + `getBatchScrapeStatus` (o el “waiter” `batchScrape`)
  * Extract: `startExtract` + `getExtractStatus` (o el “waiter” `extract`)
* Mapeo de opciones de crawl (ver abajo)
* Verifica el `prompt` de crawl con `/crawl/params-preview`

<div id="sdk-surface-v2">
  ## Superficie del SDK (v2)
</div>

<div id="jsts">
  ### JS/TS
</div>

#### Cambios en los nombres de métodos (migración v1 → v2)

**Scrape, Search y Map**

| v1 (Firecrawl)        | v2 (Firecrawl)            |
| --------------------- | ------------------------- |
| `scrapeUrl(url, ...)` | `scrape(url, options?)`   |
| `search(query, ...)`  | `search(query, options?)` |
| `mapUrl(url, ...)`    | `map(url, options?)`      |

**Crawling**

| v1                          | v2                                        |
| --------------------------- | ----------------------------------------- |
| `crawlUrl(url, ...)`        | `crawl(url, options?)` (método de espera) |
| `asyncCrawlUrl(url, ...)`   | `startCrawl(url, options?)`               |
| `checkCrawlStatus(id, ...)` | `getCrawlStatus(id)`                      |
| `cancelCrawl(id)`           | `cancelCrawl(id)`                         |
| `checkCrawlErrors(id)`      | `getCrawlErrors(id)`                      |

**Batch Scraping**

| v1                                | v2                                            |
| --------------------------------- | --------------------------------------------- |
| `batchScrapeUrls(urls, ...)`      | `batchScrape(urls, opts?)` (método de espera) |
| `asyncBatchScrapeUrls(urls, ...)` | `startBatchScrape(urls, opts?)`               |
| `checkBatchScrapeStatus(id, ...)` | `getBatchScrapeStatus(id)`                    |
| `checkBatchScrapeErrors(id)`      | `getBatchScrapeErrors(id)`                    |

**Extraction**

| v1                            | v2                     |
| ----------------------------- | ---------------------- |
| `extract(urls?, params?)`     | `extract(args)`        |
| `asyncExtract(urls, params?)` | `startExtract(args)`   |
| `getExtractStatus(id)`        | `getExtractStatus(id)` |

**Otros / Eliminados**

| v1                                | v2                         |
| --------------------------------- | -------------------------- |
| `generateLLMsText(...)`           | (no incluido en el SDK v2) |
| `checkGenerateLLMsTextStatus(id)` | (no incluido en el SDK v2) |
| `crawlUrlAndWatch(...)`           | `watcher(jobId, ...)`      |
| `batchScrapeUrlsAndWatch(...)`    | `watcher(jobId, ...)`      |

***

<div id="python-sync">
  ### Python (sincrónico)
</div>

<div id="method-name-changes-v1-v2">
  #### Cambios en los nombres de métodos (migración v1 → v2)
</div>

**Scrape, Search y Map**

| v1                | v2            |
| ----------------- | ------------- |
| `scrape_url(...)` | `scrape(...)` |
| `search(...)`     | `search(...)` |
| `map_url(...)`    | `map(...)`    |

**Crawling**

| v1                        | v2                      |
| ------------------------- | ----------------------- |
| `crawl_url(...)`          | `crawl(...)` (waiter)   |
| `async_crawl_url(...)`    | `start_crawl(...)`      |
| `check_crawl_status(...)` | `get_crawl_status(...)` |
| `cancel_crawl(...)`       | `cancel_crawl(...)`     |

**Batch Scraping**

| v1                             | v2                             |
| ------------------------------ | ------------------------------ |
| `batch_scrape_urls(...)`       | `batch_scrape(...)` (waiter)   |
| `async_batch_scrape_urls(...)` | `start_batch_scrape(...)`      |
| `get_batch_scrape_status(...)` | `get_batch_scrape_status(...)` |
| `get_batch_scrape_errors(...)` | `get_batch_scrape_errors(...)` |

**Extraction**

| v1                        | v2                        |
| ------------------------- | ------------------------- |
| `extract(...)`            | `extract(...)`            |
| `start_extract(...)`      | `start_extract(...)`      |
| `get_extract_status(...)` | `get_extract_status(...)` |

**Otros / Eliminados**

| v1                                   | v2                     |
| ------------------------------------ | ---------------------- |
| `generate_llms_text(...)`            | (no está en el SDK v2) |
| `get_generate_llms_text_status(...)` | (no está en el SDK v2) |
| `watch_crawl(...)`                   | `watcher(job_id, ...)` |

***

<div id="python-async">
  ### Python (async)
</div>

* `AsyncFirecrawl` ofrece los mismos métodos (todos awaitable).

<div id="formats-and-scrape-options">
  ## Formatos y opciones de scrape
</div>

* Usa formatos de texto para lo básico: `"markdown"`, `"html"`, `"rawHtml"`, `"links"`, `"summary"`, `"images"`.
* En lugar de `parsePDF`, usa `parsers: [ { "type": "pdf" } | "pdf" ]`.
* Usa formatos de objeto para JSON, seguimiento de cambios y capturas de pantalla:

<div id="json-format">
  ### Formato JSON
</div>

<CodeGroup>
  ```js Node theme={null}
  const formats = [ {
    "type": "json",
    "prompt": "Extrae la misión de la empresa de la página."
  }];

  doc = firecrawl.scrape(url, { formats });
  ```

  ```python Python theme={null}
  formats = [ { "type": "json", "prompt": "Extrae la misión de la empresa de la página." } ];

  doc = firecrawl.scrape(url, formats=formats);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.firecrawl.dev/v2/scrape \
      -H 'Content-Type: application/json' \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      -d '{
        "url": "https://docs.firecrawl.dev/",
        "formats": [{
          "type": "json",
          "prompt": "Extrae la misión de la empresa de la página."
        }]
      }'
  ```
</CodeGroup>

<div id="screenshot-format">
  ### Formato de captura de pantalla
</div>

<CodeGroup>
  ```js Node theme={null}
  // Formato de captura de pantalla (JS)
  const formats = [ { "type": "screenshot", "fullPage": true, "quality": 80, "viewport": { "width": 1280, "height": 800 } } ];

  doc = firecrawl.scrape(url, { formats });
  ```

  ```python Python theme={null}
  # Formato de captura de pantalla (Python)
  formats = [ { "type": "screenshot", "fullPage": true, "quality": 80, "viewport": { "width": 1280, "height": 800 } } ];
  doc = firecrawl.scrape(url, formats=formats);
  ```

  ```bash cURL theme={null}
  # Formato de captura de pantalla (cURL)
  curl -X POST https://api.firecrawl.dev/v2/scrape \
      -H 'Content-Type: application/json' \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      -d '{
        "url": "https://docs.firecrawl.dev/",
        "formats": [{
          "type": "screenshot",
          "fullPage": true,
          "quality": 80,
          "viewport": { "width": 1280, "height": 800 }
        }]
      }'
  ```
</CodeGroup>

<div id="crawl-options-mapping-v1-v2">
  ## Mapeo de opciones de rastreo (v1 → v2)
</div>

| v1                      | v2                                             |
| ----------------------- | ---------------------------------------------- |
| `allowBackwardCrawling` | (eliminado) utiliza `crawlEntireDomain`        |
| `maxDepth`              | (eliminado) utiliza `maxDiscoveryDepth`        |
| `ignoreSitemap` (bool)  | `sitemap` (p. ej., "only", "skip" o "include") |
| (ninguno)               | `prompt`                                       |

<div id="crawl-prompt-params-preview">
  ## Vista previa de prompt y parámetros de rastreo
</div>

Consulta ejemplos de la vista previa de parámetros de rastreo:

<CodeGroup>
  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

  const params = await firecrawl.crawlParamsPreview('https://docs.firecrawl.dev', 'Extract docs and blog');
  console.log(params);
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(api_key='fc-YOUR-API-KEY')
  preview = firecrawl.crawl_params_preview(url='https://docs.firecrawl.dev', prompt='Extract docs and blog')
  print(preview)
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.firecrawl.dev/v2/crawl/params-preview \
      -H 'Content-Type: application/json' \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      -d '{
        "url": "https://docs.firecrawl.dev",
        "prompt": "Extract docs and blog"
      }'
  ```
</CodeGroup>