> ## 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**  | 5                    |
| **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)