mcpscraper-sdk 0.49.1 → 0.50.1

package/README.md

@@ -45,7 +45,7 @@ Google Search light mode returns organic positions, URLs, titles, and descriptio
 
 ## API surface
 
-`client.tools` is the generated, typed 362-tool MCP surface from `contracts/mcp.tools.json`, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
+`client.tools` is the generated, typed 364-tool MCP surface from `contracts/mcp.tools.json`, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
 
 For multimodal results such as `meta_ad_creative_media`, call `client.tools.callToolResult(...)` to preserve native MCP image/audio/resource blocks. `callTool(...)` remains backward-compatible and returns the parsed structured or text value.
 
@@ -191,4 +191,4 @@ npm run generate
 
 [Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 121-tool direct-memory surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)
 
-Release changes: [SDK 0.49.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.49.0).
+Release changes: [SDK 0.50.1 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.50.1).

package/dist/index.cjs

@@ -342,8 +342,43 @@ var MapsNamespace = class {
   search(params, options = {}) {
     return this.r.call("POST", "/maps/search", params, {}, options);
   }
-  place(params) {
-    return this.r.call("POST", "/maps/place", params);
+  place(params, options = {}) {
+    const headers = {
+      ...options.idempotencyKey ? { "Idempotency-Key": options.idempotencyKey } : {},
+      ...options.runId ? { "X-Maps-Run-Id": options.runId } : {}
+    };
+    return this.r.call("POST", "/maps/place", params, headers, options);
+  }
+  placeStatus(runId, options = {}) {
+    const query = new URLSearchParams();
+    if (options.reviewsCursor) query.set("reviewsCursor", options.reviewsCursor);
+    if (options.imagesCursor) query.set("imagesCursor", options.imagesCursor);
+    if (options.limit != null) query.set("limit", String(options.limit));
+    const suffix = query.size ? `?${query.toString()}` : "";
+    return this.r.call("GET", `/maps/place/runs/${encodeURIComponent(runId)}${suffix}`);
+  }
+  placeReviews(runId, cursor, limit) {
+    const query = new URLSearchParams();
+    if (cursor) query.set("cursor", cursor);
+    if (limit != null) query.set("limit", String(limit));
+    const suffix = query.size ? `?${query.toString()}` : "";
+    return this.r.call("GET", `/maps/place/runs/${encodeURIComponent(runId)}/reviews${suffix}`);
+  }
+  placeImages(runId, cursor, limit) {
+    const query = new URLSearchParams();
+    if (cursor) query.set("cursor", cursor);
+    if (limit != null) query.set("limit", String(limit));
+    const suffix = query.size ? `?${query.toString()}` : "";
+    return this.r.call("GET", `/maps/place/runs/${encodeURIComponent(runId)}/images${suffix}`);
+  }
+  placeResume(runId, resumeIdempotencyKey, options = {}) {
+    return this.r.call(
+      "POST",
+      `/maps/place/runs/${encodeURIComponent(runId)}/resume`,
+      void 0,
+      { "Idempotency-Key": resumeIdempotencyKey },
+      options
+    );
   }
 };
 var DirectoryNamespace = class {

package/dist/index.d.cts

@@ -42,9 +42,12 @@ interface paths {
         put?: never;
         /**
          * Run a Google SERP search, or a full People-Also-Ask harvest
-         * @description Set `serpOnly: true` for a pure organic-results/SERP call (20 Credits per
-         *     delivered page, or 35 Credits per delivered page if the backup supplies
-         *     the result). A 35-Credit-per-requested-page hold is settled after delivery.
+         * @description Set `serpOnly: true` for a Google search. Light mode returns organic
+         *     positions, URLs, titles, and descriptions for 20 Credits per delivered
+         *     page, or 35 Credits when the backup supplies the result. Full mode adds
+         *     available same-page SERP features for 35 Credits per delivered page.
+         *     Both modes default to one page; set `pages: 2` explicitly for two.
+         *     A 35-Credit-per-requested-page hold is settled after delivery.
          *     Omit or set `false` for a full People-Also-Ask harvest, which also returns SERP data
          *     (400 Credit base + 10 Credits per question actually returned; unused estimate is
          *     refunded). Runs synchronously and returns the result inline.
@@ -663,8 +666,8 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Deep-dive one Google Maps business by name and location, with reviews
-         * @description 60 credits base; +1 credit per review card when `includeReviews` is true.
+         * Start a recoverable Google Maps business profile lookup
+         * @description Provide an Idempotency-Key and X-Maps-Run-Id to recover an unknown transport outcome. A maximum declared charge is held before browsing; completed work settles at 60 credits plus 1 credit per saved review card.
          */
         post: operations["mapsPlaceIntel"];
         delete?: never;
@@ -673,6 +676,74 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/maps/place/runs/{runId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read an owner-scoped saved Maps place run */
+        get: operations["mapsPlaceStatus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/maps/place/runs/{runId}/reviews": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Page through saved review cards */
+        get: operations["mapsPlaceReviews"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/maps/place/runs/{runId}/images": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Page through saved image references */
+        get: operations["mapsPlaceImages"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/maps/place/runs/{runId}/resume": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Explicitly resume a partial or reconciled interrupted Maps place run */
+        post: operations["mapsPlaceResume"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/directory/run": {
         parameters: {
             query?: never;
@@ -1219,10 +1290,16 @@ interface components {
             /** @description Optional US ZIP override. */
             proxyZip?: string;
             /**
-             * @description Organic result pages to fetch.
+             * @description Google result pages to fetch. Full mode alone does not request page 2.
              * @default 1
              */
             pages: number;
+            /**
+             * @description For serpOnly searches: light returns organic results; full adds available same-page SERP features.
+             * @default light
+             * @enum {string}
+             */
+            mode: "light" | "full";
             /**
              * @description true = pure SERP call (search_serp); false = full PAA harvest.
              * @default false
@@ -1697,6 +1774,48 @@ interface components {
             includeReviews: boolean;
             /** @default 50 */
             maxReviews: number;
+            /** @default false */
+            includeServices: boolean;
+            /** @default false */
+            includeImages: boolean;
+            include?: ("core" | "hours" | "services" | "areasServed" | "reviews" | "images" | "all")[];
+            /**
+             * @default all
+             * @enum {string}
+             */
+            imageScope: "owner" | "all";
+            /** @default 100 */
+            maxImages: number;
+            /** @default 3 */
+            maxInlineImages: number;
+        };
+        MapsPlaceRunResponse: {
+            /** Format: uuid */
+            runId: string;
+            /** @enum {string} */
+            runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+            verified: boolean;
+            checkpointRevision: number;
+            billingState: string;
+            name?: string | null;
+            placeUrl?: string | null;
+            completedFields?: string[];
+            pendingFields?: string[];
+            unavailableFields?: string[];
+            reviewsCollected?: number;
+            imagesCollected?: number;
+            reviewsNextCursor?: string | null;
+            imagesNextCursor?: string | null;
+        } & {
+            [key: string]: unknown;
+        };
+        MapsPlaceItemPage: {
+            /** Format: uuid */
+            runId: string;
+            items: {
+                [key: string]: unknown;
+            }[];
+            nextCursor: string | null;
         };
         SerpIntelligenceCaptureRequest: {
             query: string;
@@ -3360,7 +3479,12 @@ interface operations {
     mapsPlaceIntel: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Caller-generated key for same-request replay. */
+                "Idempotency-Key"?: string;
+                /** @description Caller-generated run ID for status recovery after response loss. */
+                "X-Maps-Run-Id"?: string;
+            };
             path?: never;
             cookie?: never;
         };
@@ -3370,23 +3494,178 @@ interface operations {
             };
         };
         responses: {
-            /** @description Place detail with optional reviews. */
+            /** @description Complete or partial saved place result. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        [key: string]: unknown;
-                    };
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Running or interrupted place run with any verified checkpoints saved so far. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
                 };
             };
             400: components["responses"]["BadRequest"];
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Temporarily blocked — retryable. */
-            503: {
+        };
+    };
+    mapsPlaceStatus: {
+        parameters: {
+            query?: {
+                /** @description Opaque saved-review cursor. */
+                reviewsCursor?: string;
+                /** @description Opaque saved-image cursor. */
+                imagesCursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved terminal run */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Saved running or interrupted run */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    mapsPlaceReviews: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved review page with items and nextCursor. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceItemPage"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    mapsPlaceImages: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved image page with items and nextCursor. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceItemPage"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    mapsPlaceResume: {
+        parameters: {
+            query?: never;
+            header: {
+                "Idempotency-Key": string;
+            };
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved terminal run. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Resumed attempt in progress. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Run or previous billing state cannot resume. */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -4390,7 +4669,79 @@ declare class MapsNamespace {
     search(params: RequestBodyOf<'mapsSearch'>, options?: ScraperRequestOptions): Promise<{
         [key: string]: unknown;
     }>;
-    place(params: RequestBodyOf<'mapsPlaceIntel'>): Promise<{
+    place(params: RequestBodyOf<'mapsPlaceIntel'>, options?: ScraperRequestOptions & {
+        idempotencyKey?: string;
+        runId?: string;
+    }): Promise<{
+        runId: string;
+        runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+        verified: boolean;
+        checkpointRevision: number;
+        billingState: string;
+        name?: string | null;
+        placeUrl?: string | null;
+        completedFields?: string[];
+        pendingFields?: string[];
+        unavailableFields?: string[];
+        reviewsCollected?: number;
+        imagesCollected?: number;
+        reviewsNextCursor?: string | null;
+        imagesNextCursor?: string | null;
+    } & {
+        [key: string]: unknown;
+    }>;
+    placeStatus(runId: string, options?: {
+        reviewsCursor?: string;
+        imagesCursor?: string;
+        limit?: number;
+    }): Promise<{
+        runId: string;
+        runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+        verified: boolean;
+        checkpointRevision: number;
+        billingState: string;
+        name?: string | null;
+        placeUrl?: string | null;
+        completedFields?: string[];
+        pendingFields?: string[];
+        unavailableFields?: string[];
+        reviewsCollected?: number;
+        imagesCollected?: number;
+        reviewsNextCursor?: string | null;
+        imagesNextCursor?: string | null;
+    } & {
+        [key: string]: unknown;
+    }>;
+    placeReviews(runId: string, cursor?: string, limit?: number): Promise<{
+        runId: string;
+        items: {
+            [key: string]: unknown;
+        }[];
+        nextCursor: string | null;
+    }>;
+    placeImages(runId: string, cursor?: string, limit?: number): Promise<{
+        runId: string;
+        items: {
+            [key: string]: unknown;
+        }[];
+        nextCursor: string | null;
+    }>;
+    placeResume(runId: string, resumeIdempotencyKey: string, options?: ScraperRequestOptions): Promise<{
+        runId: string;
+        runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+        verified: boolean;
+        checkpointRevision: number;
+        billingState: string;
+        name?: string | null;
+        placeUrl?: string | null;
+        completedFields?: string[];
+        pendingFields?: string[];
+        unavailableFields?: string[];
+        reviewsCollected?: number;
+        imagesCollected?: number;
+        reviewsNextCursor?: string | null;
+        imagesNextCursor?: string | null;
+    } & {
         [key: string]: unknown;
     }>;
 }

package/dist/index.d.ts

@@ -42,9 +42,12 @@ interface paths {
         put?: never;
         /**
          * Run a Google SERP search, or a full People-Also-Ask harvest
-         * @description Set `serpOnly: true` for a pure organic-results/SERP call (20 Credits per
-         *     delivered page, or 35 Credits per delivered page if the backup supplies
-         *     the result). A 35-Credit-per-requested-page hold is settled after delivery.
+         * @description Set `serpOnly: true` for a Google search. Light mode returns organic
+         *     positions, URLs, titles, and descriptions for 20 Credits per delivered
+         *     page, or 35 Credits when the backup supplies the result. Full mode adds
+         *     available same-page SERP features for 35 Credits per delivered page.
+         *     Both modes default to one page; set `pages: 2` explicitly for two.
+         *     A 35-Credit-per-requested-page hold is settled after delivery.
          *     Omit or set `false` for a full People-Also-Ask harvest, which also returns SERP data
          *     (400 Credit base + 10 Credits per question actually returned; unused estimate is
          *     refunded). Runs synchronously and returns the result inline.
@@ -663,8 +666,8 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Deep-dive one Google Maps business by name and location, with reviews
-         * @description 60 credits base; +1 credit per review card when `includeReviews` is true.
+         * Start a recoverable Google Maps business profile lookup
+         * @description Provide an Idempotency-Key and X-Maps-Run-Id to recover an unknown transport outcome. A maximum declared charge is held before browsing; completed work settles at 60 credits plus 1 credit per saved review card.
          */
         post: operations["mapsPlaceIntel"];
         delete?: never;
@@ -673,6 +676,74 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/maps/place/runs/{runId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read an owner-scoped saved Maps place run */
+        get: operations["mapsPlaceStatus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/maps/place/runs/{runId}/reviews": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Page through saved review cards */
+        get: operations["mapsPlaceReviews"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/maps/place/runs/{runId}/images": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Page through saved image references */
+        get: operations["mapsPlaceImages"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/maps/place/runs/{runId}/resume": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Explicitly resume a partial or reconciled interrupted Maps place run */
+        post: operations["mapsPlaceResume"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/directory/run": {
         parameters: {
             query?: never;
@@ -1219,10 +1290,16 @@ interface components {
             /** @description Optional US ZIP override. */
             proxyZip?: string;
             /**
-             * @description Organic result pages to fetch.
+             * @description Google result pages to fetch. Full mode alone does not request page 2.
              * @default 1
              */
             pages: number;
+            /**
+             * @description For serpOnly searches: light returns organic results; full adds available same-page SERP features.
+             * @default light
+             * @enum {string}
+             */
+            mode: "light" | "full";
             /**
              * @description true = pure SERP call (search_serp); false = full PAA harvest.
              * @default false
@@ -1697,6 +1774,48 @@ interface components {
             includeReviews: boolean;
             /** @default 50 */
             maxReviews: number;
+            /** @default false */
+            includeServices: boolean;
+            /** @default false */
+            includeImages: boolean;
+            include?: ("core" | "hours" | "services" | "areasServed" | "reviews" | "images" | "all")[];
+            /**
+             * @default all
+             * @enum {string}
+             */
+            imageScope: "owner" | "all";
+            /** @default 100 */
+            maxImages: number;
+            /** @default 3 */
+            maxInlineImages: number;
+        };
+        MapsPlaceRunResponse: {
+            /** Format: uuid */
+            runId: string;
+            /** @enum {string} */
+            runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+            verified: boolean;
+            checkpointRevision: number;
+            billingState: string;
+            name?: string | null;
+            placeUrl?: string | null;
+            completedFields?: string[];
+            pendingFields?: string[];
+            unavailableFields?: string[];
+            reviewsCollected?: number;
+            imagesCollected?: number;
+            reviewsNextCursor?: string | null;
+            imagesNextCursor?: string | null;
+        } & {
+            [key: string]: unknown;
+        };
+        MapsPlaceItemPage: {
+            /** Format: uuid */
+            runId: string;
+            items: {
+                [key: string]: unknown;
+            }[];
+            nextCursor: string | null;
         };
         SerpIntelligenceCaptureRequest: {
             query: string;
@@ -3360,7 +3479,12 @@ interface operations {
     mapsPlaceIntel: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Caller-generated key for same-request replay. */
+                "Idempotency-Key"?: string;
+                /** @description Caller-generated run ID for status recovery after response loss. */
+                "X-Maps-Run-Id"?: string;
+            };
             path?: never;
             cookie?: never;
         };
@@ -3370,23 +3494,178 @@ interface operations {
             };
         };
         responses: {
-            /** @description Place detail with optional reviews. */
+            /** @description Complete or partial saved place result. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        [key: string]: unknown;
-                    };
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Running or interrupted place run with any verified checkpoints saved so far. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
                 };
             };
             400: components["responses"]["BadRequest"];
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Temporarily blocked — retryable. */
-            503: {
+        };
+    };
+    mapsPlaceStatus: {
+        parameters: {
+            query?: {
+                /** @description Opaque saved-review cursor. */
+                reviewsCursor?: string;
+                /** @description Opaque saved-image cursor. */
+                imagesCursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved terminal run */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Saved running or interrupted run */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    mapsPlaceReviews: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved review page with items and nextCursor. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceItemPage"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    mapsPlaceImages: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved image page with items and nextCursor. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceItemPage"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    mapsPlaceResume: {
+        parameters: {
+            query?: never;
+            header: {
+                "Idempotency-Key": string;
+            };
+            path: {
+                runId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved terminal run. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Resumed attempt in progress. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsPlaceRunResponse"];
+                };
+            };
+            /** @description Run not found for this owner. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Run or previous billing state cannot resume. */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -4390,7 +4669,79 @@ declare class MapsNamespace {
     search(params: RequestBodyOf<'mapsSearch'>, options?: ScraperRequestOptions): Promise<{
         [key: string]: unknown;
     }>;
-    place(params: RequestBodyOf<'mapsPlaceIntel'>): Promise<{
+    place(params: RequestBodyOf<'mapsPlaceIntel'>, options?: ScraperRequestOptions & {
+        idempotencyKey?: string;
+        runId?: string;
+    }): Promise<{
+        runId: string;
+        runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+        verified: boolean;
+        checkpointRevision: number;
+        billingState: string;
+        name?: string | null;
+        placeUrl?: string | null;
+        completedFields?: string[];
+        pendingFields?: string[];
+        unavailableFields?: string[];
+        reviewsCollected?: number;
+        imagesCollected?: number;
+        reviewsNextCursor?: string | null;
+        imagesNextCursor?: string | null;
+    } & {
+        [key: string]: unknown;
+    }>;
+    placeStatus(runId: string, options?: {
+        reviewsCursor?: string;
+        imagesCursor?: string;
+        limit?: number;
+    }): Promise<{
+        runId: string;
+        runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+        verified: boolean;
+        checkpointRevision: number;
+        billingState: string;
+        name?: string | null;
+        placeUrl?: string | null;
+        completedFields?: string[];
+        pendingFields?: string[];
+        unavailableFields?: string[];
+        reviewsCollected?: number;
+        imagesCollected?: number;
+        reviewsNextCursor?: string | null;
+        imagesNextCursor?: string | null;
+    } & {
+        [key: string]: unknown;
+    }>;
+    placeReviews(runId: string, cursor?: string, limit?: number): Promise<{
+        runId: string;
+        items: {
+            [key: string]: unknown;
+        }[];
+        nextCursor: string | null;
+    }>;
+    placeImages(runId: string, cursor?: string, limit?: number): Promise<{
+        runId: string;
+        items: {
+            [key: string]: unknown;
+        }[];
+        nextCursor: string | null;
+    }>;
+    placeResume(runId: string, resumeIdempotencyKey: string, options?: ScraperRequestOptions): Promise<{
+        runId: string;
+        runStatus: "queued" | "running" | "interrupted" | "complete" | "partial" | "failed" | "cancelled";
+        verified: boolean;
+        checkpointRevision: number;
+        billingState: string;
+        name?: string | null;
+        placeUrl?: string | null;
+        completedFields?: string[];
+        pendingFields?: string[];
+        unavailableFields?: string[];
+        reviewsCollected?: number;
+        imagesCollected?: number;
+        reviewsNextCursor?: string | null;
+        imagesNextCursor?: string | null;
+    } & {
         [key: string]: unknown;
     }>;
 }

package/dist/index.js

@@ -328,8 +328,43 @@ var MapsNamespace = class {
   search(params, options = {}) {
     return this.r.call("POST", "/maps/search", params, {}, options);
   }
-  place(params) {
-    return this.r.call("POST", "/maps/place", params);
+  place(params, options = {}) {
+    const headers = {
+      ...options.idempotencyKey ? { "Idempotency-Key": options.idempotencyKey } : {},
+      ...options.runId ? { "X-Maps-Run-Id": options.runId } : {}
+    };
+    return this.r.call("POST", "/maps/place", params, headers, options);
+  }
+  placeStatus(runId, options = {}) {
+    const query = new URLSearchParams();
+    if (options.reviewsCursor) query.set("reviewsCursor", options.reviewsCursor);
+    if (options.imagesCursor) query.set("imagesCursor", options.imagesCursor);
+    if (options.limit != null) query.set("limit", String(options.limit));
+    const suffix = query.size ? `?${query.toString()}` : "";
+    return this.r.call("GET", `/maps/place/runs/${encodeURIComponent(runId)}${suffix}`);
+  }
+  placeReviews(runId, cursor, limit) {
+    const query = new URLSearchParams();
+    if (cursor) query.set("cursor", cursor);
+    if (limit != null) query.set("limit", String(limit));
+    const suffix = query.size ? `?${query.toString()}` : "";
+    return this.r.call("GET", `/maps/place/runs/${encodeURIComponent(runId)}/reviews${suffix}`);
+  }
+  placeImages(runId, cursor, limit) {
+    const query = new URLSearchParams();
+    if (cursor) query.set("cursor", cursor);
+    if (limit != null) query.set("limit", String(limit));
+    const suffix = query.size ? `?${query.toString()}` : "";
+    return this.r.call("GET", `/maps/place/runs/${encodeURIComponent(runId)}/images${suffix}`);
+  }
+  placeResume(runId, resumeIdempotencyKey, options = {}) {
+    return this.r.call(
+      "POST",
+      `/maps/place/runs/${encodeURIComponent(runId)}/resume`,
+      void 0,
+      { "Idempotency-Key": resumeIdempotencyKey },
+      options
+    );
   }
 };
 var DirectoryNamespace = class {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.49.1",
-  "description": "Official Node.js client for all 362 mcpscraper.dev MCP tools and the REST API",
+  "version": "0.50.1",
+  "description": "Official Node.js client for all 364 mcpscraper.dev MCP tools and the REST API",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -19,6 +19,7 @@
     "README.md"
   ],
   "scripts": {
+    "generate": "openapi-typescript ../../contracts/scraper.openapi.yaml -o src/schema.ts",
     "prepack": "npm run build",
     "build": "tsup src/index.ts --format esm,cjs --dts",
     "typecheck": "tsc --noEmit",
@@ -31,7 +32,7 @@
     "seo-api"
   ],
   "dependencies": {
-    "mcpscraper-memory-sdk": "^0.49.1"
+    "mcpscraper-memory-sdk": "^0.50.1"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"