# Google Trends Scraper via ScrapeForAgents

> Google Trends Scraper via ScrapeForAgents is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Fetches structured Google Trends data including trending searches, keyword interest over time, related queries, and growth metrics for specified terms and geographies.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/google-trends?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-trends-scraper-via-scrapeforagents-f75a17d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3wIU-CEg_wvh_qOCnqxY0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-trends-scraper-via-scrapeforagents-f75a17d7 -d '<json body>'
```

Example prompt: Pull Google Trends data for the search terms 'ChatGPT' and 'OpenAI' in the US over the past 12 months using explore mode, with a max of 100 results, and show me growth percent and related queries.

## When to prefer this

Choose this endpoint when you need structured, pay-per-success Google Trends data without managing scraping infrastructure. Ideal for agents doing keyword research, trend monitoring, competitive analysis, or content strategy where structured JSON output with growth metrics and related queries is required. Prefer over raw scraping solutions because failed or empty runs incur no charge.

## Known failure modes

- Empty result set if search terms return no data for the specified region or time range (not charged)
- Invalid country code in 'geo' field returns error or empty results
- More than 5 search terms in a single comparison may be rejected or truncated
- Invalid customTimeRange format (not YYYY-MM-DD YYYY-MM-DD) causes parsing failure
- Category filter mismatch with explore mode may return zero results
- Rate limiting or upstream Google Trends unavailability may cause failed runs (not charged)

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count and an array of items, each containing: geoCode, startedAt timestamp, recordType (trending or explore), searchTerm, searchVolume, growthPercent, inputUrlOrTerm, and relatedQueries. The product field confirms 'google-trends'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "geo": {
   "type": "string",
   "default": "US",
   "description": "Two letter country code for trends, such as US, GB, or CA."
  },
  "mode": {
   "enum": [
    "auto",
    "trending",
    "explore"
   ],
   "type": "string",
   "default": "auto",
   "description": "Auto uses Explore for terms or URLs, and current trending searches otherwise. Choose trending to filter the current list by search terms."
  },
  "category": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Numeric Trends category filter for Explore results; 0 means all categories."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum dataset records across all terms or current trends. Zero means no cap."
  },
  "startUrls": {
   "type": "array",
   "description": "Optional Explore links; their query, country, dates, category, and search property override the corresponding fields."
  },
  "timeRange": {
   "enum": [
    "today 1-m",
    "today 3-m",
    "today 12-m",
    "today 5-y",
    "all"
   ],
   "type": "string",
   "default": "today 12-m",
   "description": "Explore time window. Used only for keyword history."
  },
  "searchTerms": {
   "type": "array",
   "description": "Terms to research in Explore mode, up to five per comparison. In trending mode these filter current trend names."
  },
  "customTimeRange": {
   "type": "string",
   "description": "Optional Explore range in YYYY-MM-DD YYYY-MM-DD format; overrides timeRange."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "geoCode": null,
    "startedAt": null,
    "recordType": null,
    "searchTerm": null,
    "searchVolume": null,
    "growthPercent": null,
    "inputUrlOrTerm": null,
    "relatedQueries": null
   }
  ],
  "product": "google-trends"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-trends-scraper-via-scrapeforagents-f75a17d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)