# FastAF Google Trends API

> FastAF Google Trends API is a paid API for AI agents from api.fastaf.co, paid per call via x402, $0.005/call, status down (last checked 2026-10-31).

Returns Google Trends interest-over-time or by-region data for one or more search terms as structured JSON timeline data.

## Facts

- Endpoint: GET https://api.fastaf.co/x402/v1/trends?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fastaf-google-trends-api-df8e0485
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u4aalQKCjyooPIAV_bk_N

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 fastaf-google-trends-api-df8e0485
```

Example prompt: Can you pull Google Trends data for 'electric vehicles' and 'hybrid cars' in the US over the past 12 months so I can compare their search interest?

## When to prefer this

Choose this endpoint when you need programmatic access to Google Trends interest data — either over time or by geographic region — for one or more search terms, especially when you want JSON-formatted output ready for analysis, visualization, or downstream processing. It supports comparison of up to 5 terms, multiple search properties (web, YouTube, news, images, shopping), flexible date ranges, and regional granularity down to city level.

## Known failure modes

- Invalid or unsupported region code returns an error or empty data
- More than 5 comma-separated query terms exceeds upstream Google Trends limit
- Invalid date range format causes a 400 or empty response
- Empty geo value (instead of omitting it) may cause upstream errors
- Unknown category ID returns default all-categories data or an error
- Payment not settled if request fails — 5 credits only charged on success

## How this service works

Google Trends interest over time or by region for one or more terms, as JSON timeline data. 5 credits ($0.005000 USDC) for this request; failed requests are never settled.

## Output

A JSON object containing interest_over_time with timeline_data arrays, each entry including a date range and per-query interest values (0-100 scale), and optionally regional breakdown data with geographic interest scores per query term.

## Request schema (JSON Schema)

```json
{
 "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",
     "properties": {
      "tz": {
       "type": "integer",
       "maximum": 1439,
       "minimum": -1439,
       "description": "Timezone offset in minutes, integer -1439 to 1439; upstream default 420 (UTC-07:00). Positive values are west of UTC, negative east; 0 is UTC. No option surcharge; 5 credits per successful request."
      },
      "cat": {
       "type": "string",
       "maxLength": 8192,
       "description": "Google Trends numeric category ID as a string; default 0 includes all categories. No option surcharge; 5 credits per successful request."
      },
      "geo": {
       "type": "string",
       "maxLength": 8192,
       "description": "Google Trends region code, e.g. US or US-CA. Omit for worldwide interest; do not send an empty value. No option surcharge; 5 credits per successful request."
      },
      "date": {
       "type": "string",
       "maxLength": 8192,
       "description": "Trend 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. Hour ranges use YYYY-MM-DDThh within one week. Omitted: upstream default range. No option surcharge; 5 credits per successful request."
      },
      "gprop": {
       "enum": [
        "images",
        "news",
        "froogle",
        "youtube"
       ],
       "type": "string",
       "description": "Search property: images, news, froogle (Shopping) or youtube. Omit for Web Search. No option surcharge; 5 credits per successful request."
      },
      "query": {
       "type": "string",
       "maxLength": 8192,
       "description": "Comma-separated Google Trends terms or topic IDs, e.g. coffee,tea or /m/027lnzs. Upstream supports up to 5 terms (100 characters each) for TIMESERIES/GEO_MAP and one for GEO_MAP_0. No default term. No option surcharge; 5 credits per successful request."
      },
      "region": {
       "enum": [
        "COUNTRY",
        "REGION",
        "DMA",
        "CITY"
       ],
       "type": "string",
       "description": "Regional aggregation for GEO_MAP/GEO_MAP_0: COUNTRY, REGION,
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "interest_over_time": {
   "timeline_data": [
    {
     "date": "Oct 5 - 11, 2026",
     "values": [
      {
       "query": "web scraping api",
       "value": 72
      }
     ]
    }
   ]
  }
 }
}
```

## More

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