What it returns
Get **Google Trends** data for any keyword, with no rate-limit headaches: - **Interest over time** (0–100), for any range from the past hour to 2004 onwards - **Interest by region**: countries, or states/regions inside a country - **Related queries and topics**, both *top* and *rising* (breakout terms) - **Trending now**: today's trending searches per country, with approximate traffic and news links - **Compare up to 5 terms** on a shared scale, exactly like the Trends website - Filter by **country/region**, **category** and **search property** (Web, Images, News, Shopping, YouTube)
Common uses
SEO and content planning, product and market research, seasonality analysis, ad timing, investment and brand-tracking signals, and newsjacking with *Trending now*.
Request
POST https://api.pushbuild.com/google-trends/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
searchTerms | list of strings | Keywords or phrases to get Google Trends data for. |
geo | string | Two-letter country code (US, GB, DE…) or a sub-region like US-CA. Leave empty for worldwide. Default: "US". |
timeframe | string: 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 | Period to fetch. You can also type a custom range like '2025-01-01 2025-06-30' via the API. Default: "today 12-m". |
compareTogether | boolean | Fetch up to 5 terms in one comparison, so their values share one 0–100 scale (like the Trends website). Off: each term is scaled on its own. Default: false. |
includeRegions | boolean | Include interest broken down by country or state. Default: true. |
includeRelated | boolean | Include top and rising related queries and topics. Default: true. |
category | integer | Google Trends category ID (0 = all categories). Default: 0. |
property | string: , images, news, froogle, youtube | Which Google search property to use. Default: "". |
trendingNowGeos | list of strings | Also get today's trending searches, with traffic and news links, for these country codes (e.g. US, GB). |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/google-trends/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"searchTerms": ["chatgpt", "claude"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.80 per 1,000 trending searchs · $2.40 per 1,000 search terms. No charge for errors or empty searches.
Related APIs
Bulk SEO Audit & PageSpeed / Core Web Vitals Checker API
Audit any list of URLs: Lighthouse performance, SEO, accessibility and best-practice scores, real-user Core Web Vitals (LCP, INP, CLS), speed opportunities, and on-page SEO checks (title, meta description, H1, canonical, alt text, sitemap, robots, schema)..
FEC Campaign Finance (Candidates, PACs, Contributions) API
US federal campaign finance from official FEC bulk data: candidate receipts, spending, cash on hand and debts; PAC, super PAC and party committee totals; PAC and party contributions and independent expenditures for or against candidates.
Federal Register API
Search every Federal Register document since 1994: final and proposed rules, notices, executive orders and presidential documents, by keyword, agency, type, date and CFR part.
Google News Scraper API
Fast Google News results for any keyword, topic or country: title, source, publish time, snippet and link.
Hacker News Scraper API
Search every Hacker News story and comment by keyword, date and points, or pull the live Top, New, Best, Ask, Show and Jobs feeds.
Telegram Channel Posts Scraper API
Scrape posts from any public Telegram channel: text, date, views, links, photos, videos and forwards.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com