{"uid":"cap_ms22xyVFtByyuAjzfexCP","slug":"google-trends-scraper-api-x402-7874166c","name":"Google Trends Scraper API (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_Xl4YSS05_9i4BDxMDxv82","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 search volumes, growth percentages, related queries, and current trending searches — for specified terms or geographies, billed per successful call via x402.","exampleAgentPrompt":"Pull Google Trends data for 'plant-based protein' and 'whey protein' in the US over the last 12 months in explore mode, including related queries, and cap results at 100 items.","exampleUseCases":[{"title":"Track rising keyword for SEO strategy","prompt":"Get Google Trends explore data for 'AI writing tools' and 'ChatGPT alternatives' in the US over the past 12 months — I want to see search volumes, growth percentages, and related queries to decide which term to target."},{"title":"Monitor what's trending nationally today","prompt":"What are the top 50 trending searches on Google in the UK right now? Use trending mode so I get today's current searches, not historical keyword data."},{"title":"Compare competitor brand search interest","prompt":"Compare Google search interest for 'Notion', 'Obsidian', and 'Roam Research' in the US over the last 5 years using explore mode — I need growth percentages and related queries for each."}],"resultDescription":"Returns a JSON object with a count of records and an array of items, each containing fields such as searchTerm, searchVolume, growthPercent, relatedQueries, geoCode, recordType, startedAt, and inputUrlOrTerm. Also includes a product identifier ('google-trends'). Failed or empty runs are not charged.","failureModes":["Empty result set if search terms have no data for the selected geo/time range (not charged)","Rate limiting or blocking by Google may cause failed scrape (not charged)","Invalid geo code returns an error or empty dataset","More than 5 search terms in a single Explore comparison may be rejected","customTimeRange format mismatch (not YYYY-MM-DD YYYY-MM-DD) causes validation error","Payment failure via x402 prevents the call from executing"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Google Trends data — including historical keyword interest, growth metrics, and related queries — without managing a browser or scraper yourself. It is especially useful for agents doing SEO research, market trend analysis, or competitive keyword benchmarking. The pay-per-successful-call model (no charge for empty/failed runs) makes it cost-efficient for exploratory queries. Prefer this over general web search APIs when you specifically need Google Trends signals, volume history, or trending topic lists by geography.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:16.613Z","isFirstParty":false,"canonicalSlug":"google-trends-scraper-api-x402-7874166c"}