Real questions from real users.
What exactly does TrendProof do?
TrendProof is a trend intelligence API built for AI agents. You send a keyword, and it returns a velocity score (% growth over the last 4 weeks), estimated peak window, real search volume, CPC, CPM, and an action hint like "publish now" or "monitor".
Under the hood it fuses Google Trends with DataForSEO keyword data and filters out seasonal noise. The result is actionable signal — not raw charts you have to interpret yourself.
How does it integrate with my AI agent?
One REST call. Your agent sends a POST request to trendproof.dev/api/analyze with your API key and a keyword. It gets back structured JSON — velocity, peak window, search volume, CPC, CPM, action hint. No parsing, no scraping, no glue code.
Works with any agent framework: ChatGPT function calling, Claude tool use, LangChain, LlamaIndex, n8n, custom Python bots — anything that can make an HTTP request. Setup takes about 5 minutes.
What's the difference between the free self-hosted version and Pro?
The self-hosted version (free, open-source) gives you Google Trends data and velocity scoring. You run it on your own machine, manage your own Google API quota, and set up the pipeline yourself. Great for experimenting or low-volume use.
Pro adds DataForSEO integration (real search volume, CPC, keyword difficulty), a managed hosted API you can call without running anything, higher rate limits, daily digests delivered to email or Telegram, and priority support. You get an API key instantly — no infra, no setup.
What is a velocity score and how is it calculated?
Velocity is a percentage showing how much a keyword's interest has grown over the last 4 weeks. +80%+ means the keyword is moving unusually fast — typical peak window is 3–7 days. Negative values mean declining interest.
The calculation combines: relative interest growth rate from Google Trends and search volume momentum from DataForSEO, with seasonality correction (so "Black Friday" doesn't spike every November as a "new trend").
What does "peak window" mean? Is it accurate?
The peak window is an estimated time range during which the trend is likely to reach its highest interest — based on historical shape of similar trend curves. It's a probabilistic estimate, not a guarantee.
Accuracy depends on the trend type. For fast-moving tech and news-driven topics, the model tends to be accurate within 1–2 days. For slower-moving consumer trends, the window is wider. Think of it as "act in this window to catch the wave" rather than a precise countdown.
Which data sources does TrendProof use? What is CPC and CPM?
Self-hosted / Free: Google Trends only — relative interest index, geographic breakdown, related queries.
Pro: Google Trends + DataForSEO. This adds:
— Search volume: actual monthly searches for the keyword
— CPC (Cost Per Click): average advertiser bid in Google Ads. High CPC = high commercial intent = someone is making money in this niche. A keyword with CPC $8+ is usually worth creating content for.
— CPM (Cost Per 1,000 Impressions): display ad market rate. Useful for estimating monetization potential of traffic.
— Keyword difficulty: how hard it is to rank organically
Together these give you both direction (is it rising?) and commercial context (is anyone paying to be here?).
Enterprise: All of the above, plus Reddit and X/Twitter signal analysis.
Can I use Pay as you go instead of a subscription?
Yes. If you don't want a monthly subscription, you can buy trend checks in credit packs. The rate is $0.02 per check — slightly higher than Pro's effective per-check cost, but with zero monthly commitment.
Credit packs don't expire. Good for sporadic use, prototyping, or when your volume varies significantly month to month.
How do I self-host TrendProof?
Clone the
trends-checker repo from GitHub. The README has a full setup guide — takes about 10 minutes. You'll need Python 3.10+, a Google account for Trends access, and optionally a DataForSEO key if you want keyword volume data.
The self-hosted version is identical to the Pro engine for Google Trends processing. The only things you miss are: managed hosting, DataForSEO integration, automatic digests, and the hosted API endpoint.
Is there a rate limit on the API?
Pro plan includes 100 trend checks per month — enough for an agent running daily keyword monitoring across your key niches. Each "check" is one keyword: velocity (%), search volume, CPC, CPM, peak window, and action hint.
Need more? Use Pay as you go credits ($0.20/check) to top up without changing your plan, or upgrade to Enterprise for custom volume pricing.
What's the Enterprise plan actually for?
Enterprise is designed for teams running multiple agents across different niches, or businesses that need high-volume trend monitoring as part of a production pipeline.
It includes: unlimited checks, dedicated infrastructure (your requests don't share quota with other users), custom niche configurations, webhook delivery to your own endpoints, SLA with guaranteed uptime, and a dedicated support channel. Pricing is negotiated based on volume.