{"uid":"cap_u4aalQKCjyooPIAV_bk_N","slug":"fastaf-google-trends-api-df8e0485","name":"FastAF Google Trends API","description":"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.","url":"https://api.fastaf.co/x402/v1/trends?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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, DMA (metro) or CITY. Omit for source-default resolution; availability depends on geo. No option surcharge; 5 credits per successful request."},"language":{"type":"string","maxLength":8192,"description":"Result/interface language code, e.g. en, es, fr or de; default en. Use lr, where supported, to restrict document languages. No option surcharge; 5 credits per successful request."},"data_type":{"enum":["TIMESERIES","GEO_MAP","GEO_MAP_0"],"type":"string","default":"TIMESERIES","description":"Trend view: TIMESERIES (default) for interest over time, GEO_MAP for regional comparison of multiple terms, or GEO_MAP_0 for one term by region. No option surcharge; 5 credits per successful request."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"interest_over_time":{"type":"object","properties":{"timeline_data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"values":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"value":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true}}},"additionalProperties":true}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"interest_over_time":{"timeline_data":[{"date":"Oct 5 - 11, 2026","values":[{"query":"web scraping api","value":72}]}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hL3-9l58cM-Q_nK9dKNBU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Google Trends interest-over-time or by-region data for one or more search terms as structured JSON timeline data.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Competitor brand interest comparison","prompt":"Get me Google Trends interest over the last 5 years for 'Pepsi' and 'Coca-Cola' worldwide so I can see how their search popularity has shifted."},{"title":"Regional keyword demand research","prompt":"Pull Google Trends data for 'solar panels' broken down by US state for the past 3 months — I want to see which regions have the most search interest."},{"title":"YouTube trend tracking for content planning","prompt":"Check Google Trends for 'vegan recipes' and 'keto diet' on YouTube search over the past year — I want to know which topic has been more popular for video content."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T13:58:34.767Z","isFirstParty":false,"canonicalSlug":"fastaf-google-trends-api-df8e0485"}