# ScrapeMole Search Autocomplete

> ScrapeMole Search Autocomplete is a paid API for AI agents from search.scrapemole.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-22).

Returns search autocomplete suggestions for a partial query, sourced from public search engines with automatic fallbacks

## Facts

- Endpoint: GET https://search.scrapemole.workers.dev/v1/suggest?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-search-autocomplete-00d621c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HGfXahFDPa8j2m14p9sOE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scrapemole-search-autocomplete-00d621c1
```

Example prompt: Can you give me autocomplete suggestions for the partial query 'how to learn' in English — I want to see what people typically search for when they start typing that phrase?

## When to prefer this

Use this endpoint when you need lightweight, real-time search autocomplete suggestions without managing API keys or accounts. Ideal for populating search boxes, performing keyword research, or understanding popular query patterns. Prefer this over full web search endpoints when you only need query completions, not full search results with URLs and snippets. The pay-per-call USDC model (no subscription) and automatic fallback chain make it suitable for sporadic or bursty agent workloads.

## Known failure modes

- Empty suggestions list if the query is too obscure or short — call is not charged
- All fallback sources unavailable — may return error or empty result
- Invalid language code may fall back to default 'en'
- Query exceeding 200 characters will be rejected
- Network timeout from upstream search engines causing delayed or failed response

## How this service works

Pay-per-call search for agents: web search results (title, URL, snippet, domain, position; up to 20 per call, markets, safe search, paging), news search (headline, direct URL, publisher, published time, image; sort by date, freshness hour/day/week/month) and search autocomplete suggestions. Live from public search pages and feeds with automatic fallbacks (Bing RSS, Brave Search, Mwmbl, Google suggest, DuckDuckGo); every response names the source used. No keys, no accounts. USDC via x402; failed and empty calls are never charged.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://search.scrapemole.workers.dev/terms

## Output

A JSON object containing the partial query echoed back, the number of suggestions returned, a list of suggested full query strings, the name of the search engine source used (e.g. 'Google (public suggest endpoint)'), and the source URL. Suggestions reflect real-time public search engine autocomplete data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "examples": [
        "how to learn"
       ],
       "description": "Partial query (max 200 chars)."
      },
      "lang": {
       "type": "string",
       "default": "en",
       "description": "Two-letter language code."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 3,
  "query": "how to learn",
  "source": "Google (public suggest endpoint)",
  "sourceUrl": "https://www.google.com/search?q=how%20to%20learn",
  "suggestions": [
   "how to learn python",
   "how to learn spanish",
   "how to learn coding"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-search-autocomplete-00d621c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from search.scrapemole.workers.dev](https://www.zero.xyz/host/search.scrapemole.workers.dev/llms.txt)