Google Trends API

Parameters

GET https://scrapemole-api-mainnet.scrapemole.workers.dev/v1/google-trends

Call it

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPaymentFromConfig, decodePaymentResponseHeader } from '@x402/fetch';
import { ExactEvmScheme } from '@x402/evm';
import { privateKeyToAccount } from 'viem/accounts';

// Your agent's own wallet, holding a little USDC on Base. No ScrapeMole account or API key.
const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: 'eip155:8453', client: new ExactEvmScheme(account) }],
});

// On 402 the wrapper signs the USDC authorization and retries once.
const res = await pay('https://scrapemole-api-mainnet.scrapemole.workers.dev/v1/google-trends?q=espresso%20machine&geo=US');
console.log(res.status, await res.json());
// Settled only on 200; the receipt (tx hash) is in the PAYMENT-RESPONSE header.
if (res.ok) console.log(decodePaymentResponseHeader(res.headers.get('payment-response')));

# 1. Unpaid: returns 402 with price $0.01 and the payTo address
curl -i "https://scrapemole-api-mainnet.scrapemole.workers.dev/v1/google-trends?q=espresso%20machine&geo=US"

# 2. Paid: repeat the request with a PAYMENT-SIGNATURE header (a signed USDC
#    authorization for the quoted amount). An x402 client does this for you:
#    see the JavaScript tab.

Also available as the MCP tool google_trends on https://scrapemole-api-mainnet.scrapemole.workers.dev/mcp (x402 MCP transport, same price).

Example response

A real response from this endpoint (arrays and long strings trimmed here).

{
  "type": "comparison",
  "searchTerm": null,
  "searchTerms": [
    "espresso machine",
    "french press"
  ],
  "geo": "US",
  "timeRange": "today 12-m",
  "category": 0,
  "searchType": "web",
  "trendsUrl": "https://trends.google.com/trends/explore?q=espresso+machine%2Cfrench+press&hl=en-US&geo=US&date=today+12-m",
  "interestOverTime": [
    {
      "date": "2025-10-05T00:00:00.000Z",
      "timestamp": 1759622400,
      "formattedTime": "Oct 5 – 11, 2025",
      "values": {
        "espresso machine": 34,
        "french press": 12
      },
      "hasData": true,
      "isPartial": false
    },
    {
      "date": "2025-10-12T00:00:00.000Z",
      "timestamp": 1760227200,
      "formattedTime": "Oct 12 – 18, 2025",
      "values": {
        "espresso machine": 29,
        "french press": 12
      },
      "hasData": true,
      "isPartial": false
    },
    "… 1 more"
  ],
  "averages": {
    "espresso machine": 51,
    "french press": 19
  },
  "interestByRegion": [
    {
      "geoCode": "US-WY",
      "geoName": "Wyoming",
      "values": {
        "espresso machine": 73,
        "french press": 27
      },
      "hasData": true
    },
    {
      "geoCode": "US-WA",
      "geoName": "Washington",
      "values": {
        "espresso machine": 76,
        "french press": 24
      },
      "hasData": true
    },
    "… 1 more"
  ],
  "relatedQueries": {
    "espresso machine": {
      "top": [
        {
          "query": "espresso machine breville",
          "value": 100,
          "formattedValue": "100",
          "isBreakout": false,
          "link": "https://trends.google.com/trends/explore?q=espresso+machine+breville&date=today+12-m&geo=US"
        },
        {
          "query": "breville",
          "value": 98,
          "formattedValue": "98",
          "isBreakout": false,
          "link": "https://trends.google.com/trends/explore?q=breville&date=today+12-m&geo=US"
        },
        "… 1 more"
      ],
      "rising": [
        {
          "query": "espresso machine arc raiders",
          "value": 18250,
          "formattedValue": "Breakout",
          "isBreakout": true,
          "link": "https://trends.google.com/trends/explore?q=espresso+machine+arc+raiders&date=today+12-m&geo=US"
        },
        {
          "query": "ninja luxe café premier series 3-in-1 espresso coffee & cold brew machine",
          "value": 15450,
          "formattedValue": "Breakout",
          "isBreakout": true,
          "link": "https://trends.google.com/trends/explore?q=ninja+luxe+caf%C3%A9+premier+series+3-in-1+espresso+coffee+%26+cold+brew+machine&date=today+12…"
        },
        "… 1 more"
      ]
    },
    "french press": {
      "top": [
        {
          "query": "french press how to",
          "value": 100,
          "formattedValue": "100",
          "isBreakout": false,
          "link": "https://trends.google.com/trends/explore?q=french+press+how+to&date=today+12-m&geo=US"
        },
        {
          "query": "french coffee press",
          "value": 90,
          "formattedValue": "90",
          "isBreakout": false,
          "link": "https://trends.google.com/trends/explore?q=french+coffee+press&date=today+12-m&geo=US"
        },
        "… 1 more"
      ],
      "rising": [
        {
          "query": "lidl near me",
          "value": 1200,
          "formattedValue": "+1,200%",
          "isBreakout": false,
          "link": "https://trends.google.com/trends/explore?q=lidl+near+me&date=today+12-m&geo=US"
        },
        {
          "query": "french toast near me",
          "value": 850,
          "formattedValue": "+850%",
          "isBreakout": false,
          "link": "https://trends.google.com/trends/explore?q=french+toast+near+me&date=today+12-m&geo=US"
        },
        "… 1 more"
      ]
    }
  },
  "relatedTopics": {},
  "errors": []
}

Live test results

Paid end-to-end checks (Base Sepolia testnet, 11 Oct 2026 18:36 UTC)

Errors

Failures return JSON like {"error": {"code": "NOT_FOUND", "message": "…", "charged": false}}. None of them are charged.