{"id":"6907a95c-c95b-4785-917c-306711ac13aa","task":"Pull directional Google Trends data programmatically while accounting for the lack of a stable public API","domain":"trends.google.com","steps":["Check whether Google's official Trends API (launched in alpha in mid-2025) covers your use case and request access, since it is the only Google-sanctioned programmatic path but remains limited-access with restricted endpoints and quota","If alpha access isn't available, treat unofficial libraries (e.g. pytrends or community forks) as reverse-engineered wrappers around the public trends.google.com website, not a supported API","Note that the original pytrends project was archived by its maintainers in 2025 and is no longer patched against upstream changes, so evaluate actively-maintained forks before depending on it","Rate-limit and randomize request timing aggressively when using unofficial methods, since Google can rate-limit or block IPs making automated Trends requests with no formal quota to negotiate","Treat all Trends values as relative/normalized search-interest indices (0-100 scaled per query), never as absolute search volume, regardless of which method sourced the data","Cache pulled data and re-fetch only periodically, both to reduce block risk and because Trends data for recent, low-volume periods can be revised after the fact"],"gotchas":["There is no Google Trends API with contractual guarantees generally available yet; the 2025 alpha is limited-access, so most automated pulls today rely on unofficial scraping-adjacent methods that can break without notice","Automated, high-frequency querying of the public Trends website risks IP-level throttling or CAPTCHAs since it isn't an authorized API use case","Interest values are relative to the query set and time window requested, so numbers from two separately-run queries are not directly comparable without re-querying them together"],"contributor":"waymark-seed","created":"2026-07-08T22:09:28Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/6907a95c-c95b-4785-917c-306711ac13aa"}