Google Trends Interest by Region

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "docs": "https://keywords.duoleads.com/docs",
  "hint": "Pay with x402 v2 (scheme exact, USDC on Base): sign accepts[0] of the PAYMENT-REQUIRED header and resend the same request with a PAYMENT-SIGNATURE header. Bad input is answered free with a 400.",
  "error": "payment_required",
  "price": "0.03 per call",
  "terms": "https://keywords.duoleads.com/terms",
  "method": "GET",
  "resource": "https://keywords.duoleads.com/v1/interest-by-region",
  "disclaimer": "Third-party estimates: Google Ads and Google Trends data obtained through DataForSEO. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal or any other professional advice. Terms: https://keywords.duoleads.com/terms"
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39",
    "amount": "30000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 120
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "country": "us",
          "keyword": "seo api",
          "timeframe": "past_12_months"
        }
      },
      "output": {
        "type": "json",
        "example": {
          "units": "value: Google Trends interest, 0-100 relative to the region with the highest interest; regions with too little data are left out (regionsWithoutData)",
          "market": {
            "country": "US",
            "locationCode": 2840,
            "locationName": "United States"
          },
          "source": "Google Trends (via DataForSEO)",
          "country": "US",
          "keyword": "seo api",
          "regions": [
            {
              "code": "US-NY",
              "value": 100,
              "region": "New York"
            },
            {
              "code": "US-CA",
              "value": 37,
              "region": "California"
            },
            {
              "code": "US-OR",
              "value": 31,
              "region": "Oregon"
            },
            {
              "code": "US-TX",
              "value": 17,
              "region": "Texas"
            }
          ],
          "dataAsOf": "2022-04-21T18:40:17Z",
          "see_also": {
            "params": [
              "keyword",
              "country",
              "timeframe"
            ],
            "reason": "Need how interest changed over time in one country? Call trend with that country.",
            "endpoint": "https://keywords.duoleads.com/v1/trend"
          },
          "timeframe": "past_12_months",
          "queried_at": "2022-04-21T18:40:17Z",
          "request_id": "01KEXAMPLE0000000000000000",
          "resolution": "region",
          "regionsWithoutData": 3
        }
      }
    },
    "schema": {
      "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": [
                "keyword"
              ],
              "properties": {
                "country": {
                  "type": "string",
                  "pattern": "^[A-Za-z]{2}$",
                  "description": "ISO 3166-1 alpha-2 country code (us, gb, de, ...; uk = gb). Omit for worldwide."
                },
                "keyword": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 2,
                  "description": "One keyword or phrase (2-100 characters, no commas)."
                },
                "timeframe": {
                  "enum": [
                    "past_7_days",
                    "past_30_days",
                    "past_90_days",
                    "past_12_months",
                    "past_5_years"
                  ],
                  "type": "string",
                  "default": "past_12_months",
                  "description": "Time window. Default past_12_months."
                }
              }
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-10-18 05:26Z

Last indexed by Roundhouse

2026-10-26 17:20Z

Last enriched (probe, favicon, geo)

2026-10-13 22:16Z

x402 version

2

Max timeout

120s

Liveness probe

HTTP 402