---
name: google-search
description: Perform Google web searches with advanced operators, get autocomplete suggestions, and discover related queries. Use when users need to search the web, research topics, find websites, get search suggestions, analyze SEO keywords, or discover trending related searches.
metadata:
author: MCP360
version: "1.0.0"
tags:
- Search Engine
- Web Search
- Research
- SEO
- SERP Analysis
- Autocomplete
- Google
- Information Retrieval
keywords:
- google
- search
- web
- query
- serp
- seo
- research
- autocomplete
- suggestions
- related
- organic
- results
- knowledge graph
- answer box
- web search
creditsPerUse: 1
isPremium: false
---
# Google Search Tools
Professional Google search API for web research, SEO analysis, and content discovery. Access Google's search results programmatically with advanced filtering, autocomplete suggestions, and related queries for comprehensive search intelligence.
## Core Capabilities
- **Web Search**: Execute Google searches with location, language, and time filters, and returns organic results with titles, snippets, URLs, rankings, and rich results like knowledge graphs and answer boxes
- **Autocomplete Suggestions**: Get real-time search suggestions as users type queries, and returns ranked keyword suggestions based on search popularity and trends for SEO keyword research
- **Related Searches**: Discover semantically related search queries for topic expansion, and returns Google's "People also search for" suggestions to uncover content opportunities and user intent
- **Advanced Search**: Use Google search operators for precise filtering (site:, intitle:, filetype:, inurl:), and returns targeted results for technical SEO audits, competitor research, and content gap analysis
## API Access
### MCP360 Connect Endpoints
- **Base URL**: `https://connect.mcp360.ai/api/v1`
- **Service Path**: `google-search`
- **Authentication**: Bearer token (API key required)
### Service Metadata Endpoint
Retrieve service information and available tools:
```bash
curl "https://connect.mcp360.ai/api/v1/google-search" \
-H "Authorization: Bearer YOUR_API_KEY"
```
### Tool Execution Endpoint
Execute specific tools by making POST requests:
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/google-search/{tool_name}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{...parameters...}'
```
## Available Tools
### Search Web
Perform comprehensive Google web searches with location-based results, language preferences, and time filtering.
**Tool Name:** `search_web`
**Credits Required:** 1
**Parameters:**
- `query` (string, required): Search terms like "artificial intelligence applications" or "best coffee shops"
- `location` (string, optional): Geographic location for localized results like "New York, USA" or "London, UK"
- `country` (string, optional): Country code for regional results like "us", "uk", "ca", "au"
- `language` (string, optional): Language code for interface and results like "en", "es", "fr", "de"
- `num_results` (number, optional): Number of search results to return from 1 to 100 (Default: 10)
- `safe_search` (boolean, optional): Enable family-friendly content filtering (Default: false)
- `time_period` (string, optional): Filter by recency - "d" (past day), "w" (past week), "m" (past month), "y" (past year)
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/google-search/search_web" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "machine learning tutorials",
"location": "San Francisco, USA",
"country": "us",
"language": "en",
"num_results": 20,
"safe_search": false,
"time_period": "m"
}'
```
### Get Autocomplete
Retrieve Google's real-time autocomplete suggestions for keyword research and understanding search behavior.
**Tool Name:** `get_autocomplete`
**Credits Required:** 1
**Parameters:**
- `query` (string, required): Partial search phrase like "how to learn" or "best restaurants in"
- `country` (string, optional): Country code for region-specific suggestions like "us", "uk", "jp"
- `language` (string, optional): Language code for localized suggestions like "en", "es", "zh"
- `client` (string, optional): Browser client type - "chrome", "safari", "firefox" (Default: "chrome")
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/google-search/get_autocomplete" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "how to build",
"country": "us",
"language": "en",
"client": "chrome"
}'
```
### Get Related Searches
Discover Google's "People also search for" and related queries to expand topic coverage and find content opportunities.
**Tool Name:** `get_related_searches`
**Credits Required:** 1
**Parameters:**
- `query` (string, required): Main search query like "content marketing" or "healthy recipes"
- `country` (string, optional): Country code for regional variations like "us", "uk", "ca"
- `language` (string, optional): Language code for localized related searches like "en", "es", "fr"
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/google-search/get_related_searches" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "digital marketing strategies",
"country": "us",
"language": "en"
}'
```
### Search Advanced
Execute advanced Google searches using search operators for precise technical SEO and competitive research.
**Tool Name:** `search_advanced`
**Credits Required:** 1
**Parameters:**
- `query` (string, required): Advanced search query with operators like "site:example.com SEO", "intitle:guide filetype:pdf", "inurl:blog -www"
- `country` (string, optional): Country code for regional SERP results like "us", "uk", "de"
- `language` (string, optional): Language code for result filtering like "en", "es", "pt"
- `num_results` (number, optional): Number of results to return from 1 to 100 (Default: 10)
**Supported Operators:**
- `site:` - Search within specific domain (e.g., "site:reddit.com productivity tips")
- `intitle:` - Find pages with terms in title (e.g., "intitle:beginner guide python")
- `inurl:` - Search for terms in URL (e.g., "inurl:blog marketing")
- `filetype:` - Filter by file type (e.g., "SEO guide filetype:pdf")
- `related:` - Find similar websites (e.g., "related:nytimes.com")
- `-` - Exclude terms (e.g., "python tutorial -video")
- `OR` - Match either term (e.g., "javascript OR typescript")
- `" "` - Exact phrase match (e.g., "\"content is king\"")
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/google-search/search_advanced" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "site:github.com machine learning intitle:awesome",
"country": "us",
"language": "en",
"num_results": 15
}'
```
## Authentication
All API requests require a Bearer token for authentication:
```bash
-H "Authorization: Bearer YOUR_API_KEY"
```
## Rate Limiting
- All tools (search_web, get_autocomplete, get_related_searches, search_advanced): 1 credit per request
- Rate limit: 1000 requests per hour
- Concurrent requests: Up to 10 parallel calls
- Burst limit: 50 requests per minute
## Support
- **Blog & Tutorials**: https://mcp360.ai/blog
- **Contact**: https://mcp360.ai/contact