{"uid":"cap_3wIU-CEg_wvh_qOCnqxY0","slug":"google-trends-scraper-via-scrapeforagents-f75a17d7","name":"Google Trends Scraper via ScrapeForAgents","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/google-trends?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CsPNcW4nL8omOZIUOCAQK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured Google Trends data including trending searches, keyword interest over time, related queries, and growth metrics for specified terms and geographies.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"SEO keyword opportunity research","prompt":"What's the search interest trend for 'plant-based protein' and 'vegan supplements' in the US over the past 5 years? Use explore mode and give me up to 100 results with related queries so I can figure out which term is gaining more momentum."},{"title":"Trending news topics monitoring","prompt":"What are the top 50 currently trending searches in the UK right now? Use trending mode so I get live results, not historical keyword data."},{"title":"Market entry research by country","prompt":"Compare Google Trends interest for 'electric scooter' in Germany over the past 3 months using explore mode, category 0, and give me up to 100 records including growth percent so I can assess market appetite."}],"resultDescription":"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'.","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:13.568Z","isFirstParty":false,"canonicalSlug":"google-trends-scraper-via-scrapeforagents-f75a17d7"}