---
type: "firecrawl-provider"
description: "Search interest over time and by region, related and rising queries, keyword suggestions and what is trending now."
use_when: "Search interest over time and by region, related and rising queries, keyword suggestions and what is trending now."
categories: "News"
capabilities: 5
credits_per_call: "0-5"
---
# Trends on Firecrawl Alexandria

Search interest over time and by region, related and rising queries, keyword suggestions and what is trending now.

- Categories: News
- Category index: [News category](https://firecrawl.dev/alexandria/agents/categories/news)
- Provider key: `firecrawl-trends`
- Access: Firecrawl credits
- Cost: 0–5 credits per call
- Delivery: First 100 words of each matching article

## More

- [Human guide](https://firecrawl.dev/app/alexandria/firecrawl-trends)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/openapi.json)

## Capabilities

- [Interest by region](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/interest_by_region): Search interest by location for 1-5 terms or topics (Trends Explore 'Interest by subregion'). Resolution: country (worldwide default), region (default inside a country), metro (Nielsen DMA, US only; 's default inside a US state), or city (rows give coordinates instead of a geo code). When omitted, 's own default for the geo is used. With one keyword values are 0-100 relative to the top location; with several, each keyword's percentage share of the location's searches. Locations without data for any keyword are omitted, as on 's page.
- [Interest over time](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/interest_over_time): Search interest over time for 1-5 terms or topics (Trends Explore 'Interest over time'). Each point has a UTC time, 's label and a 0-100 value per keyword, relative to the highest point across all keywords in the range. Bucket size (resolution) follows the range: MINUTE/EIGHT_MINUTE for hours, HOUR for 1-7 days, DAY up to ~9 months, WEEK up to 5 years, MONTH beyond. `partial` marks the incomplete latest bucket. Averages are given only when comparing several keywords.
- [Related queries](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/related_queries): Related searches for one term or topic (Trends Explore 'Related queries'): top queries ranked by relative popularity (0-100) and rising queries ranked by growth versus the previous period (percent, or Breakout above 5000%). Each has a Trends Explore link. Both lists can be empty for low-volume terms.
- [Suggestions](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/suggestions): Trends topic suggestions for a partial term: Knowledge Graph topics with id, title and type (e.g. /m/0663v Pizza, Dish). Pass an id as a keyword to the other functions to measure the topic (all its names and languages) instead of the literal search term.
- [Trending now](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/trending_now): Trends 'Trending now': searches surging in a country over the past 4, 24 or 48 hours or 7 days, in 's order. Each trend has approximate search volume, percent increase, UTC start (and end once it is no longer active), 's category names, the related searches grouped into it, and an Explore link.

## 1. Choose this provider when

Search interest over time and by region, related and rising queries, keyword suggestions and what is trending now.

## Article preview policy

News providers return metadata plus the first 100 words of each matching article. They are not wrapped third-party APIs and do not return full article text.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "firecrawl-trends",
  "capability": "trends/interest_by_region",
  "options": {
    "geo": "US",
    "keywords": [
      "pizza"
    ]
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `category` (number): Trends category id; 0 is all categories. Example: `0`
- `geo` (string): Location: empty for worldwide, an ISO country (US), region (US-CA) or US metro (US-CA-807). Pattern: ^([A-Z]{2}(-[A-Z0-9]{1,3}(-[0-9]{3})?)?)?$. Example: `<geo>`
- `keywords` (string[], required): 1 to 5 search terms or topic ids, compared on one relative 0-100 scale. Example: `[]`
- `property` (string): Which search to measure: web, images, news, youtube or shopping. Example: `web`
- `resolution` (string): Breakdown level; defaults to 's (country worldwide, region in a country). metro = US Nielsen DMA. Example: `country`
- `time` (string): Time range: now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or `YYYY-MM-DD YYYY-MM-DD` (from 2004-01-01). Shorter ranges give finer buckets (minute, hour, day); longer ones week or month. Pattern: ^(now 1-H|now 4-H|now 1-d|now 7-d|today 1-m|today 3-m|today 12-m|today 5-y|all|[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{4}-[0-9]{2}-[0-9]{2})$. Example: `today 12-m`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "firecrawl-trends",
    capability: "trends/interest_by_region",
    options: {
      geo: "US",
      keywords: [
        "pizza",
      ],
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "firecrawl-trends",
  "capability": "trends/interest_by_region",
  "options": {
    "geo": "US",
    "keywords": [
      "pizza"
    ]
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "firecrawl-trends",
    "capability": "trends/interest_by_region",
    "options": {
      "geo": "US",
      "keywords": [
        "pizza"
      ]
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'firecrawl-trends/trends/interest_by_region' \
  --options '{"geo":"US","keywords":["pizza"]}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "firecrawl-trends",
  "capability": "trends/interest_by_region",
  "options": {
    "geo": "US",
    "keywords": [
      "pizza"
    ]
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "firecrawl-trends",
  "capability": "trends/interest_by_region",
  "options": {
    "geo": "US",
    "keywords": [
      "pizza"
    ]
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "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
      ]
    },
    {
      "geo_code": "US-HI",
      "geo_name": "Hawaii",
      "has_data": [
        true
      ],
      "values": [
        45
      ]
    }
  ],
  "resolution": "region",
  "source_url": "https://trends.firecrawl.dev/explore?q=pizza&geo=US&date=today+12-m",
  "time": "today 12-m"
}
```

## API reference-derived contract

This provider returns article metadata and a 100-word preview; use the source URL for the complete article.

### Interest by region

- Capability: `trends/interest_by_region`
- Description: Search interest by location for 1-5 terms or topics (Trends Explore 'Interest by subregion'). Resolution: country (worldwide default), region (default inside a country), metro (Nielsen DMA, US only; 's default inside a US state), or city (rows give coordinates instead of a geo code). When omitted, 's own default for the geo is used. With one keyword values are 0-100 relative to the top location; with several, each keyword's percentage share of the location's searches. Locations without data for any keyword are omitted, as on 's page.
- Instructions: Where a term is most popular: top states, countries, metros or cities.
- Cost: 5 credits per call
- Capability file: [Interest by region](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/interest_by_region)

Accepted options:
- `category` (number): Trends category id; 0 is all categories. Example: `0`
- `geo` (string): Location: empty for worldwide, an ISO country (US), region (US-CA) or US metro (US-CA-807). Pattern: ^([A-Z]{2}(-[A-Z0-9]{1,3}(-[0-9]{3})?)?)?$. Example: `<geo>`
- `keywords` (string[], required): 1 to 5 search terms or topic ids, compared on one relative 0-100 scale. Example: `[]`
- `property` (string): Which search to measure: web, images, news, youtube or shopping. Example: `web`
- `resolution` (string): Breakdown level; defaults to 's (country worldwide, region in a country). metro = US Nielsen DMA. Example: `country`
- `time` (string): Time range: now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or `YYYY-MM-DD YYYY-MM-DD` (from 2004-01-01). Shorter ranges give finer buckets (minute, hour, day); longer ones week or month. Pattern: ^(now 1-H|now 4-H|now 1-d|now 7-d|today 1-m|today 3-m|today 12-m|today 5-y|all|[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{4}-[0-9]{2}-[0-9]{2})$. Example: `today 12-m`

Response schema example:
```json
{
  "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
      ]
    },
    {
      "geo_code": "US-HI",
      "geo_name": "Hawaii",
      "has_data": [
        true
      ],
      "values": [
        45
      ]
    }
  ],
  "resolution": "region",
  "source_url": "https://trends.firecrawl.dev/explore?q=pizza&geo=US&date=today+12-m",
  "time": "today 12-m"
}
```

### Interest over time

- Capability: `trends/interest_over_time`
- Description: Search interest over time for 1-5 terms or topics (Trends Explore 'Interest over time'). Each point has a UTC time, 's label and a 0-100 value per keyword, relative to the highest point across all keywords in the range. Bucket size (resolution) follows the range: MINUTE/EIGHT_MINUTE for hours, HOUR for 1-7 days, DAY up to ~9 months, WEEK up to 5 years, MONTH beyond. `partial` marks the incomplete latest bucket. Averages are given only when comparing several keywords.
- Instructions: Trend lines, seasonality, or comparing popularity of terms over a period.
- Cost: 5 credits per call
- Capability file: [Interest over time](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/interest_over_time)

Accepted options:
- `category` (number): Trends category id; 0 is all categories. Example: `0`
- `geo` (string): Location: empty for worldwide, an ISO country (US), region (US-CA) or US metro (US-CA-807). Pattern: ^([A-Z]{2}(-[A-Z0-9]{1,3}(-[0-9]{3})?)?)?$. Example: `<geo>`
- `keywords` (string[], required): 1 to 5 search terms or topic ids, compared on one relative 0-100 scale. Example: `[]`
- `property` (string): Which search to measure: web, images, news, youtube or shopping. Example: `web`
- `time` (string): Time range: now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or `YYYY-MM-DD YYYY-MM-DD` (from 2004-01-01). Shorter ranges give finer buckets (minute, hour, day); longer ones week or month. Pattern: ^(now 1-H|now 4-H|now 1-d|now 7-d|today 1-m|today 3-m|today 12-m|today 5-y|all|[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{4}-[0-9]{2}-[0-9]{2})$. Example: `today 12-m`

Response schema example:
```json
{
  "averages": [],
  "category": 0,
  "geo": "US",
  "keywords": [
    "pizza"
  ],
  "observed_at_ms": 1790971200000,
  "points": [
    {
      "has_data": [
        true
      ],
      "label": "Sep 28 – Oct 4, 2025",
      "partial": false,
      "time": "2025-09-28T00:00:00Z",
      "timestamp": 1759017600,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Oct 5 – 11, 2025",
      "partial": false,
      "time": "2025-10-05T00:00:00Z",
      "timestamp": 1759622400,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Oct 12 – 18, 2025",
      "partial": false,
      "time": "2025-10-12T00:00:00Z",
      "timestamp": 1760227200,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Oct 19 – 25, 2025",
      "partial": false,
      "time": "2025-10-19T00:00:00Z",
      "timestamp": 1760832000,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Oct 26 – Nov 1, 2025",
      "partial": false,
      "time": "2025-10-26T00:00:00Z",
      "timestamp": 1761436800,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Nov 2 – 8, 2025",
      "partial": false,
      "time": "2025-11-02T00:00:00Z",
      "timestamp": 1762041600,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Nov 9 – 15, 2025",
      "partial": false,
      "time": "2025-11-09T00:00:00Z",
      "timestamp": 1762646400,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Nov 16 – 22, 2025",
      "partial": false,
      "time": "2025-11-16T00:00:00Z",
      "timestamp": 1763251200,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Nov 23 – 29, 2025",
      "partial": false,
      "time": "2025-11-23T00:00:00Z",
      "timestamp": 1763856000,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Nov 30 – Dec 6, 2025",
      "partial": false,
      "time": "2025-11-30T00:00:00Z",
      "timestamp": 1764460800,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Dec 7 – 13, 2025",
      "partial": false,
      "time": "2025-12-07T00:00:00Z",
      "timestamp": 1765065600,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Dec 14 – 20, 2025",
      "partial": false,
      "time": "2025-12-14T00:00:00Z",
      "timestamp": 1765670400,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Dec 21 – 27, 2025",
      "partial": false,
      "time": "2025-12-21T00:00:00Z",
      "timestamp": 1766275200,
      "values": [
        28
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Dec 28, 2025 – Jan 3, 2026",
      "partial": false,
      "time": "2025-12-28T00:00:00Z",
      "timestamp": 1766880000,
      "values": [
        28
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jan 4 – 10, 2026",
      "partial": false,
      "time": "2026-01-04T00:00:00Z",
      "timestamp": 1767484800,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jan 11 – 17, 2026",
      "partial": false,
      "time": "2026-01-11T00:00:00Z",
      "timestamp": 1768089600,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jan 18 – 24, 2026",
      "partial": false,
      "time": "2026-01-18T00:00:00Z",
      "timestamp": 1768694400,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jan 25 – 31, 2026",
      "partial": false,
      "time": "2026-01-25T00:00:00Z",
      "timestamp": 1769299200,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Feb 1 – 7, 2026",
      "partial": false,
      "time": "2026-02-01T00:00:00Z",
      "timestamp": 1769904000,
      "values": [
        26
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Feb 8 – 14, 2026",
      "partial": false,
      "time": "2026-02-08T00:00:00Z",
      "timestamp": 1770508800,
      "values": [
        27
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Feb 15 – 21, 2026",
      "partial": false,
      "time": "2026-02-15T00:00:00Z",
      "timestamp": 1771113600,
      "values": [
        26
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Feb 22 – 28, 2026",
      "partial": false,
      "time": "2026-02-22T00:00:00Z",
      "timestamp": 1771718400,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Mar 1 – 7, 2026",
      "partial": false,
      "time": "2026-03-01T00:00:00Z",
      "timestamp": 1772323200,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Mar 8 – 14, 2026",
      "partial": false,
      "time": "2026-03-08T00:00:00Z",
      "timestamp": 1772928000,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Mar 15 – 21, 2026",
      "partial": false,
      "time": "2026-03-15T00:00:00Z",
      "timestamp": 1773532800,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Mar 22 – 28, 2026",
      "partial": false,
      "time": "2026-03-22T00:00:00Z",
      "timestamp": 1774137600,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Mar 29 – Apr 4, 2026",
      "partial": false,
      "time": "2026-03-29T00:00:00Z",
      "timestamp": 1774742400,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Apr 5 – 11, 2026",
      "partial": false,
      "time": "2026-04-05T00:00:00Z",
      "timestamp": 1775347200,
      "values": [
        26
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Apr 12 – 18, 2026",
      "partial": false,
      "time": "2026-04-12T00:00:00Z",
      "timestamp": 1775952000,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Apr 19 – 25, 2026",
      "partial": false,
      "time": "2026-04-19T00:00:00Z",
      "timestamp": 1776556800,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Apr 26 – May 2, 2026",
      "partial": false,
      "time": "2026-04-26T00:00:00Z",
      "timestamp": 1777161600,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "May 3 – 9, 2026",
      "partial": false,
      "time": "2026-05-03T00:00:00Z",
      "timestamp": 1777766400,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "May 10 – 16, 2026",
      "partial": false,
      "time": "2026-05-10T00:00:00Z",
      "timestamp": 1778371200,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "May 17 – 23, 2026",
      "partial": false,
      "time": "2026-05-17T00:00:00Z",
      "timestamp": 1778976000,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "May 24 – 30, 2026",
      "partial": false,
      "time": "2026-05-24T00:00:00Z",
      "timestamp": 1779580800,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "May 31 – Jun 6, 2026",
      "partial": false,
      "time": "2026-05-31T00:00:00Z",
      "timestamp": 1780185600,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jun 7 – 13, 2026",
      "partial": false,
      "time": "2026-06-07T00:00:00Z",
      "timestamp": 1780790400,
      "values": [
        90
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jun 14 – 20, 2026",
      "partial": false,
      "time": "2026-06-14T00:00:00Z",
      "timestamp": 1781395200,
      "values": [
        100
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jun 21 – 27, 2026",
      "partial": false,
      "time": "2026-06-21T00:00:00Z",
      "timestamp": 1782000000,
      "values": [
        30
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jun 28 – Jul 4, 2026",
      "partial": false,
      "time": "2026-06-28T00:00:00Z",
      "timestamp": 1782604800,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jul 5 – 11, 2026",
      "partial": false,
      "time": "2026-07-05T00:00:00Z",
      "timestamp": 1783209600,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jul 12 – 18, 2026",
      "partial": false,
      "time": "2026-07-12T00:00:00Z",
      "timestamp": 1783814400,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jul 19 – 25, 2026",
      "partial": false,
      "time": "2026-07-19T00:00:00Z",
      "timestamp": 1784419200,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Jul 26 – Aug 1, 2026",
      "partial": false,
      "time": "2026-07-26T00:00:00Z",
      "timestamp": 1785024000,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Aug 2 – 8, 2026",
      "partial": false,
      "time": "2026-08-02T00:00:00Z",
      "timestamp": 1785628800,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Aug 9 – 15, 2026",
      "partial": false,
      "time": "2026-08-09T00:00:00Z",
      "timestamp": 1786233600,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Aug 16 – 22, 2026",
      "partial": false,
      "time": "2026-08-16T00:00:00Z",
      "timestamp": 1786838400,
      "values": [
        25
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Aug 23 – 29, 2026",
      "partial": false,
      "time": "2026-08-23T00:00:00Z",
      "timestamp": 1787443200,
      "values": [
        23
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Aug 30 – Sep 5, 2026",
      "partial": false,
      "time": "2026-08-30T00:00:00Z",
      "timestamp": 1788048000,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Sep 6 – 12, 2026",
      "partial": false,
      "time": "2026-09-06T00:00:00Z",
      "timestamp": 1788652800,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Sep 13 – 19, 2026",
      "partial": false,
      "time": "2026-09-13T00:00:00Z",
      "timestamp": 1789257600,
      "values": [
        22
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Sep 20 – 26, 2026",
      "partial": false,
      "time": "2026-09-20T00:00:00Z",
      "timestamp": 1789862400,
      "values": [
        24
      ]
    },
    {
      "has_data": [
        true
      ],
      "label": "Sep 27 – Oct 3, 2026",
      "partial": true,
      "time": "2026-09-27T00:00:00Z",
      "timestamp": 1790467200,
      "values": [
        20
      ]
    }
  ],
  "property": "web",
  "resolution": "WEEK",
  "source_url": "https://trends.firecrawl.dev/explore?q=pizza&geo=US&date=today+12-m",
  "time": "today 12-m"
}
```

### Related queries

- Capability: `trends/related_queries`
- Description: Related searches for one term or topic (Trends Explore 'Related queries'): top queries ranked by relative popularity (0-100) and rising queries ranked by growth versus the previous period (percent, or Breakout above 5000%). Each has a Trends Explore link. Both lists can be empty for low-volume terms.
- Instructions: Keyword research: what else people search alongside a term, and what is newly rising.
- Cost: 5 credits per call
- Capability file: [Related queries](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/related_queries)

Accepted options:
- `category` (number): Trends category id; 0 is all categories. Example: `0`
- `geo` (string): Location: empty for worldwide, an ISO country (US), region (US-CA) or US metro (US-CA-807). Pattern: ^([A-Z]{2}(-[A-Z0-9]{1,3}(-[0-9]{3})?)?)?$. Example: `<geo>`
- `keyword` (string, required): One search term or topic id from suggestions; no commas. Example: `<keyword>`
- `property` (string): Which search to measure: web, images, news, youtube or shopping. Example: `web`
- `time` (string): Time range: now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or `YYYY-MM-DD YYYY-MM-DD` (from 2004-01-01). Shorter ranges give finer buckets (minute, hour, day); longer ones week or month. Pattern: ^(now 1-H|now 4-H|now 1-d|now 7-d|today 1-m|today 3-m|today 12-m|today 5-y|all|[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{4}-[0-9]{2}-[0-9]{2})$. Example: `today 12-m`

Response schema example:
```json
{
  "category": 0,
  "geo": "US",
  "keyword": "pizza",
  "observed_at_ms": 1790971200000,
  "property": "web",
  "rising": [
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+napoletana+near+me&date=today+12-m&geo=US",
      "formatted_value": "+2,500%",
      "query": "pizza napoletana near me",
      "value": 2500
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=how+to+make+pizza+dough+at+home&date=today+12-m&geo=US",
      "formatted_value": "+2,450%",
      "query": "how to make pizza dough at home",
      "value": 2450
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=gardening&date=today+12-m&geo=US",
      "formatted_value": "+1,800%",
      "query": "gardening",
      "value": 1800
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=best+pizza+near+me+open+now&date=today+12-m&geo=US",
      "formatted_value": "+1,400%",
      "query": "best pizza near me open now",
      "value": 1400
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=what+is+a+pizza+stone&date=today+12-m&geo=US",
      "formatted_value": "+1,400%",
      "query": "what is a pizza stone",
      "value": 1400
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=cycling&date=today+12-m&geo=US",
      "formatted_value": "+1,150%",
      "query": "cycling",
      "value": 1150
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=gluten+free+pizza+crust+recipe&date=today+12-m&geo=US",
      "formatted_value": "+1,050%",
      "query": "gluten free pizza crust recipe",
      "value": 1050
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=hospitals&date=today+12-m&geo=US",
      "formatted_value": "+1,000%",
      "query": "hospitals",
      "value": 1000
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+calzone+near+me&date=today+12-m&geo=US",
      "formatted_value": "+950%",
      "query": "pizza calzone near me",
      "value": 950
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=best+deep+dish+pizza+in+chicago&date=today+12-m&geo=US",
      "formatted_value": "+800%",
      "query": "best deep dish pizza in chicago",
      "value": 800
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=museums&date=today+12-m&geo=US",
      "formatted_value": "+700%",
      "query": "museums",
      "value": 700
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=photography&date=today+12-m&geo=US",
      "formatted_value": "+700%",
      "query": "photography",
      "value": 700
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+margherita+near+me&date=today+12-m&geo=US",
      "formatted_value": "+650%",
      "query": "pizza margherita near me",
      "value": 650
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=hiking&date=today+12-m&geo=US",
      "formatted_value": "+550%",
      "query": "hiking",
      "value": 550
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=vitamins&date=today+12-m&geo=US",
      "formatted_value": "+550%",
      "query": "vitamins",
      "value": 550
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=swimming&date=today+12-m&geo=US",
      "formatted_value": "+450%",
      "query": "swimming",
      "value": 450
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=concerts&date=today+12-m&geo=US",
      "formatted_value": "+400%",
      "query": "concerts",
      "value": 400
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=banks&date=today+12-m&geo=US",
      "formatted_value": "+350%",
      "query": "banks",
      "value": 350
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=camping&date=today+12-m&geo=US",
      "formatted_value": "+300%",
      "query": "camping",
      "value": 300
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=yoga&date=today+12-m&geo=US",
      "formatted_value": "+300%",
      "query": "yoga",
      "value": 300
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=best+pizza+near+me&date=today+12-m&geo=US",
      "formatted_value": "+200%",
      "query": "best pizza near me",
      "value": 200
    },
    {
      "breakout": false,
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+movie&date=today+12-m&geo=US",
      "formatted_value": "+60%",
      "query": "pizza movie",
      "value": 60
    }
  ],
  "source_url": "https://trends.firecrawl.dev/explore?q=pizza&geo=US&date=today+12-m",
  "time": "today 12-m",
  "top": [
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+near+me&date=today+12-m&geo=US",
      "formatted_value": "100",
      "query": "pizza near me",
      "value": 100
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+hut&date=today+12-m&geo=US",
      "formatted_value": "85",
      "query": "pizza hut",
      "value": 85
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=dominos&date=today+12-m&geo=US",
      "formatted_value": "29",
      "query": "dominos",
      "value": 29
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=dominos+pizza&date=today+12-m&geo=US",
      "formatted_value": "27",
      "query": "dominos pizza",
      "value": 27
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+oven&date=today+12-m&geo=US",
      "formatted_value": "18",
      "query": "pizza oven",
      "value": 18
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=domino%27s+pizza&date=today+12-m&geo=US",
      "formatted_value": "17",
      "query": "domino's pizza",
      "value": 17
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=best+pizza+near+me&date=today+12-m&geo=US",
      "formatted_value": "13",
      "query": "best pizza near me",
      "value": 13
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+delivery&date=today+12-m&geo=US",
      "formatted_value": "13",
      "query": "pizza delivery",
      "value": 13
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+places&date=today+12-m&geo=US",
      "formatted_value": "11",
      "query": "pizza places",
      "value": 11
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=little+caesars+pizza&date=today+12-m&geo=US",
      "formatted_value": "9",
      "query": "little caesars pizza",
      "value": 9
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=little+caesars&date=today+12-m&geo=US",
      "formatted_value": "9",
      "query": "little caesars",
      "value": 9
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+hut+near+me&date=today+12-m&geo=US",
      "formatted_value": "8",
      "query": "pizza hut near me",
      "value": 8
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=papa+johns+pizza&date=today+12-m&geo=US",
      "formatted_value": "7",
      "query": "papa johns pizza",
      "value": 7
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=papa+johns&date=today+12-m&geo=US",
      "formatted_value": "7",
      "query": "papa johns",
      "value": 7
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pasta&date=today+12-m&geo=US",
      "formatted_value": "7",
      "query": "pasta",
      "value": 7
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=costco+pizza&date=today+12-m&geo=US",
      "formatted_value": "7",
      "query": "costco pizza",
      "value": 7
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=marco%27s+pizza&date=today+12-m&geo=US",
      "formatted_value": "7",
      "query": "marco's pizza",
      "value": 7
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=jet%27s+pizza&date=today+12-m&geo=US",
      "formatted_value": "6",
      "query": "jet's pizza",
      "value": 6
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+movie&date=today+12-m&geo=US",
      "formatted_value": "6",
      "query": "pizza movie",
      "value": 6
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+king&date=today+12-m&geo=US",
      "formatted_value": "6",
      "query": "pizza king",
      "value": 6
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+ranch&date=today+12-m&geo=US",
      "formatted_value": "6",
      "query": "pizza ranch",
      "value": 6
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=marcos&date=today+12-m&geo=US",
      "formatted_value": "5",
      "query": "marcos",
      "value": 5
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+delivery+near+me&date=today+12-m&geo=US",
      "formatted_value": "5",
      "query": "pizza delivery near me",
      "value": 5
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=pizza+deals&date=today+12-m&geo=US",
      "formatted_value": "5",
      "query": "pizza deals",
      "value": 5
    },
    {
      "explore_url": "https://trends.firecrawl.dev/explore?q=marcos+pizza&date=today+12-m&geo=US",
      "formatted_value": "5",
      "query": "marcos pizza",
      "value": 5
    }
  ]
}
```

### Suggestions

- Capability: `trends/suggestions`
- Description: Trends topic suggestions for a partial term: Knowledge Graph topics with id, title and type (e.g. /m/0663v Pizza, Dish). Pass an id as a keyword to the other functions to measure the topic (all its names and languages) instead of the literal search term.
- Instructions: Disambiguate a term (Apple the company vs the fruit) before comparing interest.
- Cost: 0 credits per call
- Capability file: [Suggestions](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/suggestions)

Accepted options:
- `query` (string, required): Partial or full term to look up. Example: `<query>`

Response schema example:
```json
{
  "observed_at_ms": 1790971200000,
  "query": "pizza",
  "suggestions": [
    {
      "id": "/m/0663v",
      "title": "Pizza",
      "type": "Dish"
    },
    {
      "id": "/m/0dfxdnc",
      "title": "Pizza dough",
      "type": "Food"
    },
    {
      "id": "/g/11fl7dydwb",
      "title": "Pizza Oven",
      "type": "Topic"
    },
    {
      "id": "/g/11k19hmrkk",
      "title": "Licorice Pizza",
      "type": "2021 film"
    },
    {
      "id": "/m/036bfw",
      "title": "Peel",
      "type": "Tool"
    }
  ]
}
```

### Trending now

- Capability: `trends/trending_now`
- Description: Trends 'Trending now': searches surging in a country over the past 4, 24 or 48 hours or 7 days, in 's order. Each trend has approximate search volume, percent increase, UTC start (and end once it is no longer active), 's category names, the related searches grouped into it, and an Explore link.
- Instructions: What people are searching for right now in a country; news and breakout topics.
- Cost: 5 credits per call
- Capability file: [Trending now](https://firecrawl.dev/alexandria/agents/providers/firecrawl-trends/trends/trending_now)

Accepted options:
- `geo` (string): Two-letter country code. Pattern: ^[A-Z]{2}$. Example: `US`
- `hours` (number): Look-back window in hours (168 = 7 days). Example: `24`

Response schema example:
```json
{
  "geo": "US",
  "hours": 24,
  "observed_at_ms": 1790971200000,
  "source_url": "https://trends.firecrawl.dev/trending?geo=US&hours=24",
  "trends": [
    {
      "active": true,
      "categories": [
        "Other"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=ken+urker&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "ken urker",
        "gypsy rose",
        "gypsy rose blanchard",
        "gypsy rose husband",
        "gypsy rose fiance",
        "ken urker dead",
        "did ken urker pass away",
        "gypsy rose ken urker",
        "ken urker cause of death",
        "how did ken urker pass away",
        "who is gypsy rose blanchard",
        "is ken urker dead",
        "did ken urker die",
        "ken urker death",
        "is ken urker alive",
        "how did ken urker die",
        "ken urker age",
        "who is gypsy rose",
        "ken urker gypsy rose",
        "gypsy rose baby daddy",
        "gypsy rose ken",
        "ken gypsy rose",
        "tmz",
        "gypsy-rose blanchard",
        "ken urker died",
        "gypsy rose fiance dead",
        "gypsy rose blanchard husband",
        "gypsy rose fiance ken",
        "gypsy rose boyfriend ken",
        "gypsy rose husband ken",
        "is gypsy rose still with ken",
        "is gypsys husband dead",
        "tmz ken urker",
        "gypsy rose blanchard fiance",
        "how did gypsys husband die",
        "gypsy",
        "did ken urker really die"
      ],
      "search_volume": 1000000,
      "started_at": "2026-10-02T01:10:00Z",
      "term": "ken urker"
    },
    {
      "active": true,
      "categories": [
        "Sports"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=france+vs+italy&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "france vs italy",
        "italy vs france"
      ],
      "search_volume": 50000,
      "started_at": "2026-10-02T16:50:00Z",
      "term": "france vs italy"
    },
    {
      "active": true,
      "categories": [
        "Sports"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=francia+-+italia&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "francia - italia"
      ],
      "search_volume": 20000,
      "started_at": "2026-10-02T17:50:00Z",
      "term": "francia - italia"
    },
    {
      "active": true,
      "categories": [
        "Law and Government",
        "Politics"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=capitol+police+plaque+lawsuit+dismissal&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "capitol police plaque lawsuit dismissal"
      ],
      "search_volume": 100000,
      "started_at": "2026-10-01T19:40:00Z",
      "term": "capitol police plaque lawsuit dismissal"
    },
    {
      "active": true,
      "categories": [
        "Entertainment"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=what+happened+to+chad+lowes+daughter&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "what happened to chad lowes daughter",
        "who is chad lowe",
        "rob lowe daughter"
      ],
      "search_volume": 50000,
      "started_at": "2026-10-02T03:40:00Z",
      "term": "what happened to chad lowes daughter"
    },
    {
      "active": true,
      "categories": [
        "Law and Government"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=trump+500+check&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "trump 500 check",
        "trump sending 500 dollars"
      ],
      "search_volume": 20000,
      "started_at": "2026-10-02T02:10:00Z",
      "term": "trump 500 check"
    },
    {
      "active": true,
      "categories": [
        "Health"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=brooke+eby&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "brooke eby"
      ],
      "search_volume": 20000,
      "started_at": "2026-10-02T05:50:00Z",
      "term": "brooke eby"
    },
    {
      "active": true,
      "categories": [
        "Sports"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=tony+romo&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "tony romo",
        "jj watt"
      ],
      "search_volume": 20000,
      "started_at": "2026-10-02T16:00:00Z",
      "term": "tony romo"
    },
    {
      "active": true,
      "categories": [
        "Other"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=fox+news+iran&geo=US&date=now+1-d",
      "increase_percent": 800,
      "related_queries": [
        "fox news iran",
        "iran news",
        "donald trump",
        "israel plane",
        "flydubai incident"
      ],
      "search_volume": 20000,
      "started_at": "2026-10-02T09:50:00Z",
      "term": "fox news iran"
    },
    {
      "active": true,
      "categories": [
        "Law and Government",
        "Politics"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=vladimir+putin&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "vladimir putin",
        "putin russia",
        "vladimir putin kaliningrad defense warning"
      ],
      "search_volume": 20000,
      "started_at": "2026-10-02T03:30:00Z",
      "term": "vladimir putin"
    },
    {
      "active": false,
      "categories": [
        "Sports"
      ],
      "ended_at": "2026-10-02T12:40:00Z",
      "explore_url": "https://trends.firecrawl.dev/explore?q=steelers&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "steelers",
        "deshaun watson",
        "browns",
        "pittsburgh steelers",
        "cleveland browns",
        "steelers game",
        "browns schedule",
        "browns steelers",
        "steelers browns",
        "steelers score",
        "pittsburgh steelers vs cleveland browns match player stats",
        "pittsburgh steelers vs cleveland browns",
        "browns score",
        "browns game",
        "deshaun watson stats",
        "cleveland browns vs pittsburgh steelers",
        "jared verse",
        "jaylen warren",
        "steelers vs browns where to watch",
        "thursday night football",
        "how old is aaron rodgers",
        "tj watt",
        "aaron rodgers stats",
        "steelers schedule",
        "cleveland browns vs pittsburgh steelers match player stats",
        "tnf",
        "afc north",
        "thursday night football tonight",
        "pat freiermuth",
        "browns qb",
        "cleveland browns schedule",
        "steelers vs browns score",
        "thursday night football score",
        "where to watch pittsburgh steelers vs cleveland browns",
        "steelers depth chart",
        "thursday night football tonight live",
        "carson schwesinger",
        "andre szmyt",
        "who plays thursday night football",
        "tnf this week",
        "browns record",
        "steelers vs browns prediction",
        "browns kicker",
        "browns vs steelers score",
        "did the browns win last night",
        "browns steelers score",
        "did the browns win",
        "who won the football game last night",
        "cleveland browns score",
        "steelers - browns",
        "szmyt",
        "steelers browns score",
        "steelers game today",
        "who won the steelers game",
        "where to watch steelers game tonight",
        "grant delpit",
        "quincy williams",
        "browns standings",
        "where to watch cleveland browns vs pittsburgh steelers",
        "browns football",
        "pittsburgh steelers score",
        "browns roster",
        "did the steelers win",
        "browns vs steelers prediction",
        "pittsburgh steelers vs cleveland browns stats",
        "browns vs steelers 2026"
      ],
      "search_volume": 1000000,
      "started_at": "2026-10-02T00:00:00Z",
      "term": "steelers"
    },
    {
      "active": true,
      "categories": [
        "Sports"
      ],
      "ended_at": null,
      "explore_url": "https://trends.firecrawl.dev/explore?q=bosnia+and+herzegovina+vs+sweden&geo=US&date=now+1-d",
      "increase_percent": 1000,
      "related_queries": [
        "bosnia and herzegovina vs sweden",
        "bosnia vs sweden"
      ],
      "search_volume": 10000,
      "started_at": "2026-10-02T17:50:00Z",
      "term": "bosnia and herzegovina vs sweden"
    }
  ]
}
```
