firecrawl 4.3.1 → 4.3.3

package/dist/{chunk-VFP5PS5Z.js → chunk-7RR2L6KO.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.3.1",
+      version: "4.3.3",
       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.3.1",
+      version: "4.3.3",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -334,6 +334,7 @@ function prepareSearchPayload(req) {
   if (req.location != null) payload.location = req.location;
   if (req.ignoreInvalidURLs != null) payload.ignoreInvalidURLs = req.ignoreInvalidURLs;
   if (req.timeout != null) payload.timeout = req.timeout;
+  if (req.integration && req.integration.trim()) payload.integration = req.integration.trim();
   if (req.scrapeOptions) {
     ensureValidScrapeOptions(req.scrapeOptions);
     payload.scrapeOptions = req.scrapeOptions;
@@ -384,6 +385,8 @@ function prepareMapPayload(url, options) {
     if (options.includeSubdomains != null) payload.includeSubdomains = options.includeSubdomains;
     if (options.limit != null) payload.limit = options.limit;
     if (options.timeout != null) payload.timeout = options.timeout;
+    if (options.integration != null && options.integration.trim()) payload.integration = options.integration.trim();
+    if (options.location != null) payload.location = options.location;
   }
   return payload;
 }
@@ -455,6 +458,7 @@ function prepareCrawlPayload(request) {
   if (request.delay != null) data.delay = request.delay;
   if (request.maxConcurrency != null) data.maxConcurrency = request.maxConcurrency;
   if (request.webhook != null) data.webhook = request.webhook;
+  if (request.integration != null && request.integration.trim()) data.integration = request.integration.trim();
   if (request.scrapeOptions) {
     ensureValidScrapeOptions(request.scrapeOptions);
     data.scrapeOptions = request.scrapeOptions;
@@ -581,8 +585,8 @@ async function startBatchScrape(http, urls, {
   ignoreInvalidURLs,
   maxConcurrency,
   zeroDataRetention,
-  integration,
-  idempotencyKey
+  idempotencyKey,
+  integration
 } = {}) {
   if (!Array.isArray(urls) || urls.length === 0) throw new Error("URLs list cannot be empty");
   const payload = { urls };
@@ -595,7 +599,7 @@ async function startBatchScrape(http, urls, {
   if (ignoreInvalidURLs != null) payload.ignoreInvalidURLs = ignoreInvalidURLs;
   if (maxConcurrency != null) payload.maxConcurrency = maxConcurrency;
   if (zeroDataRetention != null) payload.zeroDataRetention = zeroDataRetention;
-  if (integration != null) payload.integration = integration;
+  if (integration != null && integration.trim()) payload.integration = integration.trim();
   try {
     const headers = http.prepareHeaders(idempotencyKey);
     const res = await http.post("/v2/batch/scrape", payload, headers);
@@ -692,6 +696,7 @@ function prepareExtractPayload(args) {
   if (args.enableWebSearch != null) body.enableWebSearch = args.enableWebSearch;
   if (args.showSources != null) body.showSources = args.showSources;
   if (args.ignoreInvalidURLs != null) body.ignoreInvalidURLs = args.ignoreInvalidURLs;
+  if (args.integration && args.integration.trim()) body.integration = args.integration.trim();
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
     body.scrapeOptions = args.scrapeOptions;

package/dist/index.d.cts

@@ -41,7 +41,7 @@ interface AttributesFormat extends Format {
     }>;
 }
 type FormatOption = FormatString | Format | JsonFormat | ChangeTrackingFormat | ScreenshotFormat | AttributesFormat;
-interface LocationConfig {
+interface LocationConfig$1 {
     country?: string;
     languages?: string[];
 }
@@ -104,7 +104,7 @@ interface ScrapeOptions {
         maxPages?: number;
     }>;
     actions?: ActionOption[];
-    location?: LocationConfig;
+    location?: LocationConfig$1;
     skipTlsVerification?: boolean;
     removeBase64Images?: boolean;
     fastMode?: boolean;
@@ -113,6 +113,7 @@ interface ScrapeOptions {
     proxy?: "basic" | "stealth" | "auto" | string;
     maxAge?: number;
     storeInCache?: boolean;
+    integration?: string;
 }
 interface WebhookConfig {
     url: string;
@@ -207,6 +208,7 @@ interface SearchRequest {
     ignoreInvalidURLs?: boolean;
     timeout?: number;
     scrapeOptions?: ScrapeOptions;
+    integration?: string;
 }
 interface CrawlOptions {
     prompt?: string | null;
@@ -224,6 +226,7 @@ interface CrawlOptions {
     webhook?: string | WebhookConfig | null;
     scrapeOptions?: ScrapeOptions | null;
     zeroDataRetention?: boolean;
+    integration?: string;
 }
 interface CrawlResponse$1 {
     id: string;
@@ -245,8 +248,8 @@ interface BatchScrapeOptions {
     ignoreInvalidURLs?: boolean;
     maxConcurrency?: number;
     zeroDataRetention?: boolean;
-    integration?: string;
     idempotencyKey?: string;
+    integration?: string;
 }
 interface BatchScrapeResponse$1 {
     id: string;
@@ -271,6 +274,8 @@ interface MapOptions {
     includeSubdomains?: boolean;
     limit?: number;
     timeout?: number;
+    integration?: string;
+    location?: LocationConfig$1;
 }
 interface ExtractResponse$1 {
     success?: boolean;
@@ -393,6 +398,7 @@ declare function prepareExtractPayload(args: {
     showSources?: boolean;
     scrapeOptions?: ScrapeOptions;
     ignoreInvalidURLs?: boolean;
+    integration?: string;
 }): Record<string, unknown>;
 declare function startExtract(http: HttpClient, args: Parameters<typeof prepareExtractPayload>[0]): Promise<ExtractResponse$1>;
 
@@ -687,6 +693,13 @@ interface FirecrawlDocument<T = any, ActionsSchema extends (ActionsResult | neve
     title?: string;
     description?: string;
 }
+/**
+ * Location configuration for proxy location
+ */
+interface LocationConfig {
+    country?: string;
+    languages?: string[];
+}
 /**
  * Parameters for scraping operations.
  * Defines the options and configurations available for scraping web content.
@@ -699,10 +712,7 @@ interface CrawlScrapeOptions {
     onlyMainContent?: boolean;
     waitFor?: number;
     timeout?: number;
-    location?: {
-        country?: string;
-        languages?: string[];
-    };
+    location?: LocationConfig;
     mobile?: boolean;
     skipTlsVerification?: boolean;
     removeBase64Images?: boolean;
@@ -875,6 +885,7 @@ interface MapParams {
     limit?: number;
     timeout?: number;
     useIndex?: boolean;
+    location?: LocationConfig;
 }
 /**
  * Response interface for mapping operations.
@@ -1487,4 +1498,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.d.ts

@@ -41,7 +41,7 @@ interface AttributesFormat extends Format {
     }>;
 }
 type FormatOption = FormatString | Format | JsonFormat | ChangeTrackingFormat | ScreenshotFormat | AttributesFormat;
-interface LocationConfig {
+interface LocationConfig$1 {
     country?: string;
     languages?: string[];
 }
@@ -104,7 +104,7 @@ interface ScrapeOptions {
         maxPages?: number;
     }>;
     actions?: ActionOption[];
-    location?: LocationConfig;
+    location?: LocationConfig$1;
     skipTlsVerification?: boolean;
     removeBase64Images?: boolean;
     fastMode?: boolean;
@@ -113,6 +113,7 @@ interface ScrapeOptions {
     proxy?: "basic" | "stealth" | "auto" | string;
     maxAge?: number;
     storeInCache?: boolean;
+    integration?: string;
 }
 interface WebhookConfig {
     url: string;
@@ -207,6 +208,7 @@ interface SearchRequest {
     ignoreInvalidURLs?: boolean;
     timeout?: number;
     scrapeOptions?: ScrapeOptions;
+    integration?: string;
 }
 interface CrawlOptions {
     prompt?: string | null;
@@ -224,6 +226,7 @@ interface CrawlOptions {
     webhook?: string | WebhookConfig | null;
     scrapeOptions?: ScrapeOptions | null;
     zeroDataRetention?: boolean;
+    integration?: string;
 }
 interface CrawlResponse$1 {
     id: string;
@@ -245,8 +248,8 @@ interface BatchScrapeOptions {
     ignoreInvalidURLs?: boolean;
     maxConcurrency?: number;
     zeroDataRetention?: boolean;
-    integration?: string;
     idempotencyKey?: string;
+    integration?: string;
 }
 interface BatchScrapeResponse$1 {
     id: string;
@@ -271,6 +274,8 @@ interface MapOptions {
     includeSubdomains?: boolean;
     limit?: number;
     timeout?: number;
+    integration?: string;
+    location?: LocationConfig$1;
 }
 interface ExtractResponse$1 {
     success?: boolean;
@@ -393,6 +398,7 @@ declare function prepareExtractPayload(args: {
     showSources?: boolean;
     scrapeOptions?: ScrapeOptions;
     ignoreInvalidURLs?: boolean;
+    integration?: string;
 }): Record<string, unknown>;
 declare function startExtract(http: HttpClient, args: Parameters<typeof prepareExtractPayload>[0]): Promise<ExtractResponse$1>;
 
@@ -687,6 +693,13 @@ interface FirecrawlDocument<T = any, ActionsSchema extends (ActionsResult | neve
     title?: string;
     description?: string;
 }
+/**
+ * Location configuration for proxy location
+ */
+interface LocationConfig {
+    country?: string;
+    languages?: string[];
+}
 /**
  * Parameters for scraping operations.
  * Defines the options and configurations available for scraping web content.
@@ -699,10 +712,7 @@ interface CrawlScrapeOptions {
     onlyMainContent?: boolean;
     waitFor?: number;
     timeout?: number;
-    location?: {
-        country?: string;
-        languages?: string[];
-    };
+    location?: LocationConfig;
     mobile?: boolean;
     skipTlsVerification?: boolean;
     removeBase64Images?: boolean;
@@ -875,6 +885,7 @@ interface MapParams {
     limit?: number;
     timeout?: number;
     useIndex?: boolean;
+    location?: LocationConfig;
 }
 /**
  * Response interface for mapping operations.
@@ -1487,4 +1498,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-VFP5PS5Z.js";
+} from "./chunk-7RR2L6KO.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -218,6 +218,7 @@ function prepareSearchPayload(req) {
   if (req.location != null) payload.location = req.location;
   if (req.ignoreInvalidURLs != null) payload.ignoreInvalidURLs = req.ignoreInvalidURLs;
   if (req.timeout != null) payload.timeout = req.timeout;
+  if (req.integration && req.integration.trim()) payload.integration = req.integration.trim();
   if (req.scrapeOptions) {
     ensureValidScrapeOptions(req.scrapeOptions);
     payload.scrapeOptions = req.scrapeOptions;
@@ -268,6 +269,8 @@ function prepareMapPayload(url, options) {
     if (options.includeSubdomains != null) payload.includeSubdomains = options.includeSubdomains;
     if (options.limit != null) payload.limit = options.limit;
     if (options.timeout != null) payload.timeout = options.timeout;
+    if (options.integration != null && options.integration.trim()) payload.integration = options.integration.trim();
+    if (options.location != null) payload.location = options.location;
   }
   return payload;
 }
@@ -339,6 +342,7 @@ function prepareCrawlPayload(request) {
   if (request.delay != null) data.delay = request.delay;
   if (request.maxConcurrency != null) data.maxConcurrency = request.maxConcurrency;
   if (request.webhook != null) data.webhook = request.webhook;
+  if (request.integration != null && request.integration.trim()) data.integration = request.integration.trim();
   if (request.scrapeOptions) {
     ensureValidScrapeOptions(request.scrapeOptions);
     data.scrapeOptions = request.scrapeOptions;
@@ -465,8 +469,8 @@ async function startBatchScrape(http, urls, {
   ignoreInvalidURLs,
   maxConcurrency,
   zeroDataRetention,
-  integration,
-  idempotencyKey
+  idempotencyKey,
+  integration
 } = {}) {
   if (!Array.isArray(urls) || urls.length === 0) throw new Error("URLs list cannot be empty");
   const payload = { urls };
@@ -479,7 +483,7 @@ async function startBatchScrape(http, urls, {
   if (ignoreInvalidURLs != null) payload.ignoreInvalidURLs = ignoreInvalidURLs;
   if (maxConcurrency != null) payload.maxConcurrency = maxConcurrency;
   if (zeroDataRetention != null) payload.zeroDataRetention = zeroDataRetention;
-  if (integration != null) payload.integration = integration;
+  if (integration != null && integration.trim()) payload.integration = integration.trim();
   try {
     const headers = http.prepareHeaders(idempotencyKey);
     const res = await http.post("/v2/batch/scrape", payload, headers);
@@ -576,6 +580,7 @@ function prepareExtractPayload(args) {
   if (args.enableWebSearch != null) body.enableWebSearch = args.enableWebSearch;
   if (args.showSources != null) body.showSources = args.showSources;
   if (args.ignoreInvalidURLs != null) body.ignoreInvalidURLs = args.ignoreInvalidURLs;
+  if (args.integration && args.integration.trim()) body.integration = args.integration.trim();
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
     body.scrapeOptions = args.scrapeOptions;
@@ -1059,7 +1064,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-ZQ5CJHCA.js");
+      const packageJson = await import("./package-FLU7SABK.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-ZQ5CJHCA.js → package-FLU7SABK.js}

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

package/package.json

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

package/src/v1/index.ts

@@ -102,6 +102,14 @@ export interface FirecrawlDocument<T = any, ActionsSchema extends (ActionsResult
   description?: string;
 }
 
+/**
+ * Location configuration for proxy location
+ */
+export interface LocationConfig {
+  country?: string;
+  languages?: string[];
+}
+
 /**
  * Parameters for scraping operations.
  * Defines the options and configurations available for scraping web content.
@@ -114,10 +122,7 @@ export interface CrawlScrapeOptions {
   onlyMainContent?: boolean;
   waitFor?: number;
   timeout?: number;
-  location?: {
-    country?: string;
-    languages?: string[];
-  };
+  location?: LocationConfig;
   mobile?: boolean;
   skipTlsVerification?: boolean;
   removeBase64Images?: boolean;
@@ -300,6 +305,7 @@ export interface MapParams {
   limit?: number;
   timeout?: number;
   useIndex?: boolean;
+  location?: LocationConfig;
 }
 
 /**

package/src/v2/methods/batch.ts

@@ -21,8 +21,8 @@ export async function startBatchScrape(
     ignoreInvalidURLs,
     maxConcurrency,
     zeroDataRetention,
-    integration,
     idempotencyKey,
+    integration,
   }: BatchScrapeOptions = {}
 ): Promise<BatchScrapeResponse> {
   if (!Array.isArray(urls) || urls.length === 0) throw new Error("URLs list cannot be empty");
@@ -36,7 +36,7 @@ export async function startBatchScrape(
   if (ignoreInvalidURLs != null) payload.ignoreInvalidURLs = ignoreInvalidURLs;
   if (maxConcurrency != null) payload.maxConcurrency = maxConcurrency;
   if (zeroDataRetention != null) payload.zeroDataRetention = zeroDataRetention;
-  if (integration != null) payload.integration = integration;
+  if (integration != null && integration.trim()) payload.integration = integration.trim();
 
   try {
     const headers = http.prepareHeaders(idempotencyKey);

package/src/v2/methods/crawl.ts

@@ -33,6 +33,7 @@ function prepareCrawlPayload(request: CrawlRequest): Record<string, unknown> {
   if (request.delay != null) data.delay = request.delay;
   if (request.maxConcurrency != null) data.maxConcurrency = request.maxConcurrency;
   if (request.webhook != null) data.webhook = request.webhook;
+  if (request.integration != null && request.integration.trim()) data.integration = request.integration.trim();
   if (request.scrapeOptions) {
     ensureValidScrapeOptions(request.scrapeOptions);
     data.scrapeOptions = request.scrapeOptions;

package/src/v2/methods/extract.ts

@@ -15,6 +15,7 @@ function prepareExtractPayload(args: {
   showSources?: boolean;
   scrapeOptions?: ScrapeOptions;
   ignoreInvalidURLs?: boolean;
+  integration?: string;
 }): Record<string, unknown> {
   const body: Record<string, unknown> = {};
   if (args.urls) body.urls = args.urls;
@@ -29,6 +30,7 @@ function prepareExtractPayload(args: {
   if (args.enableWebSearch != null) body.enableWebSearch = args.enableWebSearch;
   if (args.showSources != null) body.showSources = args.showSources;
   if (args.ignoreInvalidURLs != null) body.ignoreInvalidURLs = args.ignoreInvalidURLs;
+  if (args.integration && args.integration.trim()) body.integration = args.integration.trim();
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
     body.scrapeOptions = args.scrapeOptions;

package/src/v2/methods/map.ts

@@ -1,4 +1,4 @@
-import { type MapData, type MapOptions, type SearchResult } from "../types";
+import { type MapData, type MapOptions, type SearchResultWeb } from "../types";
 import { HttpClient } from "../utils/httpClient";
 import { throwForBadResponse, normalizeAxiosError } from "../utils/errorHandler";
 
@@ -11,6 +11,8 @@ function prepareMapPayload(url: string, options?: MapOptions): Record<string, un
     if (options.includeSubdomains != null) payload.includeSubdomains = options.includeSubdomains;
     if (options.limit != null) payload.limit = options.limit;
     if (options.timeout != null) payload.timeout = options.timeout;
+    if (options.integration != null && options.integration.trim()) payload.integration = options.integration.trim();
+    if (options.location != null) payload.location = options.location;
   }
   return payload;
 }
@@ -18,12 +20,12 @@ function prepareMapPayload(url: string, options?: MapOptions): Record<string, un
 export async function map(http: HttpClient, url: string, options?: MapOptions): Promise<MapData> {
   const payload = prepareMapPayload(url, options);
   try {
-    const res = await http.post<{ success: boolean; error?: string; links?: Array<string | SearchResult> }>("/v2/map", payload);
+    const res = await http.post<{ success: boolean; error?: string; links?: Array<string | SearchResultWeb> }>("/v2/map", payload);
     if (res.status !== 200 || !res.data?.success) {
       throwForBadResponse(res, "map");
     }
     const linksIn = res.data.links || [];
-    const links: SearchResult[] = [];
+    const links: SearchResultWeb[] = [];
     for (const item of linksIn) {
       if (typeof item === "string") links.push({ url: item });
       else if (item && typeof item === "object") links.push({ url: item.url, title: (item as any).title, description: (item as any).description });

package/src/v2/methods/search.ts

@@ -17,6 +17,7 @@ function prepareSearchPayload(req: SearchRequest): Record<string, unknown> {
   if (req.location != null) payload.location = req.location;
   if (req.ignoreInvalidURLs != null) payload.ignoreInvalidURLs = req.ignoreInvalidURLs;
   if (req.timeout != null) payload.timeout = req.timeout;
+  if (req.integration && req.integration.trim()) payload.integration = req.integration.trim();
   if (req.scrapeOptions) {
     ensureValidScrapeOptions(req.scrapeOptions as ScrapeOptions);
     payload.scrapeOptions = req.scrapeOptions;

package/src/v2/types.ts

@@ -144,6 +144,7 @@ export interface ScrapeOptions {
   proxy?: "basic" | "stealth" | "auto" | string;
   maxAge?: number;
   storeInCache?: boolean;
+  integration?: string;
 }
 
 export interface WebhookConfig {
@@ -247,6 +248,7 @@ export interface SearchRequest {
   ignoreInvalidURLs?: boolean;
   timeout?: number; // ms
   scrapeOptions?: ScrapeOptions;
+  integration?: string;
 }
 
 export interface CrawlOptions {
@@ -265,6 +267,7 @@ export interface CrawlOptions {
   webhook?: string | WebhookConfig | null;
   scrapeOptions?: ScrapeOptions | null;
   zeroDataRetention?: boolean;
+  integration?: string;
 }
 
 export interface CrawlResponse {
@@ -289,8 +292,8 @@ export interface BatchScrapeOptions {
   ignoreInvalidURLs?: boolean;
   maxConcurrency?: number;
   zeroDataRetention?: boolean;
-  integration?: string;
   idempotencyKey?: string;
+  integration?: string;
 }
 
 export interface BatchScrapeResponse {
@@ -319,6 +322,8 @@ export interface MapOptions {
   includeSubdomains?: boolean;
   limit?: number;
   timeout?: number;
+  integration?: string;
+  location?: LocationConfig;
 }
 
 export interface ExtractResponse {