Google Trends interest by region for a keyword — search popularity by geography for geo-ta

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x9AACeabAD8E1858b72fcEA1665381B168841b2fa",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "payTo": "0x9AACeabAD8E1858b72fcEA1665381B168841b2fa",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "30000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "payTo": "0x9AACeabAD8E1858b72fcEA1665381B168841b2fa",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "30000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "ASt6xvRyQ7ntERsmcYVMdLqZvz1GEN8Fzexzq62tXrNQ",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "30000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "category": "marketing",
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "country": "us",
          "keyword": "bitcoin"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "country": "us",
          "keyword": "bitcoin",
          "queried_at": "2026-06-05T12:00:00Z",
          "regions": [
            {
              "region": "California",
              "value": 100
            }
          ]
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "country": {
                  "description": "Country code, e.g. us (case-insensitive)",
                  "maxLength": 8,
                  "type": "string"
                },
                "keyword": {
                  "description": "Concise Google Trends seed term with meaningful search interest; not a question, instruction, or web-search request",
                  "maxLength": 100,
                  "type": "string"
                }
              },
              "required": [
                "keyword",
                "country"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "properties": {
                "country": {
                  "description": "Echoed country code, lower-cased",
                  "type": "string"
                },
                "keyword": {
                  "description": "Echoed search keyword",
                  "type": "string"
                },
                "queried_at": {
                  "description": "UTC timestamp the upstream was queried",
                  "format": "date-time",
                  "type": "string"
                },
                "regions": {
                  "description": "Interest broken down by subregion within the country",
                  "items": {
                    "properties": {
                      "region": {
                        "description": "Subregion name",
                        "type": "string"
                      },
                      "value": {
                        "description": "Relative search-popularity index (0-100)",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "region",
                      "value"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                }
              },
              "required": [
                "keyword",
                "country",
                "queried_at",
                "regions"
              ],
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    },
    "tags": [
      "google-trends",
      "interest-by-region",
      "geo-targeting",
      "keyword-research",
      "seo",
      "regional-demand",
      "market-research"
    ]
  }
}

curl "https://google-trends.use.x402atlas.com/interest-by-region"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://google-trends.use.x402atlas.com/interest-by-region");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://google-trends.use.x402atlas.com/interest-by-region")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header