1Request
string[]Required

1 to 5 search terms or topic ids, compared on one relative 0-100 scale. Separate values with commas.

number

Trends category id; 0 is all categories.

string

Location: empty for worldwide, an ISO country (US), region (US-CA) or US metro (US-CA-807).

string

Which search to measure: web, images, news, youtube or shopping.

5 credits
Codefollows the fields above
const result = await firecrawl.scrape({
  alexandria: {
    provider: "firecrawl-trends",
    capability: "trends/interest_by_region",
    options: {
      geo: "US",
      keywords: [
        "pizza",
      ],
    },
  },
});
2Response example

This is a sample shape. Press Run to see live data from Trends.

Long values are shortened in this preview. The full response is 8 KB.

{
  "category": 0,
  "geo": "US",
  "keywords": [
    "pizza"
  ],
  "observed_at_ms": 1790971200000,
  "property": "web",
  "regions": [
    {
      "geo_code": "US-OH",
      "geo_name": "Ohio",
      "has_data": [
        true
      ],
      "values": [
        100
      ]
    },
    {
      "geo_code": "US-RI",
      "geo_name": "Rhode Island",
      "has_data": [
        true
      ],
      "values": [
        95
      ]
    },
    {
      "geo_code": "US-CT",
      "geo_name": "Connecticut",
      "has_data": [
        true
      ],
      "values": [
        94
      ]
    },
    {
      "geo_code": "US-PA",
      "geo_name": "Pennsylvania",
      "has_data": [
        true
      ],
      "values": [
        93
      ]
    },
    {
      "geo_code": "US-NH",
      "geo_name": "New Hampshire",
      "has_data": [
        true
      ],
      "values": [
        89
      ]
    },
    {
      "geo_code": "US-DE",
      "geo_name": "Delaware",
      "has_data": [
        true
      ],
      "values": [
        88
      ]
    },
    {
      "geo_code": "US-IL",
      "geo_name": "Illinois",
      "has_data": [
        true
      ],
      "values": [
        86
      ]
    },
    {
      "geo_code": "US-MA",
      "geo_name": "Massachusetts",
      "has_data": [
        true
      ],
      "values": [
        83
      ]
    },
    {
      "geo_code": "US-MI",
      "geo_name": "Michigan",
      "has_data": [
        true
      ],
      "values": [
        83
      ]
    },
    {
      "geo_code": "US-WY",
      "geo_name": "Wyoming",
      "has_data": [
        true
      ],
      "values": [
        81
      ]
    },
    {
      "geo_code": "US-SC",
      "geo_name": "South Carolina",
      "has_data": [
        true
      ],
      "values": [
        80
      ]
    },
    {
      "geo_code": "US-NY",
      "geo_name": "New York",
      "has_data": [
        true
      ],
      "values": [
        77
      ]
    },
    {
      "geo_code": "US-IN",
      "geo_name": "Indiana",
      "has_data": [
        true
      ],
      "values": [
        75
      ]
    },
    {
      "geo_code": "US-NJ",
      "geo_name": "New Jersey",
      "has_data": [
        true
      ],
      "values": [
        74
      ]
    },
    {
      "geo_code": "US-AR",
      "geo_name": "Arkansas",
      "has_data": [
        true
      ],
      "values": [
        74
      ]
    },
    {
      "geo_code": "US-NV",
      "geo_name": "Nevada",
      "has_data": [
        true
      ],
      "values": [
        73
      ]
    },
    {
      "geo_code": "US-WV",
      "geo_name": "West Virginia",
      "has_data": [
        true
      ],
      "values": [
        73
      ]
    },
    {
      "geo_code": "US-CA",
      "geo_name": "California",
      "has_data": [
        true
      ],
      "values": [
        71
      ]
    },
    {
      "geo_code": "US-KS",
      "geo_name": "Kansas",
      "has_data": [
        true
      ],
      "values": [
        69
      ]
    },
    {
      "geo_code": "US-WI",
      "geo_name": "Wisconsin",
      "has_data": [
        true
      ],
      "values": [
        69
      ]
    },
    {
      "geo_code": "US-VT",
      "geo_name": "Vermont",
      "has_data": [
        true
      ],
      "values": [
        69
      ]
    },
    {
      "geo_code": "US-ME",
      "geo_name": "Maine",
      "has_data": [
        true
      ],
      "values": [
        67
      ]
    },
    {
      "geo_code": "US-FL",
      "geo_name": "Florida",
      "has_data": [
        true
      ],
      "values": [
        67
      ]
    },
    {
      "geo_code": "US-IA",
      "geo_name": "Iowa",
      "has_data": [
        true
      ],
      "values": [
        66
      ]
    },
    {
      "geo_code": "US-AZ",
      "geo_name": "Arizona",
      "has_data": [
        true
      ],
      "values": [
        66
      ]
    },
    {
      "geo_code": "US-WA",
      "geo_name": "Washington",
      "has_data": [
        true
      ],
      "values": [
        65
      ]
    },
    {
      "geo_code": "US-MN",
      "geo_name": "Minnesota",
      "has_data": [
        true
      ],
      "values": [
        64
      ]
    },
    {
      "geo_code": "US-MO",
      "geo_name": "Missouri",
      "has_data": [
        true
      ],
      "values": [
        64
      ]
    },
    {
      "geo_code": "US-KY",
      "geo_name": "Kentucky",
      "has_data": [
        true
      ],
      "values": [
        64
      ]
    },
    {
      "geo_code": "US-NC",
      "geo_name": "North Carolina",
      "has_data": [
        true
      ],
      "values": [
        64
      ]
    },
    {
      "geo_code": "US-LA",
      "geo_name": "Louisiana",
      "has_data": [
        true
      ],
      "values": [
        63
      ]
    },
    {
      "geo_code": "US-DC",
      "geo_name": "District of Columbia",
      "has_data": [
        true
      ],
      "values": [
        63
      ]
    },
    {
      "geo_code": "US-SD",
      "geo_name": "South Dakota",
      "has_data": [
        true
      ],
      "values": [
        63
      ]
    },
    {
      "geo_code": "US-MD",
      "geo_name": "Maryland",
      "has_data": [
        true
      ],
      "values": [
        63
      ]
    },
    {
      "geo_code": "US-VA",
      "geo_name": "Virginia",
      "has_data": [
        true
      ],
      "values": [
        62
      ]
    },
    {
      "geo_code": "US-MT",
      "geo_name": "Montana",
      "has_data": [
        true
      ],
      "values": [
        62
      ]
    },
    {
      "geo_code": "US-TX",
      "geo_name": "Texas",
      "has_data": [
        true
      ],
      "values": [
        62
      ]
    },
    {
      "geo_code": "US-ID",
      "geo_name": "Idaho",
      "has_data": [
        true
      ],
      "values": [
        60
      ]
    },
    {
      "geo_code": "US-ND",
      "geo_name": "North Dakota",
      "has_data": [
        true
      ],
      "values": [
        60
      ]
    },
    {
      "geo_code": "US-NE",
      "geo_name": "Nebraska",
      "has_data": [
        true
      ],
      "values": [
        60
      ]
    },
    {
      "geo_code": "US-AK",
      "geo_name": "Alaska",
      "has_data": [
        true
      ],
      "values": [
        59
      ]
    },
    {
      "geo_code": "US-MS",
      "geo_name": "Mississippi",
      "has_data": [
        true
      ],
      "values": [
        59
      ]
    },
    {
      "geo_code": "US-OR",
      "geo_name": "Oregon",
      "has_data": [
        true
      ],
      "values": [
        58
      ]
    },
    {
      "geo_code": "US-OK",
      "geo_name": "Oklahoma",
      "has_data": [
        true
      ],
      "values": [
        58
      ]
    },
    {
      "geo_code": "US-TN",
      "geo_name": "Tennessee",
      "has_data": [
        true
      ],
      "values": [
        57
      ]
    },
    {
      "geo_code": "US-NM",
      "geo_name": "New Mexico",
      "has_data": [
        true
      ],
      "values": [
        56
      ]
    },
    {
      "geo_code": "US-AL",
      "geo_name": "Alabama",
      "has_data": [
        true
      ],
      "values": [
        55
      ]
    },
    {
      "geo_code": "US-CO",
      "geo_name": "Colorado",
      "has_data": [
        true
      ],
      "values": [
        55
      ]
    },
    {
      "geo_code": "US-GA",
      "geo_name": "Georgia",
      "has_data": [
        true
      ],
      "values": [
        54
      ]
    },
    {
      "geo_code": "US-UT",
      "geo_name": "Utah",
      "has_data": [
        true
      ],
      "values": [
        49
      ]
    },
    "… [1 more items]"
  ],
  "resolution": "region",
  "source_url": "https://trends.firecrawl.dev/explore?q=pizza&geo=US&date=today+12-m",
  "time": "today 12-m"
}
Browse the library