> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Serp

> Retrieve Google Search results including organic rankings, positions, snippets, and sitelinks

Retrieve Google Search results including organic rankings, positions, snippets, and sitelinks

| | |
| - | - |
| **App** | Google Search |
| **Operation ID** | `google_search_serp` |
| **Type** | Action |
| **Connection** | None |
| **Credits per run** | 2 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `q` | string | Yes | - | The search query to track rankings for |
| `device` | string or SelectableOption | No | - | Device type for the search (desktop, mobile, tablet) |
| `google_domain` | string | No | `google.com` | Google domain to use for the search (e.g., google.com, google.co.uk, google.de) |
| `gl` | string | No | `us` | Country code for the search (e.g., 'us', 'uk', 'de') |
| `hl` | string | No | `en` | Interface language for the search (e.g., 'en', 'es', 'fr') |
| `safe` | string or SelectableOption | No | - | SafeSearch setting. Set to 'active' to enable or 'off' to disable |
| `limit` | integer | No | `100` | Number of results to return (10-100) |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `List[Dict]`

Returns list of organic search results with position, title, link, snippet, and sitelinks.

**Fields**: dynamic (depend on the inputs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.