{
  "x402Version": 2,
  "id": 57605,
  "slug": "57605",
  "resource": "https://keywords.duoleads.com/v1/interest-by-region",
  "description": "Google Trends interest by region for one keyword: 0-100 interest per subregion of a country (or per country worldwide), past 7 days to 5 years, in one $0.03 GET. Use when you need where a keyword is searched most, for geo-targeting or local market research. A live call takes up to about 30 s. Bad input is free; upstream errors are not charged.",
  "type": "http",
  "serviceName": "Keyword Search Volume & CPC",
  "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791923276/bazaar-icons/9096ba1092a8fb40.png",
  "resourceType": "Market Data",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "30000",
      "amountUsd": 0.03,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "country": "us",
            "keyword": "seo api",
            "timeframe": "past_12_months"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "country": "US",
            "dataAsOf": "2022-04-21T18:40:17Z",
            "keyword": "seo api",
            "market": {
              "country": "US",
              "locationCode": 2840,
              "locationName": "United States"
            },
            "queried_at": "2022-04-21T18:40:17Z",
            "regions": [
              {
                "code": "US-NY",
                "region": "New York",
                "value": 100
              },
              {
                "code": "US-CA",
                "region": "California",
                "value": 37
              },
              {
                "code": "US-OR",
                "region": "Oregon",
                "value": 31
              },
              {
                "code": "US-TX",
                "region": "Texas",
                "value": 17
              }
            ],
            "regionsWithoutData": 3,
            "request_id": "01KEXAMPLE0000000000000000",
            "resolution": "region",
            "see_also": {
              "endpoint": "https://keywords.duoleads.com/v1/trend",
              "params": [
                "keyword",
                "country",
                "timeframe"
              ],
              "reason": "Need how interest changed over time in one country? Call trend with that country."
            },
            "source": "Google Trends (via DataForSEO)",
            "timeframe": "past_12_months",
            "units": "value: Google Trends interest, 0-100 relative to the region with the highest interest; regions with too little data are left out (regionsWithoutData)"
          },
          "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": "ISO 3166-1 alpha-2 country code (us, gb, de, ...; uk = gb). Omit for worldwide.",
                    "pattern": "^[A-Za-z]{2}$",
                    "type": "string"
                  },
                  "keyword": {
                    "description": "One keyword or phrase (2-100 characters, no commas).",
                    "maxLength": 100,
                    "minLength": 2,
                    "type": "string"
                  },
                  "timeframe": {
                    "default": "past_12_months",
                    "description": "Time window. Default past_12_months.",
                    "enum": [
                      "past_7_days",
                      "past_30_days",
                      "past_90_days",
                      "past_12_months",
                      "past_5_years"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "keyword"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "google-trends",
    "interest-by-region",
    "geo-targeting",
    "keyword-research",
    "search-trends",
    "bazaar"
  ],
  "sourceHost": "keywords.duoleads.com",
  "lastUpdated": "2026-10-13T20:28:34.233Z",
  "quality": {
    "calls30d": 1,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-10-13T20:28:34.059Z"
  },
  "metadata": {
    "serviceName": "Keyword Search Volume & CPC",
    "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791923276/bazaar-icons/9096ba1092a8fb40.png",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "country": "us",
              "keyword": "seo api",
              "timeframe": "past_12_months"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "country": "US",
              "dataAsOf": "2022-04-21T18:40:17Z",
              "keyword": "seo api",
              "market": {
                "country": "US",
                "locationCode": 2840,
                "locationName": "United States"
              },
              "queried_at": "2022-04-21T18:40:17Z",
              "regions": [
                {
                  "code": "US-NY",
                  "region": "New York",
                  "value": 100
                },
                {
                  "code": "US-CA",
                  "region": "California",
                  "value": 37
                },
                {
                  "code": "US-OR",
                  "region": "Oregon",
                  "value": 31
                },
                {
                  "code": "US-TX",
                  "region": "Texas",
                  "value": 17
                }
              ],
              "regionsWithoutData": 3,
              "request_id": "01KEXAMPLE0000000000000000",
              "resolution": "region",
              "see_also": {
                "endpoint": "https://keywords.duoleads.com/v1/trend",
                "params": [
                  "keyword",
                  "country",
                  "timeframe"
                ],
                "reason": "Need how interest changed over time in one country? Call trend with that country."
              },
              "source": "Google Trends (via DataForSEO)",
              "timeframe": "past_12_months",
              "units": "value: Google Trends interest, 0-100 relative to the region with the highest interest; regions with too little data are left out (regionsWithoutData)"
            },
            "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": "ISO 3166-1 alpha-2 country code (us, gb, de, ...; uk = gb). Omit for worldwide.",
                      "pattern": "^[A-Za-z]{2}$",
                      "type": "string"
                    },
                    "keyword": {
                      "description": "One keyword or phrase (2-100 characters, no commas).",
                      "maxLength": 100,
                      "minLength": 2,
                      "type": "string"
                    },
                    "timeframe": {
                      "default": "past_12_months",
                      "description": "Time window. Default past_12_months.",
                      "enum": [
                        "past_7_days",
                        "past_30_days",
                        "past_90_days",
                        "past_12_months",
                        "past_5_years"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "keyword"
                  ],
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "keywords.duoleads.com",
    "manifest_name": "keywords.duoleads.com",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}