# Search on Google — SerpBase

Botize method — `serpbase.search` (action).

Runs a Google search and returns the organic results as data: position, title, link, domain and snippet for each one, plus the related searches. Costs 1 SerpBase credit per execution. When the search returns nothing, the step still answers with 'Results found' set to no, so the task can carry on and decide what to do.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `q` *(string)* — Search query
- `gl` *(string, one of: ""; "es"; "mx"; "ar"; "co"; "cl"; "pe"; "ve"; "ec"; "uy"; "us"; "ca"; "gb"; "ie"; "fr"; "de"; "it"; "pt"; "br"; "nl"; "be"; "ch"; "at"; "se"; "no"; "dk"; "fi"; "pl"; "gr"; "ro"; "tr"; "ru"; "ma"; "za"; "au"; "jp"; "in"; "cn")* — Country of the search (ISO code). Empty means United States
- `hl` *(string, one of: ""; "es"; "en"; "pt"; "ca"; "gl"; "eu"; "fr"; "de"; "it"; "nl"; "sv"; "no"; "da"; "fi"; "pl"; "cs"; "hu"; "ro"; "el"; "tr"; "ru"; "uk"; "ar"; "he"; "hi"; "id"; "ja"; "ko"; "zh-CN"; "th"; "vi")* — Language of the results (ISO code). Empty means English
- `device` *(string, one of: ""; "pc"; "mobile")* — Device: empty for automatic, pc for desktop, mobile for phone
- `page` *(string)* — Results page, 1-based. Empty means the first page

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{found}}` *(boolean)* — Results found. No when Google returned zero results. The step does not stop the task on its own: add a rule on this value if you want it to stop.
- `{{query}}` *(text)* — Search query
- `{{page}}` *(int)* — Page
- `{{results_count}}` *(int)* — Number of results
- `{{results}}` *(array)* — Results. List of organic results. Each item has position, title, link, domain, snippet and date. Use the Iterator app to run the following steps once per result.
- `{{first_title}}` *(text)* — First result title
- `{{first_link}}` *(url)* — First result link. Link of the top organic result, ready to use without iterating.
- `{{first_snippet}}` *(text)* — First result snippet
- `{{related_searches}}` *(array)* — Related searches. Other queries Google suggests for this search. Not every country returns them.
- `{{credits_used}}` *(int)* — Credits used

## Account

Needs a connected SerpBase account in Botize: https://botize.com/en/app/serpbase/authenticate

## This app

Every trigger and action for SerpBase: https://botize.com/en/app/serpbase.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/serpbase/search