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

# serphouse

> SERP & Trends Data

**Server path:** `/serphouse` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                  | Description                     |
| ------------------------------------------------------------------------------------- | ------------------------------- |
| [`serphouse_check_serp_status`](#serphouse_check_serp_status)                         | Check SERP task status          |
| [`serphouse_check_trends_status`](#serphouse_check_trends_status)                     | Check Trends task status        |
| [`serphouse_get_account_info`](#serphouse_get_account_info)                           | Get account information         |
| [`serphouse_get_google_autocomplete`](#serphouse_get_google_autocomplete)             | Google Autocomplete suggestions |
| [`serphouse_get_serp_result`](#serphouse_get_serp_result)                             | Get scheduled SERP result       |
| [`serphouse_get_trends_result`](#serphouse_get_trends_result)                         | Get scheduled Trends result     |
| [`serphouse_google_advanced_serp`](#serphouse_google_advanced_serp)                   | Google SERP top 100 results     |
| [`serphouse_list_countries`](#serphouse_list_countries)                               | List countries and states       |
| [`serphouse_list_domains`](#serphouse_list_domains)                                   | List search engine domains      |
| [`serphouse_list_languages`](#serphouse_list_languages)                               | List languages by search engine |
| [`serphouse_list_timezones`](#serphouse_list_timezones)                               | List timezone offsets           |
| [`serphouse_list_trends_categories`](#serphouse_list_trends_categories)               | List Trends categories          |
| [`serphouse_list_trends_languages`](#serphouse_list_trends_languages)                 | List Trends languages           |
| [`serphouse_schedule_google_advanced_serp`](#serphouse_schedule_google_advanced_serp) | Schedule Google SERP top 100    |
| [`serphouse_schedule_serp_search`](#serphouse_schedule_serp_search)                   | Schedule a SERP search          |
| [`serphouse_schedule_trends_search`](#serphouse_schedule_trends_search)               | Schedule Google Trends search   |
| [`serphouse_search_google_forums`](#serphouse_search_google_forums)                   | Search Google Forums            |
| [`serphouse_search_google_jobs`](#serphouse_search_google_jobs)                       | Search Google Jobs              |
| [`serphouse_search_google_local`](#serphouse_search_google_local)                     | Search Google Local             |
| [`serphouse_search_google_short_videos`](#serphouse_search_google_short_videos)       | Search Google Short Videos      |
| [`serphouse_search_google_videos`](#serphouse_search_google_videos)                   | Search Google Videos            |
| [`serphouse_search_locations`](#serphouse_search_locations)                           | Search locations                |
| [`serphouse_search_trends`](#serphouse_search_trends)                                 | Search Google Trends            |
| [`serphouse_serp_live_get`](#serphouse_serp_live_get)                                 | Live SERP search (GET)          |
| [`serphouse_serp_live_post`](#serphouse_serp_live_post)                               | Live SERP search (POST)         |

***

## serphouse\_check\_serp\_status

Check SERP task status

**Parameters:**

| Parameter | Type   | Required | Default | Description               |
| --------- | ------ | -------- | ------- | ------------------------- |
| `id`      | string | Yes      | —       | Scheduled task identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Scheduled task identifier"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## serphouse\_check\_trends\_status

Check Trends task status

**Parameters:**

| Parameter | Type   | Required | Default | Description               |
| --------- | ------ | -------- | ------- | ------------------------- |
| `id`      | string | Yes      | —       | Scheduled task identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Scheduled task identifier"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## serphouse\_get\_account\_info

Get account information

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## serphouse\_get\_google\_autocomplete

Google Autocomplete suggestions

**Parameters:**

| Parameter | Type   | Required | Default | Description                                   |
| --------- | ------ | -------- | ------- | --------------------------------------------- |
| `client`  | string | No       | —       | Client type for suggestions (default: chrome) |
| `lang`    | string | Yes      | —       | Language code                                 |
| `loc`     | string | Yes      | —       | Location name                                 |
| `q`       | string | Yes      | —       | Search query for autocomplete                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "client": {
        "type": "string",
        "description": "Client type for suggestions (default: chrome)",
        "enum": [
          "chrome",
          "chrome-omni",
          "home_page",
          "safari",
          "firefox",
          "youtube"
        ]
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "q": {
        "type": "string",
        "description": "Search query for autocomplete"
      }
    },
    "required": [
      "PCID",
      "lang",
      "loc",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_get\_serp\_result

Get scheduled SERP result

**Parameters:**

| Parameter      | Type   | Required | Default | Description               |
| -------------- | ------ | -------- | ------- | ------------------------- |
| `id`           | string | Yes      | —       | Scheduled task identifier |
| `responseType` | string | No       | —       | Response format           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Scheduled task identifier"
      },
      "responseType": {
        "type": "string",
        "description": "Response format",
        "enum": [
          "html",
          "json"
        ]
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## serphouse\_get\_trends\_result

Get scheduled Trends result

**Parameters:**

| Parameter | Type   | Required | Default | Description               |
| --------- | ------ | -------- | ------- | ------------------------- |
| `id`      | string | Yes      | —       | Scheduled task identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Scheduled task identifier"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## serphouse\_google\_advanced\_serp

Google SERP top 100 results

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                     |
| ------------ | ------- | -------- | ------- | --------------------------------------------------------------- |
| `date_range` | string  | No       | —       | Date range filter                                               |
| `device`     | string  | Yes      | —       | Device type                                                     |
| `domain`     | string  | Yes      | —       | Google domain (e.g. google.com)                                 |
| `gfilter`    | integer | No       | —       | Google filter                                                   |
| `lang`       | string  | Yes      | —       | Language code                                                   |
| `loc`        | string  | No       | —       | Location name                                                   |
| `loc_id`     | string  | No       | —       | Location ID                                                     |
| `max_pages`  | integer | No       | —       | Max pages to retrieve (1-10), default 10. Each page = 1 credit. |
| `q`          | string  | Yes      | —       | Search query                                                    |
| `verbatim`   | integer | No       | —       | Verbatim search                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "device": {
        "type": "string",
        "description": "Device type",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "domain": {
        "type": "string",
        "description": "Google domain (e.g. google.com)"
      },
      "gfilter": {
        "type": "integer",
        "description": "Google filter",
        "enum": [
          0,
          1
        ]
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "max_pages": {
        "type": "integer",
        "description": "Max pages to retrieve (1-10), default 10. Each page = 1 credit."
      },
      "q": {
        "type": "string",
        "description": "Search query"
      },
      "verbatim": {
        "type": "integer",
        "description": "Verbatim search",
        "enum": [
          0,
          1
        ]
      }
    },
    "required": [
      "PCID",
      "device",
      "domain",
      "lang",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_list\_countries

List countries and states

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## serphouse\_list\_domains

List search engine domains

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## serphouse\_list\_languages

List languages by search engine

**Parameters:**

| Parameter | Type   | Required | Default | Description        |
| --------- | ------ | -------- | ------- | ------------------ |
| `type`    | string | Yes      | —       | Search engine type |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "type": {
        "type": "string",
        "description": "Search engine type",
        "enum": [
          "google",
          "bing",
          "yahoo"
        ]
      }
    },
    "required": [
      "PCID",
      "type"
    ]
  }
  ```
</Expandable>

***

## serphouse\_list\_timezones

List timezone offsets

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## serphouse\_list\_trends\_categories

List Trends categories

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## serphouse\_list\_trends\_languages

List Trends languages

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## serphouse\_schedule\_google\_advanced\_serp

Schedule Google SERP top 100

**Parameters:**

| Parameter      | Type    | Required | Default | Description         |
| -------------- | ------- | -------- | ------- | ------------------- |
| `date_range`   | string  | No       | —       | Date range filter   |
| `device`       | string  | Yes      | —       | Device type         |
| `domain`       | string  | Yes      | —       | Google domain       |
| `gfilter`      | integer | No       | —       | Google filter       |
| `lang`         | string  | Yes      | —       | Language code       |
| `loc`          | string  | No       | —       | Location name       |
| `loc_id`       | string  | No       | —       | Location ID         |
| `max_pages`    | integer | No       | —       | Max pages (1-10)    |
| `pingback_url` | string  | No       | —       | Notification URL    |
| `postback_url` | string  | No       | —       | Webhook for results |
| `q`            | string  | Yes      | —       | Search query        |
| `verbatim`     | integer | No       | —       | Verbatim search     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "device": {
        "type": "string",
        "description": "Device type",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "domain": {
        "type": "string",
        "description": "Google domain"
      },
      "gfilter": {
        "type": "integer",
        "description": "Google filter",
        "enum": [
          0,
          1
        ]
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "max_pages": {
        "type": "integer",
        "description": "Max pages (1-10)"
      },
      "pingback_url": {
        "type": "string",
        "description": "Notification URL"
      },
      "postback_url": {
        "type": "string",
        "description": "Webhook for results"
      },
      "q": {
        "type": "string",
        "description": "Search query"
      },
      "verbatim": {
        "type": "integer",
        "description": "Verbatim search",
        "enum": [
          0,
          1
        ]
      }
    },
    "required": [
      "PCID",
      "device",
      "domain",
      "lang",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_schedule\_serp\_search

Schedule a SERP search

**Parameters:**

| Parameter      | Type    | Required | Default | Description                             |
| -------------- | ------- | -------- | ------- | --------------------------------------- |
| `date_range`   | string  | No       | —       | Date range filter                       |
| `device`       | string  | Yes      | —       | Device type                             |
| `domain`       | string  | Yes      | —       | Search engine                           |
| `gfilter`      | integer | No       | —       | Google filter                           |
| `lang`         | string  | Yes      | —       | Language code                           |
| `loc`          | string  | No       | —       | Location name                           |
| `loc_id`       | string  | No       | —       | Location ID                             |
| `num_result`   | integer | No       | —       | Results per page                        |
| `page`         | integer | No       | —       | Page number                             |
| `pingback_url` | string  | No       | —       | URL to receive notification via GET     |
| `postback_url` | string  | No       | —       | Webhook URL to receive results via POST |
| `q`            | string  | Yes      | —       | Search query                            |
| `serp_type`    | string  | Yes      | —       | Result type                             |
| `verbatim`     | integer | No       | —       | Verbatim search                         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "device": {
        "type": "string",
        "description": "Device type",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "domain": {
        "type": "string",
        "description": "Search engine",
        "enum": [
          "google",
          "bing",
          "yahoo"
        ]
      },
      "gfilter": {
        "type": "integer",
        "description": "Google filter",
        "enum": [
          0,
          1
        ]
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "num_result": {
        "type": "integer",
        "description": "Results per page"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "pingback_url": {
        "type": "string",
        "description": "URL to receive notification via GET"
      },
      "postback_url": {
        "type": "string",
        "description": "Webhook URL to receive results via POST"
      },
      "q": {
        "type": "string",
        "description": "Search query"
      },
      "serp_type": {
        "type": "string",
        "description": "Result type",
        "enum": [
          "web",
          "news",
          "image"
        ]
      },
      "verbatim": {
        "type": "integer",
        "description": "Verbatim search",
        "enum": [
          0,
          1
        ]
      }
    },
    "required": [
      "PCID",
      "device",
      "domain",
      "lang",
      "q",
      "serp_type"
    ]
  }
  ```
</Expandable>

***

## serphouse\_schedule\_trends\_search

Schedule Google Trends search

**Parameters:**

| Parameter          | Type    | Required | Default | Description                       |
| ------------------ | ------- | -------- | ------- | --------------------------------- |
| `category`         | integer | No       | —       | Category ID                       |
| `geo`              | string  | No       | —       | Geographic filter                 |
| `keywords`         | string  | Yes      | —       | Keywords (comma-separated, max 5) |
| `language_code`    | string  | No       | —       | Language code                     |
| `pingback_url`     | string  | No       | —       | Notification URL                  |
| `postback_url`     | string  | No       | —       | Webhook for results               |
| `property`         | string  | No       | —       | Google property                   |
| `time`             | string  | Yes      | —       | Time range                        |
| `time_zone_offset` | integer | Yes      | —       | Timezone offset in minutes        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "category": {
        "type": "integer",
        "description": "Category ID"
      },
      "geo": {
        "type": "string",
        "description": "Geographic filter"
      },
      "keywords": {
        "type": "string",
        "description": "Keywords (comma-separated, max 5)"
      },
      "language_code": {
        "type": "string",
        "description": "Language code"
      },
      "pingback_url": {
        "type": "string",
        "description": "Notification URL"
      },
      "postback_url": {
        "type": "string",
        "description": "Webhook for results"
      },
      "property": {
        "type": "string",
        "description": "Google property",
        "enum": [
          "",
          "images",
          "news",
          "froogle",
          "youtube"
        ]
      },
      "time": {
        "type": "string",
        "description": "Time range"
      },
      "time_zone_offset": {
        "type": "integer",
        "description": "Timezone offset in minutes"
      }
    },
    "required": [
      "PCID",
      "keywords",
      "time",
      "time_zone_offset"
    ]
  }
  ```
</Expandable>

***

## serphouse\_search\_google\_forums

Search Google Forums

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `date_range` | string  | No       | —       | Date range filter |
| `device`     | string  | Yes      | —       | Device type       |
| `domain`     | string  | Yes      | —       | Google domain     |
| `lang`       | string  | Yes      | —       | Language code     |
| `loc`        | string  | No       | —       | Location name     |
| `loc_id`     | string  | No       | —       | Location ID       |
| `page`       | integer | No       | —       | Page number       |
| `q`          | string  | Yes      | —       | Search query      |
| `verbatim`   | integer | No       | —       | Verbatim search   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "device": {
        "type": "string",
        "description": "Device type",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "domain": {
        "type": "string",
        "description": "Google domain"
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "q": {
        "type": "string",
        "description": "Search query"
      },
      "verbatim": {
        "type": "integer",
        "description": "Verbatim search",
        "enum": [
          0,
          1
        ]
      }
    },
    "required": [
      "PCID",
      "device",
      "domain",
      "lang",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_search\_google\_jobs

Search Google Jobs

**Parameters:**

| Parameter    | Type   | Required | Default | Description                     |
| ------------ | ------ | -------- | ------- | ------------------------------- |
| `date_range` | string | No       | —       | Date range filter               |
| `domain`     | string | Yes      | —       | Google domain (e.g. google.com) |
| `lang`       | string | Yes      | —       | Language code                   |
| `loc`        | string | No       | —       | Location name                   |
| `loc_id`     | string | No       | —       | Location ID                     |
| `q`          | string | Yes      | —       | Job search query                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "domain": {
        "type": "string",
        "description": "Google domain (e.g. google.com)"
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "q": {
        "type": "string",
        "description": "Job search query"
      }
    },
    "required": [
      "PCID",
      "domain",
      "lang",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_search\_google\_local

Search Google Local

**Parameters:**

| Parameter | Type    | Required | Default | Description                             |
| --------- | ------- | -------- | ------- | --------------------------------------- |
| `domain`  | string  | Yes      | —       | Google domain                           |
| `lang`    | string  | Yes      | —       | Language code                           |
| `loc`     | string  | No       | —       | Location name                           |
| `loc_id`  | string  | No       | —       | Location ID                             |
| `page`    | integer | No       | —       | Page number (up to 20 results per page) |
| `q`       | string  | Yes      | —       | Local search query                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domain": {
        "type": "string",
        "description": "Google domain"
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "page": {
        "type": "integer",
        "description": "Page number (up to 20 results per page)"
      },
      "q": {
        "type": "string",
        "description": "Local search query"
      }
    },
    "required": [
      "PCID",
      "domain",
      "lang",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_search\_google\_short\_videos

Search Google Short Videos

**Parameters:**

| Parameter        | Type    | Required | Default | Description       |
| ---------------- | ------- | -------- | ------- | ----------------- |
| `date_range`     | string  | No       | —       | Date range filter |
| `device`         | string  | Yes      | —       | Device type       |
| `domain`         | string  | Yes      | —       | Google domain     |
| `lang`           | string  | Yes      | —       | Language code     |
| `loc`            | string  | No       | —       | Location name     |
| `loc_id`         | string  | No       | —       | Location ID       |
| `page`           | integer | No       | —       | Page number       |
| `q`              | string  | Yes      | —       | Search query      |
| `video_captions` | string  | No       | —       | Captions filter   |
| `video_quality`  | string  | No       | —       | Quality filter    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "device": {
        "type": "string",
        "description": "Device type",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "domain": {
        "type": "string",
        "description": "Google domain"
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "q": {
        "type": "string",
        "description": "Search query"
      },
      "video_captions": {
        "type": "string",
        "description": "Captions filter",
        "enum": [
          "captioned"
        ]
      },
      "video_quality": {
        "type": "string",
        "description": "Quality filter",
        "enum": [
          "high"
        ]
      }
    },
    "required": [
      "PCID",
      "device",
      "domain",
      "lang",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_search\_google\_videos

Search Google Videos

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                      |
| ---------------- | ------- | -------- | ------- | ---------------------------------------------------------------- |
| `date_range`     | string  | No       | —       | Date range filter                                                |
| `device`         | string  | Yes      | —       | Device type                                                      |
| `domain`         | string  | Yes      | —       | Google domain                                                    |
| `lang`           | string  | Yes      | —       | Language code                                                    |
| `loc`            | string  | No       | —       | Location name                                                    |
| `loc_id`         | string  | No       | —       | Location ID                                                      |
| `page`           | integer | No       | —       | Page number                                                      |
| `q`              | string  | Yes      | —       | Video search query                                               |
| `video_captions` | string  | No       | —       | Captions filter                                                  |
| `video_duration` | string  | No       | —       | Duration filter: short (0-4min), medium (4-20min), long (20+min) |
| `video_quality`  | string  | No       | —       | Quality filter                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "device": {
        "type": "string",
        "description": "Device type",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "domain": {
        "type": "string",
        "description": "Google domain"
      },
      "lang": {
        "type": "string",
        "description": "Language code"
      },
      "loc": {
        "type": "string",
        "description": "Location name"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "q": {
        "type": "string",
        "description": "Video search query"
      },
      "video_captions": {
        "type": "string",
        "description": "Captions filter",
        "enum": [
          "captioned"
        ]
      },
      "video_duration": {
        "type": "string",
        "description": "Duration filter: short (0-4min), medium (4-20min), long (20+min)",
        "enum": [
          "short",
          "medium",
          "long"
        ]
      },
      "video_quality": {
        "type": "string",
        "description": "Quality filter",
        "enum": [
          "high"
        ]
      }
    },
    "required": [
      "PCID",
      "device",
      "domain",
      "lang",
      "q"
    ]
  }
  ```
</Expandable>

***

## serphouse\_search\_locations

Search locations

**Parameters:**

| Parameter | Type   | Required | Default | Description          |
| --------- | ------ | -------- | ------- | -------------------- |
| `q`       | string | Yes      | —       | Location search term |
| `type`    | string | Yes      | —       | Search engine type   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "q": {
        "type": "string",
        "description": "Location search term"
      },
      "type": {
        "type": "string",
        "description": "Search engine type",
        "enum": [
          "google",
          "bing"
        ]
      }
    },
    "required": [
      "PCID",
      "q",
      "type"
    ]
  }
  ```
</Expandable>

***

## serphouse\_search\_trends

Search Google Trends

**Parameters:**

| Parameter          | Type    | Required | Default | Description                                                                                                                             |
| ------------------ | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `category`         | integer | No       | —       | Category ID (default: 0 for all categories)                                                                                             |
| `geo`              | string  | No       | —       | Geographic filter: empty for worldwide, or country/state code (e.g. 'US', 'US-CA')                                                      |
| `keywords`         | string  | Yes      | —       | Single keyword or comma-separated list (max 5)                                                                                          |
| `language_code`    | string  | No       | —       | Language code (default: 'en')                                                                                                           |
| `property`         | string  | No       | —       | Google property to search (default: Web Search)                                                                                         |
| `time`             | string  | Yes      | —       | Time range: 'now 1-H', 'now 4-H', 'now 1-d', 'now 7-d', 'today 1-m', 'today 3-m', 'today 12-m', 'today 5-y', or 'YYYY-MM-DD YYYY-MM-DD' |
| `time_zone_offset` | integer | Yes      | —       | Timezone offset in minutes (e.g. -300 for EST)                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "category": {
        "type": "integer",
        "description": "Category ID (default: 0 for all categories)"
      },
      "geo": {
        "type": "string",
        "description": "Geographic filter: empty for worldwide, or country/state code (e.g. 'US', 'US-CA')"
      },
      "keywords": {
        "type": "string",
        "description": "Single keyword or comma-separated list (max 5)"
      },
      "language_code": {
        "type": "string",
        "description": "Language code (default: 'en')"
      },
      "property": {
        "type": "string",
        "description": "Google property to search (default: Web Search)",
        "enum": [
          "",
          "images",
          "news",
          "froogle",
          "youtube"
        ]
      },
      "time": {
        "type": "string",
        "description": "Time range: 'now 1-H', 'now 4-H', 'now 1-d', 'now 7-d', 'today 1-m', 'today 3-m', 'today 12-m', 'today 5-y', or 'YYYY-MM-DD YYYY-MM-DD'"
      },
      "time_zone_offset": {
        "type": "integer",
        "description": "Timezone offset in minutes (e.g. -300 for EST)"
      }
    },
    "required": [
      "PCID",
      "keywords",
      "time",
      "time_zone_offset"
    ]
  }
  ```
</Expandable>

***

## serphouse\_serp\_live\_get

Live SERP search (GET)

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                                               |
| ------------ | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `q`          | string | Yes      | —       | Search query term or phrase                                                                               |
| `domain`     | string | Yes      | —       | Search engine to use                                                                                      |
| `lang`       | string | Yes      | —       | Language code (e.g. 'en', 'fr', 'de')                                                                     |
| `device`     | string | Yes      | —       | Device type for search results                                                                            |
| `serp_type`  | string | Yes      | —       | Type of search results                                                                                    |
| `loc`        | string | No       | —       | Location name (required if loc\_id not provided)                                                          |
| `loc_id`     | string | No       | —       | Location ID from the location search endpoint (required if loc not provided)                              |
| `verbatim`   | string | No       | —       | Enable verbatim search (exact match)                                                                      |
| `gfilter`    | string | No       | —       | Enable Google filter                                                                                      |
| `page`       | string | No       | —       | Page number, default 1                                                                                    |
| `num_result` | string | No       | —       | Number of results per page (1-10), default 10                                                             |
| `date_range` | string | No       | —       | Date range filter: 'h' (hour), 'd' (day), 'w' (week), 'm' (month), 'y' (year), or 'YYYY-MM-DD,YYYY-MM-DD' |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "q": {
        "type": "string",
        "description": "Search query term or phrase"
      },
      "domain": {
        "type": "string",
        "description": "Search engine to use",
        "enum": [
          "google",
          "bing",
          "yahoo"
        ]
      },
      "lang": {
        "type": "string",
        "description": "Language code (e.g. 'en', 'fr', 'de')"
      },
      "device": {
        "type": "string",
        "description": "Device type for search results",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "serp_type": {
        "type": "string",
        "description": "Type of search results",
        "enum": [
          "web",
          "news",
          "image"
        ]
      },
      "loc": {
        "type": "string",
        "description": "Location name (required if loc_id not provided)"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID from the location search endpoint (required if loc not provided)"
      },
      "verbatim": {
        "type": "string",
        "description": "Enable verbatim search (exact match)",
        "enum": [
          "0",
          "1"
        ]
      },
      "gfilter": {
        "type": "string",
        "description": "Enable Google filter",
        "enum": [
          "0",
          "1"
        ]
      },
      "page": {
        "type": "string",
        "description": "Page number, default 1"
      },
      "num_result": {
        "type": "string",
        "description": "Number of results per page (1-10), default 10"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter: 'h' (hour), 'd' (day), 'w' (week), 'm' (month), 'y' (year), or 'YYYY-MM-DD,YYYY-MM-DD'"
      }
    },
    "required": [
      "PCID",
      "q",
      "domain",
      "lang",
      "device",
      "serp_type"
    ]
  }
  ```
</Expandable>

***

## serphouse\_serp\_live\_post

Live SERP search (POST)

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                      |
| ------------ | ------- | -------- | ------- | ------------------------------------------------ |
| `date_range` | string  | No       | —       | Date range filter                                |
| `device`     | string  | Yes      | —       | Device type                                      |
| `domain`     | string  | Yes      | —       | Search engine to use                             |
| `gfilter`    | integer | No       | —       | Enable Google filter                             |
| `lang`       | string  | Yes      | —       | Language code (e.g. 'en')                        |
| `loc`        | string  | No       | —       | Location name (required if loc\_id not provided) |
| `loc_id`     | string  | No       | —       | Location ID (required if loc not provided)       |
| `num_result` | integer | No       | —       | Results per page (1-10)                          |
| `page`       | integer | No       | —       | Page number                                      |
| `q`          | string  | Yes      | —       | Search query term or phrase                      |
| `serp_type`  | string  | Yes      | —       | Type of search results                           |
| `verbatim`   | integer | No       | —       | Enable verbatim search                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date_range": {
        "type": "string",
        "description": "Date range filter"
      },
      "device": {
        "type": "string",
        "description": "Device type",
        "enum": [
          "desktop",
          "mobile"
        ]
      },
      "domain": {
        "type": "string",
        "description": "Search engine to use",
        "enum": [
          "google",
          "bing",
          "yahoo"
        ]
      },
      "gfilter": {
        "type": "integer",
        "description": "Enable Google filter",
        "enum": [
          0,
          1
        ]
      },
      "lang": {
        "type": "string",
        "description": "Language code (e.g. 'en')"
      },
      "loc": {
        "type": "string",
        "description": "Location name (required if loc_id not provided)"
      },
      "loc_id": {
        "type": "string",
        "description": "Location ID (required if loc not provided)"
      },
      "num_result": {
        "type": "integer",
        "description": "Results per page (1-10)"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "q": {
        "type": "string",
        "description": "Search query term or phrase"
      },
      "serp_type": {
        "type": "string",
        "description": "Type of search results",
        "enum": [
          "web",
          "news",
          "image",
          "shop"
        ]
      },
      "verbatim": {
        "type": "integer",
        "description": "Enable verbatim search",
        "enum": [
          0,
          1
        ]
      }
    },
    "required": [
      "PCID",
      "device",
      "domain",
      "lang",
      "q",
      "serp_type"
    ]
  }
  ```
</Expandable>