@search1api/client 0.4.0 → 0.6.0

package/README.md

@@ -69,6 +69,28 @@ A completed request costs 5 credits. Ask is not available with pay-per-request
 payments, and its default timeout is 45 seconds. Use `search` when you already
 know which engine and keywords you want.
 
+## Maps
+
+`maps` searches Google Maps and returns one page of up to 20 places. Each place
+has a name, place ID and Maps link, plus address, phone, website, rating,
+review count, coordinates and opening hours when available:
+
+```ts
+const places = await client.maps('coffee shops', {
+  location: { latitude: 40.7455, longitude: -74.0083, zoom: 15 },
+  maxResults: 10,
+});
+
+for (const place of places.results) {
+  console.log(place.name, place.rating, place.address);
+}
+```
+
+A completed page costs 3 credits, including a confirmed empty page.
+`maxResults` only trims the page and does not lower the price. Request `page`
+2-6 with the same query and `location` for more places; each page is billed
+separately. Maps is not available with pay-per-request payments.
+
 ## Deepcrawl
 
 `deepcrawl` starts a task and waits for it to finish:
@@ -78,6 +100,30 @@ const result = await client.deepcrawl('https://example.com', { type: 'all' });
 console.log(result.zipUrl);
 ```
 
+`maxPages` (1-1000, default 1000) caps the crawl after the path rules.
+`includePaths` and `excludePaths` take up to 20 rules each, matched against
+the URL path: a rule without `*` is a path prefix (`/docs` matches `/docs/api`
+but not `/docsearch`), a rule with `*` must match the whole path, and exclusion
+wins. `format: 'json'` returns the pages in the completed status response
+instead of a ZIP:
+
+```ts
+const result = await client.deepcrawl('https://hono.dev/docs/', {
+  maxPages: 20,
+  includePaths: ['/docs/'],
+  excludePaths: ['/docs/changelog'],
+  format: 'json',
+});
+
+for (const page of result.pages ?? []) {
+  console.log(page.url, page.title, page.content.length);
+}
+console.log(result.stats, result.failed);
+```
+
+`pages` is omitted when the result is larger than 5 MB; download `resultUrl`
+instead. A task costs 20 credits regardless of the page count.
+
 Use `startDeepcrawl`, `getDeepcrawlStatus`, and `waitForDeepcrawl` when the
 application needs to control task persistence or polling itself.
 

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AskResponse, BatchResponse, CrawlOptions, CrawlRequest, CrawlResponse, DeepcrawlAcceptedResponse, DeepcrawlOptions, DeepcrawlStatusResponse, ExtractOptions, ExtractResponse, FeedbackOptions, FeedbackResponse, HealthResponse, JsonValue, NewsOptions, NewsRequest, NewsResponse, RequestOptions, Search1APIOptions, SearchOptions, SearchRequest, SearchResponse, ScreenshotOptions, ScreenshotResponse, SitemapOptions, SitemapResponse, TimeRange, TrendingOptions, TrendingResponse, UsageResponse, WaitForDeepcrawlOptions } from './types.js';
+import type { AskResponse, BatchResponse, CrawlOptions, CrawlRequest, CrawlResponse, DeepcrawlAcceptedResponse, DeepcrawlOptions, DeepcrawlStatusResponse, ExtractOptions, ExtractResponse, FeedbackOptions, FeedbackResponse, HealthResponse, JsonValue, MapsOptions, MapsResponse, NewsOptions, NewsRequest, NewsResponse, RequestOptions, Search1APIOptions, SearchOptions, SearchRequest, SearchResponse, ScreenshotOptions, ScreenshotResponse, SitemapOptions, SitemapResponse, TimeRange, TrendingOptions, TrendingResponse, UsageResponse, WaitForDeepcrawlOptions } from './types.js';
 export declare class Search1API {
     readonly apiKey: string;
     readonly baseUrl: string;
@@ -18,6 +18,12 @@ export declare class Search1API {
      * completed request; requires an API key or OAuth token.
      */
     ask(query: string, requestOptions?: RequestOptions): Promise<AskResponse>;
+    /**
+     * Google Maps place search: one page of up to 20 businesses and places with
+     * addresses, ratings, coordinates and opening hours when available. 3
+     * credits per completed page; requires an API key or OAuth token.
+     */
+    maps(query: string, options?: MapsOptions, requestOptions?: RequestOptions): Promise<MapsResponse>;
     crawl(url: string, options?: CrawlOptions, requestOptions?: RequestOptions): Promise<CrawlResponse>;
     crawlBatch(requests: CrawlRequest[], requestOptions?: RequestOptions): Promise<CrawlResponse[]>;
     screenshot(url: string, options?: ScreenshotOptions, requestOptions?: RequestOptions): Promise<ScreenshotResponse>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/generated.d.ts

@@ -3,6 +3,34 @@
  * Do not make direct changes to the file.
  */
 export interface paths {
+    "/maps": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Search Google Maps for local businesses and places
+         * @description Discover businesses and places with names, place IDs and public Maps links, plus addresses, contact details, ratings, review counts, coordinates and opening hours when available. Optional result fields are omitted when unavailable. Use POST /search for webpages and POST /crawl to read a business website.
+         *
+         *     Each request fetches one Google Maps page of up to 20 places. page is 1-based (1–6); page > 1 requires location coordinates. max_results only truncates that page and does not change the price or carry unused places into the next page. Send the same query, country, language and location with the next page number for another separately billed request. There is no automatic pagination, retry or filling from another engine. Results can change between requests; an empty or short page does not guarantee that no later results exist.
+         *
+         *     The response contains searchParameters and results, following the single-request format of POST /search and POST /news. searchParameters includes the requested page and normalized defaults. Result positions preserve native page order with possible gaps, not a stable SEO rank. A short or empty results array does not assert a total count or a next page.
+         *
+         *     A confirmed empty page is completed and charged. Technical failures return an error and release the credit reservation. GET /usage separately returns the remaining account balance.
+         *
+         *     Account credits only; no batch requests or payment protocols. Unknown fields are rejected; validation failures return 422 with errors entries containing field, message and code. Normal account limits apply (200 requests per minute). Set your client timeout above 20 seconds. SDK and MCP methods are not included in this release. Costs 3 credits per request.
+         */
+        post: operations["maps"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/feedback": {
         parameters: {
             query?: never;
@@ -194,7 +222,7 @@ export interface paths {
         put?: never;
         /**
          * Deep crawl a website across multiple pages
-         * @description Start an asynchronous crawl of an entire site and package the pages as documents. Use it for whole-site ingestion; a single page is POST /crawl. The call returns a task id immediately rather than the result — poll GET /deepcrawl/status/{taskId} until the task reports completion. Costs 20 credits per request.
+         * @description Start an asynchronous crawl of an entire site and package the pages as documents. Use it for whole-site ingestion; a single page is POST /crawl. Narrow the crawl with include_paths/exclude_paths and cap it with max_pages; a task costs the same regardless of page count. Set format to "json" to get the pages inline in the status response instead of a ZIP. The call returns a task id immediately rather than the result — poll GET /deepcrawl/status/{taskId} until the task reports completion. Costs 20 credits per request.
          */
         post: operations["deepcrawl"];
         delete?: never;
@@ -212,7 +240,7 @@ export interface paths {
         };
         /**
          * Check deepcrawl task status
-         * @description Poll a deepcrawl task started by POST /deepcrawl. Returns the task's current state and, once it finishes, where to retrieve the packaged result. Safe to call repeatedly. Free to call.
+         * @description Poll a deepcrawl task started by POST /deepcrawl. Returns the task's current state and, once it finishes, page counts (stats), failed URLs, and the result: zipUrl for format=zip, or the pages inline plus resultUrl for format=json. Safe to call repeatedly. Free to call.
          */
         get: operations["deepcrawlStatus"];
         put?: never;
@@ -283,6 +311,10 @@ export interface components {
             title?: string;
             status?: number;
             detail?: string;
+            /** @description `/crawl` and `/extract`: why the page could not be read, e.g. `NOT_FOUND`, `GONE`, `FORBIDDEN`, `AUTH_REQUIRED`, `BLOCKED`, `RATE_LIMITED`, `DNS_NOT_FOUND`, `TARGET_UNREACHABLE`, `TIMEOUT`, `QUALITY_CHECK`. */
+            failureCategory?: string;
+            /** @description `/crawl` and `/extract`: the HTTP status the target site itself returned, when it answered. */
+            upstreamStatus?: number;
         } & {
             [key: string]: unknown;
         };
@@ -306,6 +338,81 @@ export interface components {
             /** @enum {string} */
             time_range?: "day" | "week" | "month" | "year" | "";
         };
+        MapsResponse: {
+            searchParameters: {
+                /** @description Google Maps search phrase; leading and trailing whitespace is removed. */
+                query: string;
+                /**
+                 * @description Two-letter country code, normalized to lowercase. Defaults to us.
+                 * @default us
+                 */
+                country: string;
+                /**
+                 * @description Result language, for example en, de or zh-CN. Defaults to en.
+                 * @default en
+                 */
+                language: string;
+                /** @description Search origin coordinates and map zoom (default 14). Required for page > 1. Latitude must be -90 to 90, longitude -180 to 180, and zoom 3 to 30. Example: {"latitude":40.7455,"longitude":-74.0083,"zoom":15}. */
+                location?: {
+                    latitude: number;
+                    longitude: number;
+                    /** @default 14 */
+                    zoom: number;
+                };
+                /**
+                 * @description Page number, 1–6; default 1. Accepts an integer or canonical integer string such as "2". Empty strings use the default. Pages after the first require location.
+                 * @default 1
+                 */
+                page: number;
+                /**
+                 * @description Maximum places to return from this page, 1–20; default 20. Accepts an integer or canonical integer string such as "10". Empty strings use the default. Truncation does not reduce the page charge or carry places to the next page.
+                 * @default 20
+                 */
+                max_results: number;
+            };
+            results: {
+                /** @description Position in the requested native page, offset by earlier page capacities. Gaps can remain after filtering or deduplication; this is not a stable SEO rank. */
+                position: number;
+                /** @description Business or place name. */
+                name: string;
+                /** @description Google Maps place identifier, also used to deduplicate this page. */
+                place_id: string;
+                /**
+                 * Format: uri
+                 * @description Public Google Maps link for this place.
+                 */
+                maps_url: string;
+                address?: string;
+                phone?: string;
+                /** Format: uri */
+                website?: string;
+                /** Format: uri */
+                thumbnail?: string;
+                category?: string;
+                categories?: string[];
+                rating?: number;
+                review_count?: number;
+                coordinates?: {
+                    latitude: number;
+                    longitude: number;
+                };
+                /** @description Opening hours by weekday, as displayed by the source; omitted when unavailable. */
+                opening_hours?: {
+                    monday?: string;
+                    tuesday?: string;
+                    wednesday?: string;
+                    thursday?: string;
+                    friday?: string;
+                    saturday?: string;
+                    sunday?: string;
+                };
+                /** @description Source display text for the current opening state, not a normalized boolean. */
+                open_state?: string;
+                /** @description Source display text for the business price range, not a numeric amount or normalized currency. */
+                price?: string;
+                description?: string;
+            }[];
+        };
         NewsParameters: {
             query: string;
             /** @enum {string} */
@@ -353,6 +460,17 @@ export interface components {
             url: string;
             /** @enum {string} */
             type?: "sitemap" | "all";
+            /** @description Maximum number of pages to crawl, 1–1000; default 1000. Applied after include_paths/exclude_paths, in discovery order. */
+            max_pages?: number;
+            /** @description Only crawl URLs whose path matches one of these rules (up to 20). A rule without * is a path prefix on segment boundaries: "/docs" matches /docs and /docs/api but not /docsearch. A rule with * must match the whole path, and * matches any characters including /, e.g. "/blog/*". Empty or omitted means every discovered URL. */
+            include_paths?: string[];
+            /** @description Skip URLs whose path matches one of these rules (up to 20), using the same syntax as include_paths. Exclusion wins over inclusion. */
+            exclude_paths?: string[];
+            /**
+             * @description Result format; default "zip". "zip" packages the pages as Markdown files behind zipUrl. "json" returns pages: [{url, title, content}] in the completed status response, plus resultUrl for the same JSON file.
+             * @enum {string}
+             */
+            format?: "zip" | "json";
         };
         SearchResult: {
             title: string;
@@ -369,7 +487,7 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
-        /** @description Optional engine-specific fields. Omitted when none apply. GitHub fields appear on POST /search; Hacker News fields appear on POST /news. */
+        /** @description Optional engine-specific fields. Omitted when none apply. GitHub, Reddit and X fields appear on POST /search; Hacker News fields appear on POST /news. */
         SearchResultMetadata: {
             /**
              * @description What a `github` result is: a repository, an issue, a pull request, or a discussion. Only present for `search_service: "github"`.
@@ -378,9 +496,9 @@ export interface components {
             kind?: "repo" | "issue" | "pr" | "discussion";
             /** @description Stargazer count of a `github` repository result (`metadata.kind: "repo"`). */
             stars?: number;
-            /** @description Primary language of a `github` repository result (`metadata.kind: "repo"`). Omitted when GitHub reports none. */
+            /** @description Primary language of a `github` repository result (`metadata.kind: "repo"`), or the language code X detected for an `x` post. Omitted when none is reported. */
             language?: string;
-            /** @description Comment count on a `github` issue, pull request or discussion, or on a `hackernews` thread (POST /news). */
+            /** @description Comment count on a `github` issue, pull request or discussion, on a `reddit` post, on an `x` post (replies), or on a `hackernews` thread (POST /news). */
             num_comments?: number;
             /**
              * Format: uri
@@ -389,6 +507,56 @@ export interface components {
             story_url?: string;
             /** @description POST /news with `search_service: "hackernews"` only: upvotes on the thread. */
             points?: number;
+            /** @description `search_service: "x"` only: the post id. */
+            post_id?: string;
+            /** @description `x` only: handle of the account that posted, without the @. */
+            author_username?: string;
+            /** @description `x` only: display name of the account that posted. */
+            author_name?: string;
+            /** @description `x` only: numeric user id of the account that posted. */
+            author_id?: string;
+            /**
+             * Format: uri
+             * @description `x` only: avatar URL of the account that posted.
+             */
+            author_image?: string;
+            /** @description `x` only: whether the account shows a verified checkmark. */
+            author_verified?: boolean;
+            /** @description `x` only: follower count of the account that posted. */
+            author_followers?: number;
+            /** @description `x` only: likes on the post. */
+            like_count?: number;
+            /** @description `x` only: reposts of the post. */
+            repost_count?: number;
+            /** @description `x` only: quotes of the post. */
+            quote_count?: number;
+            /** @description `x` only: bookmarks of the post. */
+            bookmark_count?: number;
+            /** @description `x` only: views of the post. Omitted when X reports none, as for older posts. */
+            view_count?: number;
+            /** @description `x` only: whether the post replies to another post. */
+            is_reply?: boolean;
+            /** @description `x` only: id of the first post in the thread. */
+            conversation_id?: string;
+            /** @description `x` only: id of the post this one replies to. Omitted when it is not a reply. */
+            in_reply_to_id?: string;
+            /** @description `x` only: photos, videos and GIFs attached to the post. Empty when there are none. */
+            media?: {
+                /** @enum {string} */
+                type: "photo" | "video" | "gif";
+                /**
+                 * Format: uri
+                 * @description Image URL; for a video or GIF, its poster frame.
+                 */
+                url: string;
+                width?: number;
+                height?: number;
+                /**
+                 * Format: uri
+                 * @description Playable MP4 (highest bitrate) for a video or GIF.
+                 */
+                video_url?: string;
+            }[];
         } & {
             [key: string]: unknown;
         };
@@ -529,6 +697,35 @@ export interface components {
             r2Key?: string;
             /** Format: uri */
             zipUrl?: string | null;
+            /** @description Page counts for a finished task: discovered links, how many matched the path rules, how many max_pages left out, and how many pages were crawled or failed. */
+            stats?: {
+                discovered: number;
+                matched: number;
+                skipped: number;
+                crawled: number;
+                failed: number;
+            };
+            /** @enum {string} */
+            format?: "zip" | "json";
+            /** @description Pages that could not be crawled, with the reason. */
+            failed?: {
+                /** Format: uri */
+                url: string;
+                error: string;
+            }[];
+            /**
+             * Format: uri
+             * @description format=json only: the JSON result file, {"pages": [...], "failed": [...]}.
+             */
+            resultUrl?: string | null;
+            /** @description format=json only: the crawled pages in discovery order. Omitted when the result is larger than 5 MB; download resultUrl instead. */
+            pages?: {
+                /** Format: uri */
+                url: string;
+                title: string | null;
+                /** @description Page body as Markdown. */
+                content: string;
+            }[];
         } & {
             [key: string]: unknown;
         };
@@ -559,6 +756,135 @@ export interface components {
 }
 export type $defs = Record<string, never>;
 export interface operations {
+    maps: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Google Maps search phrase; leading and trailing whitespace is removed.
+                     * @example coffee in Manhattan
+                     */
+                    query: string;
+                    /**
+                     * @description Two-letter country code, normalized to lowercase. Defaults to us.
+                     * @default us
+                     */
+                    country?: string;
+                    /**
+                     * @description Result language, for example en, de or zh-CN. Defaults to en.
+                     * @default en
+                     */
+                    language?: string;
+                    /** @description Search origin coordinates and map zoom (default 14). Required for page > 1. Latitude must be -90 to 90, longitude -180 to 180, and zoom 3 to 30. Example: {"latitude":40.7455,"longitude":-74.0083,"zoom":15}. */
+                    location?: {
+                        latitude: number;
+                        longitude: number;
+                        /** @default 14 */
+                        zoom?: number;
+                    };
+                    /**
+                     * @description Page number, 1–6; default 1. Accepts an integer or canonical integer string such as "2". Empty strings use the default. Pages after the first require location.
+                     * @default 1
+                     */
+                    page?: number;
+                    /**
+                     * @description Maximum places to return from this page, 1–20; default 20. Accepts an integer or canonical integer string such as "10". Empty strings use the default. Truncation does not reduce the page charge or carry places to the next page.
+                     * @default 20
+                     */
+                    max_results?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Successful response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MapsResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Payment Required */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Bad Gateway */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Service Unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
     feedback: {
         parameters: {
             query?: never;
@@ -1513,6 +1839,24 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ApiError"];
                 };
             };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Gone */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
             /** @description Validation Error */
             422: {
                 headers: {
@@ -1565,6 +1909,17 @@ export interface operations {
                     url: string;
                     /** @enum {string} */
                     type?: "sitemap" | "all";
+                    /** @description Maximum number of pages to crawl, 1–1000; default 1000. Applied after include_paths/exclude_paths, in discovery order. */
+                    max_pages?: number;
+                    /** @description Only crawl URLs whose path matches one of these rules (up to 20). A rule without * is a path prefix on segment boundaries: "/docs" matches /docs and /docs/api but not /docsearch. A rule with * must match the whole path, and * matches any characters including /, e.g. "/blog/*". Empty or omitted means every discovered URL. */
+                    include_paths?: string[];
+                    /** @description Skip URLs whose path matches one of these rules (up to 20), using the same syntax as include_paths. Exclusion wins over inclusion. */
+                    exclude_paths?: string[];
+                    /**
+                     * @description Result format; default "zip". "zip" packages the pages as Markdown files behind zipUrl. "json" returns pages: [{url, title, content}] in the completed status response, plus resultUrl for the same JSON file.
+                     * @enum {string}
+                     */
+                    format?: "zip" | "json";
                 };
             };
         };