Google Search (SERP)

Search the web through AceDataCloud's Google SERP API.

Authentication

export ACEDATACLOUD_API_TOKEN="your-token-here"

Quick Start

curl -X POST https://api.acedata.cloud/serp/google \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news", "search_type": "search"}'

Search Types

Parameters

POST /serp/google
{
  "query": "your search query",
  "search_type": "search",
  "country": "us",
  "language": "en",
  "time_range": "qdr:w",
  "number": 10,
  "page": 1
}

Time Range Options

Response Structure

Web search returns structured data including:

• organic_results: Main search results with title, link, snippet
• knowledge_graph: Entity information panel (when available)
• related_searches: Related query suggestions

MCP Server

pip install mcp-serp

Or hosted: https://serp.mcp.acedata.cloud/mcp

Key tool: serp_google_search

Gotchas

• Default search type is "search" (web). Always specify search_type for non-web searches
• Country and language codes affect result localization significantly
• number controls results per page, not total results — use page for pagination
• Time range only applies to web search and news, not images or places
• Image search returns thumbnail and full-size URLs — use full-size for downloads
• Places search works best with location-specific queries (e.g., "restaurants near Times Square")