firecrawl 4.22.1 → 4.23.0

package/README.md

@@ -46,10 +46,22 @@ const url = 'https://example.com';
 const scrapedData = await app.scrape(url);
 ```
 
+### Video extraction
+
+Use the `video` format on supported video URLs, including YouTube and TikTok. The returned `video` field is a signed URL to the extracted video file.
+
+```js
+const doc = await app.scrape('https://www.youtube.com/watch?v=dQw4w9WgXcQ', {
+  formats: ['video'],
+});
+
+console.log(doc.video);
+```
+
 ### Parsing uploaded files
 
 Use `parse` to upload a file (`html`, `pdf`, `docx`, etc.) as multipart form data and process it through the same parsing pipeline.
-Parse does not support browser-only formats/options like `changeTracking`, `screenshot`, `branding`, `actions`, `waitFor`, `location`, or `mobile`.
+Parse does not support browser-only formats/options like `changeTracking`, `screenshot`, `branding`, `audio`, `video`, `actions`, `waitFor`, `location`, or `mobile`.
 
 ```js
 const parsed = await app.parse(

package/dist/{chunk-WTZQ5IMF.js → chunk-ZR3KTUEQ.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.22.1",
+      version: "4.23.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",

package/dist/index.cjs

@@ -35,7 +35,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.22.1",
+      version: "4.23.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -426,6 +426,9 @@ function ensureValidParseFormats(formats) {
       if (fmt === "branding") {
         throw new Error("parse does not support branding format");
       }
+      if (fmt === "audio" || fmt === "video") {
+        throw new Error(`parse does not support ${fmt} format`);
+      }
       continue;
     }
     const type = fmt.type;
@@ -438,6 +441,9 @@ function ensureValidParseFormats(formats) {
     if (type === "branding") {
       throw new Error("parse does not support branding format");
     }
+    if (type === "audio" || type === "video") {
+      throw new Error(`parse does not support ${type} format`);
+    }
     if (fmt.type === "json") {
       const j = fmt;
       if (!j.prompt && !j.schema) {
@@ -2986,6 +2992,7 @@ var FirecrawlApp = class {
    * @param onActivity - Optional callback to receive activity updates in real-time.
    * @param onSource - Optional callback to receive source updates in real-time.
    * @returns The final research results.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async deepResearch(query, params, onActivity, onSource) {
     try {
@@ -3042,6 +3049,7 @@ var FirecrawlApp = class {
    * Initiates a deep research operation on a given query without polling.
    * @param params - Parameters for the deep research operation.
    * @returns The response containing the research job ID.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async asyncDeepResearch(query, params) {
     const headers = this.prepareHeaders();
@@ -3079,6 +3087,7 @@ var FirecrawlApp = class {
    * Checks the status of a deep research operation.
    * @param id - The ID of the deep research operation.
    * @returns The current status and results of the research operation.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async checkDeepResearchStatus(id) {
     const headers = this.prepareHeaders();
@@ -3217,6 +3226,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The final generation results.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async generateLLMsText(url, params) {
     try {
@@ -3258,6 +3268,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The response containing the generation job ID.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async asyncGenerateLLMsText(url, params) {
     const headers = this.prepareHeaders();
@@ -3286,6 +3297,7 @@ var FirecrawlApp = class {
    * Checks the status of a LLMs.txt generation operation.
    * @param id - The ID of the LLMs.txt generation operation.
    * @returns The current status and results of the generation operation.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async checkGenerateLLMsTextStatus(id) {
     const headers = this.prepareHeaders();

package/dist/index.d.cts

@@ -4,7 +4,7 @@ import { AxiosResponse, AxiosRequestHeaders } from 'axios';
 import { EventEmitter } from 'events';
 import { TypedEventTarget } from 'typescript-event-target';
 
-type FormatString = 'markdown' | 'html' | 'rawHtml' | 'links' | 'images' | 'screenshot' | 'summary' | 'changeTracking' | 'json' | 'attributes' | 'branding' | 'audio';
+type FormatString = 'markdown' | 'html' | 'rawHtml' | 'links' | 'images' | 'screenshot' | 'summary' | 'changeTracking' | 'json' | 'attributes' | 'branding' | 'audio' | 'video';
 interface Viewport {
     width: number;
     height: number;
@@ -55,7 +55,7 @@ interface QueryFormat {
     mode?: 'freeform' | 'directQuote';
 }
 type FormatOption = FormatString | Format | JsonFormat | ChangeTrackingFormat | ScreenshotFormat | AttributesFormat | QuestionFormat | HighlightsFormat | QueryFormat;
-type ParseFormatString = Exclude<FormatString, 'screenshot' | 'changeTracking' | 'branding'>;
+type ParseFormatString = Exclude<FormatString, 'screenshot' | 'changeTracking' | 'branding' | 'audio' | 'video'>;
 interface ParseFormat {
     type: ParseFormatString;
 }
@@ -347,6 +347,7 @@ interface Document {
     images?: string[];
     screenshot?: string;
     audio?: string;
+    video?: string;
     attributes?: Array<{
         selector: string;
         attribute: string;
@@ -621,6 +622,8 @@ interface ExtractResponse$1 {
     data?: unknown;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: Record<string, unknown>;
     expiresAt?: string;
     creditsUsed?: number;
@@ -956,6 +959,7 @@ declare class FirecrawlClient {
      * @param file File payload (data, filename, optional contentType).
      * @param options Optional parse options (formats, parsers, etc.).
      *                Note: parse does not support changeTracking, screenshot, branding,
+     *                audio, video,
      *                actions, waitFor, location, or mobile options.
      * @returns Parsed document with requested formats.
      */
@@ -1521,6 +1525,8 @@ interface ExtractResponse<LLMSchema extends zt.ZodSchema = any> {
     data: LLMSchema;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: string[];
     creditsUsed?: number;
 }
@@ -1623,6 +1629,8 @@ interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any> {
 interface DeepResearchResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for deep research operations.
@@ -1662,6 +1670,8 @@ interface DeepResearchStatusResponse {
         description: string;
     }>;
     summaries: string[];
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Parameters for LLMs.txt generation operations.
@@ -1693,6 +1703,8 @@ interface GenerateLLMsTextParams {
 interface GenerateLLMsTextResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for LLMs.txt generation operations.
@@ -1706,6 +1718,8 @@ interface GenerateLLMsTextStatusResponse {
     status: "processing" | "completed" | "failed";
     error?: string;
     expiresAt: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Response interface for queue status operations.
@@ -1955,6 +1969,7 @@ declare class FirecrawlApp {
      * @param onActivity - Optional callback to receive activity updates in real-time.
      * @param onSource - Optional callback to receive source updates in real-time.
      * @returns The final research results.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     deepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>, onActivity?: (activity: {
         type: string;
@@ -1972,12 +1987,14 @@ declare class FirecrawlApp {
      * Initiates a deep research operation on a given query without polling.
      * @param params - Parameters for the deep research operation.
      * @returns The response containing the research job ID.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse>;
     /**
      * Checks the status of a deep research operation.
      * @param id - The ID of the deep research operation.
      * @returns The current status and results of the research operation.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     checkDeepResearchStatus(id: string): Promise<DeepResearchStatusResponse | ErrorResponse>;
     /**
@@ -2014,6 +2031,7 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The final generation results.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     generateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**
@@ -2021,12 +2039,14 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The response containing the generation job ID.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     asyncGenerateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextResponse | ErrorResponse>;
     /**
      * Checks the status of a LLMs.txt generation operation.
      * @param id - The ID of the LLMs.txt generation operation.
      * @returns The current status and results of the generation operation.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     checkGenerateLLMsTextStatus(id: string): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { AxiosResponse, AxiosRequestHeaders } from 'axios';
 import { EventEmitter } from 'events';
 import { TypedEventTarget } from 'typescript-event-target';
 
-type FormatString = 'markdown' | 'html' | 'rawHtml' | 'links' | 'images' | 'screenshot' | 'summary' | 'changeTracking' | 'json' | 'attributes' | 'branding' | 'audio';
+type FormatString = 'markdown' | 'html' | 'rawHtml' | 'links' | 'images' | 'screenshot' | 'summary' | 'changeTracking' | 'json' | 'attributes' | 'branding' | 'audio' | 'video';
 interface Viewport {
     width: number;
     height: number;
@@ -55,7 +55,7 @@ interface QueryFormat {
     mode?: 'freeform' | 'directQuote';
 }
 type FormatOption = FormatString | Format | JsonFormat | ChangeTrackingFormat | ScreenshotFormat | AttributesFormat | QuestionFormat | HighlightsFormat | QueryFormat;
-type ParseFormatString = Exclude<FormatString, 'screenshot' | 'changeTracking' | 'branding'>;
+type ParseFormatString = Exclude<FormatString, 'screenshot' | 'changeTracking' | 'branding' | 'audio' | 'video'>;
 interface ParseFormat {
     type: ParseFormatString;
 }
@@ -347,6 +347,7 @@ interface Document {
     images?: string[];
     screenshot?: string;
     audio?: string;
+    video?: string;
     attributes?: Array<{
         selector: string;
         attribute: string;
@@ -621,6 +622,8 @@ interface ExtractResponse$1 {
     data?: unknown;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: Record<string, unknown>;
     expiresAt?: string;
     creditsUsed?: number;
@@ -956,6 +959,7 @@ declare class FirecrawlClient {
      * @param file File payload (data, filename, optional contentType).
      * @param options Optional parse options (formats, parsers, etc.).
      *                Note: parse does not support changeTracking, screenshot, branding,
+     *                audio, video,
      *                actions, waitFor, location, or mobile options.
      * @returns Parsed document with requested formats.
      */
@@ -1521,6 +1525,8 @@ interface ExtractResponse<LLMSchema extends zt.ZodSchema = any> {
     data: LLMSchema;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: string[];
     creditsUsed?: number;
 }
@@ -1623,6 +1629,8 @@ interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any> {
 interface DeepResearchResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for deep research operations.
@@ -1662,6 +1670,8 @@ interface DeepResearchStatusResponse {
         description: string;
     }>;
     summaries: string[];
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Parameters for LLMs.txt generation operations.
@@ -1693,6 +1703,8 @@ interface GenerateLLMsTextParams {
 interface GenerateLLMsTextResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for LLMs.txt generation operations.
@@ -1706,6 +1718,8 @@ interface GenerateLLMsTextStatusResponse {
     status: "processing" | "completed" | "failed";
     error?: string;
     expiresAt: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Response interface for queue status operations.
@@ -1955,6 +1969,7 @@ declare class FirecrawlApp {
      * @param onActivity - Optional callback to receive activity updates in real-time.
      * @param onSource - Optional callback to receive source updates in real-time.
      * @returns The final research results.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     deepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>, onActivity?: (activity: {
         type: string;
@@ -1972,12 +1987,14 @@ declare class FirecrawlApp {
      * Initiates a deep research operation on a given query without polling.
      * @param params - Parameters for the deep research operation.
      * @returns The response containing the research job ID.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse>;
     /**
      * Checks the status of a deep research operation.
      * @param id - The ID of the deep research operation.
      * @returns The current status and results of the research operation.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     checkDeepResearchStatus(id: string): Promise<DeepResearchStatusResponse | ErrorResponse>;
     /**
@@ -2014,6 +2031,7 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The final generation results.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     generateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**
@@ -2021,12 +2039,14 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The response containing the generation job ID.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     asyncGenerateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextResponse | ErrorResponse>;
     /**
      * Checks the status of a LLMs.txt generation operation.
      * @param id - The ID of the LLMs.txt generation operation.
      * @returns The current status and results of the generation operation.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     checkGenerateLLMsTextStatus(id: string): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-WTZQ5IMF.js";
+} from "./chunk-ZR3KTUEQ.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -302,6 +302,9 @@ function ensureValidParseFormats(formats) {
       if (fmt === "branding") {
         throw new Error("parse does not support branding format");
       }
+      if (fmt === "audio" || fmt === "video") {
+        throw new Error(`parse does not support ${fmt} format`);
+      }
       continue;
     }
     const type = fmt.type;
@@ -314,6 +317,9 @@ function ensureValidParseFormats(formats) {
     if (type === "branding") {
       throw new Error("parse does not support branding format");
     }
+    if (type === "audio" || type === "video") {
+      throw new Error(`parse does not support ${type} format`);
+    }
     if (fmt.type === "json") {
       const j = fmt;
       if (!j.prompt && !j.schema) {
@@ -2036,7 +2042,7 @@ var FirecrawlApp = class {
       if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
         return process.env.npm_package_version;
       }
-      const packageJson = await import("./package-YDTOLYXI.js");
+      const packageJson = await import("./package-APBHZ5F3.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
@@ -2862,6 +2868,7 @@ var FirecrawlApp = class {
    * @param onActivity - Optional callback to receive activity updates in real-time.
    * @param onSource - Optional callback to receive source updates in real-time.
    * @returns The final research results.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async deepResearch(query, params, onActivity, onSource) {
     try {
@@ -2918,6 +2925,7 @@ var FirecrawlApp = class {
    * Initiates a deep research operation on a given query without polling.
    * @param params - Parameters for the deep research operation.
    * @returns The response containing the research job ID.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async asyncDeepResearch(query, params) {
     const headers = this.prepareHeaders();
@@ -2955,6 +2963,7 @@ var FirecrawlApp = class {
    * Checks the status of a deep research operation.
    * @param id - The ID of the deep research operation.
    * @returns The current status and results of the research operation.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async checkDeepResearchStatus(id) {
     const headers = this.prepareHeaders();
@@ -3093,6 +3102,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The final generation results.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async generateLLMsText(url, params) {
     try {
@@ -3134,6 +3144,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The response containing the generation job ID.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async asyncGenerateLLMsText(url, params) {
     const headers = this.prepareHeaders();
@@ -3162,6 +3173,7 @@ var FirecrawlApp = class {
    * Checks the status of a LLMs.txt generation operation.
    * @param id - The ID of the LLMs.txt generation operation.
    * @returns The current status and results of the generation operation.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async checkGenerateLLMsTextStatus(id) {
     const headers = this.prepareHeaders();

package/dist/{package-YDTOLYXI.js → package-APBHZ5F3.js}

@@ -1,4 +1,4 @@
 import {
   require_package
-} from "./chunk-WTZQ5IMF.js";
+} from "./chunk-ZR3KTUEQ.js";
 export default require_package();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl",
-  "version": "4.22.1",
+  "version": "4.23.0",
   "description": "JavaScript SDK for Firecrawl API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/__tests__/unit/v2/parse.unit.test.ts

@@ -38,6 +38,24 @@ describe("v2.parse unit", () => {
     ).rejects.toThrow("parse does not support changeTracking format");
   });
 
+  test("rejects video format before making requests", async () => {
+    const client = new FirecrawlClient({
+      apiKey: "test-key",
+      apiUrl: "https://localhost:3002",
+    });
+
+    await expect(
+      client.parse(
+        {
+          data: Buffer.from("<html></html>"),
+          filename: "upload.html",
+          contentType: "text/html",
+        },
+        { formats: ["video" as any] },
+      ),
+    ).rejects.toThrow("parse does not support video format");
+  });
+
   test("rejects lockdown option before making requests", async () => {
     const client = new FirecrawlClient({
       apiKey: "test-key",

package/src/__tests__/unit/v2/validation.test.ts

@@ -9,6 +9,11 @@ describe("v2 utils: validation", () => {
     expect(() => ensureValidFormats(formats)).toThrow(/json format must be an object/i);
   });
 
+  test("ensureValidFormats: accepts video string format", () => {
+    const formats: FormatOption[] = ["markdown", "video"];
+    expect(() => ensureValidFormats(formats)).not.toThrow();
+  });
+
   test("ensureValidFormats: json format requires prompt or schema", () => {
     // Valid cases - should not throw
     const valid1: FormatOption[] = [{ type: "json", prompt: "p" } as any];

package/src/v1/index.ts

@@ -363,6 +363,8 @@ export interface ExtractResponse<LLMSchema extends zt.ZodSchema = any> {
   data: LLMSchema;
   error?: string;
   warning?: string;
+  warnings?: string[];
+  replacement?: string;
   sources?: string[];
   creditsUsed?: number;
 }
@@ -490,6 +492,8 @@ export interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any>  {
 export interface DeepResearchResponse {
   success: boolean;
   id: string;
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -530,6 +534,8 @@ export interface DeepResearchStatusResponse {
     description: string;
   }>;
   summaries: string[];
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -563,6 +569,8 @@ export interface GenerateLLMsTextParams {
 export interface GenerateLLMsTextResponse {
   success: boolean;
   id: string;
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -577,6 +585,8 @@ export interface GenerateLLMsTextStatusResponse {
   status: "processing" | "completed" | "failed";
   error?: string;
   expiresAt: string;
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -1626,6 +1636,7 @@ export default class FirecrawlApp {
    * @param onActivity - Optional callback to receive activity updates in real-time.
    * @param onSource - Optional callback to receive source updates in real-time.
    * @returns The final research results.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async deepResearch(
     query: string, 
@@ -1713,6 +1724,7 @@ export default class FirecrawlApp {
    * Initiates a deep research operation on a given query without polling.
    * @param params - Parameters for the deep research operation.
    * @returns The response containing the research job ID.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse> {
     const headers = this.prepareHeaders();
@@ -1754,6 +1766,7 @@ export default class FirecrawlApp {
    * Checks the status of a deep research operation.
    * @param id - The ID of the deep research operation.
    * @returns The current status and results of the research operation.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async checkDeepResearchStatus(id: string): Promise<DeepResearchStatusResponse | ErrorResponse> {
     const headers = this.prepareHeaders();
@@ -1921,6 +1934,7 @@ export default class FirecrawlApp {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The final generation results.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async generateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextStatusResponse | ErrorResponse> {
     try {
@@ -1973,6 +1987,7 @@ export default class FirecrawlApp {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The response containing the generation job ID.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async asyncGenerateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextResponse | ErrorResponse> {
     const headers = this.prepareHeaders();
@@ -2003,6 +2018,7 @@ export default class FirecrawlApp {
    * Checks the status of a LLMs.txt generation operation.
    * @param id - The ID of the LLMs.txt generation operation.
    * @returns The current status and results of the generation operation.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async checkGenerateLLMsTextStatus(id: string): Promise<GenerateLLMsTextStatusResponse | ErrorResponse> {
     const headers = this.prepareHeaders();

package/src/v2/client.ts

@@ -204,6 +204,7 @@ export class FirecrawlClient {
    * @param file File payload (data, filename, optional contentType).
    * @param options Optional parse options (formats, parsers, etc.).
    *                Note: parse does not support changeTracking, screenshot, branding,
+   *                audio, video,
    *                actions, waitFor, location, or mobile options.
    * @returns Parsed document with requested formats.
    */

package/src/v2/types.ts

@@ -13,7 +13,8 @@ export type FormatString =
   | 'json'
   | 'attributes'
   | 'branding'
-  | 'audio';
+  | 'audio'
+  | 'video';
 
 export interface Viewport {
   width: number;
@@ -82,7 +83,7 @@ export type FormatOption =
 
 export type ParseFormatString = Exclude<
   FormatString,
-  'screenshot' | 'changeTracking' | 'branding'
+  'screenshot' | 'changeTracking' | 'branding' | 'audio' | 'video'
 >;
 
 export interface ParseFormat {
@@ -458,6 +459,7 @@ export interface Document {
   images?: string[];
   screenshot?: string;
   audio?: string;
+  video?: string;
   attributes?: Array<{
     selector: string;
     attribute: string;
@@ -777,6 +779,8 @@ export interface ExtractResponse {
   data?: unknown;
   error?: string;
   warning?: string;
+  warnings?: string[];
+  replacement?: string;
   sources?: Record<string, unknown>;
   expiresAt?: string;
   creditsUsed?: number;

package/src/v2/utils/validation.ts

@@ -114,6 +114,9 @@ export function ensureValidParseFormats(formats?: ParseFormatOption[]): void {
       if (fmt === "branding") {
         throw new Error("parse does not support branding format");
       }
+      if (fmt === "audio" || fmt === "video") {
+        throw new Error(`parse does not support ${fmt} format`);
+      }
       continue;
     }
 
@@ -127,6 +130,9 @@ export function ensureValidParseFormats(formats?: ParseFormatOption[]): void {
     if (type === "branding") {
       throw new Error("parse does not support branding format");
     }
+    if (type === "audio" || type === "video") {
+      throw new Error(`parse does not support ${type} format`);
+    }
 
     if ((fmt as JsonFormat).type === "json") {
       const j = fmt as JsonFormat;