# Check a domain position on Google — SerpBase

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

Searches a keyword on Google and tells you at which position a domain ranks, along with the exact URL that ranks. Subdomains count as part of the domain. It stops as soon as it finds it, and each results page it has to read costs 1 SerpBase credit. When the domain does not rank, the step still answers, with 'Appears in the results' set to no and position 0, so you can add a rule and get an alert.

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)* — Keyword to search for
- `site` *(string)* — Domain to look for, like example.com. Subdomains count as the same domain
- `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
- `max_pages` *(string, one of: "1"; "2"; "3")* — How many results pages to read at most: 1 (top 10), 2 (top 20) or 3 (top 30). Each page costs 1 credit

## Output variables

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

- `{{found}}` *(boolean)* — Appears in the results. No when the domain does not appear in the results that were read. The step does not stop the task on its own: add a rule on this value to decide what happens.
- `{{position}}` *(int)* — Position. Overall position counting across pages, so result 3 of page 2 is position 13. It is 0 when the domain does not appear.
- `{{page}}` *(int)* — Page
- `{{url}}` *(url)* — Ranking URL. The exact page of the domain that ranks, which is not always the one you expect.
- `{{title}}` *(text)* — Title in Google
- `{{snippet}}` *(text)* — Snippet in Google
- `{{query}}` *(text)* — Keyword
- `{{site}}` *(text)* — Domain
- `{{results_scanned}}` *(int)* — Results scanned
- `{{pages_scanned}}` *(int)* — Pages read
- `{{credits_used}}` *(int)* — Credits used. Credits this execution actually spent. It is 1 when the domain was found on the first page.

## 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/check_position