Get Google Search autocomplete suggestions
Input
query requiredThe partial or full search query to get suggestions for. Partial words work well — 'generative engine optimi' returns the completions Google would offer as you type.
Output
query requiredThe query as passed in.
source requiredWhere the suggestions were read from. search_box means the endpoint was unavailable and the on-page dropdown was used instead.
suggestions requiredThe suggestions in the order Google ranks them. Empty when Google offers none for the query.
count optionalechoedQuery optionalThe query as Google echoed it back, which can differ from what was sent.
FAQ
Search Google
Run a Google search and return one page of organic results (title, url, site, byline, meta, snippet), with Google's link wrappers resolved to the destination url. Results can be personalized to the browser's Google account and location. Narrow queries return the same results in the same order on replay; very broad ones may reorder. For more coverage, fetch several pages or split the query (different site: paths, phrases, or freshness windows), and dedupe by url. An empty list means Google found nothing; when Google shows its anti-bot check, the run fails and says so.
Search Google Maps places
Search Google Maps for places, optionally near a location, and get the list Maps shows, in its order: name, address, phone, website, main category and all categories, star rating, number of reviews, price range, coordinates and the Google place id. Use the place id with get_place for the opening hours and with get_place_reviews for the reviews. Google Maps lists at most 120 places for one search; complete is true when that list ended, false when cap stopped it first. A precise query that Maps opens as one place returns that one place. Category names follow hl, or the browser's language when hl is empty.
Search Gmail
Search the signed-in Gmail with the native query syntax (from:, to:, subject:, has:attachment, after:/before:, labels…) and return matching threads: threadId (feed it to get_thread / reply_to_email), sender, senderEmail, subject, snippet, date, unread, starred, hasAttachment. Results are threads rather than individual messages, which is Gmail's own search granularity, and only the first page of results is returned (up to 50).