Google Search (SERP)#

Search the web through AceDataCloud's Google SERP API.

First-time setup#

1. Install the official Skill with clawhub install @acedatacloud/google-search. Check that the ClawHub publisher is @acedatacloud.
2. Sign in at AceDataCloud → Applications, open General application, and check Google Search access, balance, and current pricing. Copy its API key, or select Manage Keys → Create for a separate key. Copy the key value without Bearer ; a platform-... management token is not a service API key.
3. If you enable Allowed APIs restrictions, include /serp/google. Advanced workflows below may call additional routes.
4. On the OpenClaw Gateway host, put ACEDATACLOUD_API_TOKEN=your_api_key_here in ~/.openclaw/.env, then restart the Gateway and start a new session. For a direct terminal test, run export ACEDATACLOUD_API_TOKEN="your_api_key_here" in that shell. Never put the key in a prompt or commit an .env file.
5. Run the Quick Start below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.

Illustrated key setup, first run, and troubleshooting · Token details

Quick Start#

bash

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", "type": "search"}'

Search Types#

TypeDescriptionReturnssearchWeb search (default)Organic results, knowledge graph, rich snippetsimagesImage searchImage URLs, titles, sourcesnewsNews articlesHeadlines, sources, publish datesmapsMap resultsLocations, coordinatesplacesLocal businesses/placesName, address, rating, reviewsvideosVideo resultsVideo URLs, thumbnails, duration

Parameters#

json

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

ParameterTypeDescriptionquerystringSearch query (required; must contain non-whitespace text; maximum 2048 characters)typestringOne of: search, images, news, maps, places, videoscountrystringNon-empty country code (e.g., "us", "uk", "cn", "jp"; maximum 32 characters)languagestringNon-empty language code (e.g., "en", "zh", "ja"; maximum 32 characters)rangestringTime filter (see below)numberintNumber of results per pagepageintPage number for paginationimage_sizestringImages only. Filter by size for high-res sources: large / medium / icon, or a megapixel minimum 2mp… 70mp (e.g. 4mp = larger than 4 megapixels). Use large (or a *mp value) whenever the image will be shown large / full-screen / zoomed.

Time Range Options#

ValuePeriodqdr:hPast hourqdr:dPast 24 hoursqdr:wPast weekqdr:mPast monthqdr:yPast yearhPast hourdPast 24 hourswPast weekmPast monthyPast year

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

Gotchas#

• Default search type is "search" (web). Always specify 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 ( range) only applies to web search and news, not images or places
• Image resolution (important for video / full-screen use): results include image_url (full-size), thumbnail_url, and image_width/ image_height. Pass image_size: "large" (or a megapixel minimum like "4mp") to get sharp sources, and pick the result with the largest image_width × image_height. Always download image_url — never use thumbnail_url as a final asset (it is tiny and blurry).
• Places search works best with location-specific queries (e.g., "restaurants near Times Square")

MCP: pip install mcp-serp | Hosted: https://serp.mcp.acedata.cloud/mcp | See all MCP servers