API Reference
Use a Google Trends API to extract trending terms, interest over time, interest by region, and related queries as structured JSON for demand research. 11 endpoints documented below.
curl -X POST "https://api.crawlora.net/api/v1/google/trends/explore" \
-H "x-api-key: $CRAWLORA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category":0,"geo":"US","hl":"en-US","keywords":["chatgpt","openai"],"property":"","time_range":"today 12-m","type":"web","tz":0}'Crawlora's Google Trends endpoints replay the public Trends widget and Trending Now flows as JSON. Explore: POST /google/trends/explore returns interest over time, interest by region, related queries and related topics for one or more terms in one call, and /google/trends/explore/interest-over-time, /google/trends/explore/interest-by-region, /google/trends/explore/related-topics, /google/trends/explore/top-queries and /google/trends/explore/rising-queries return one widget each. Trending Now: GET /google/trends/trending with geo, hl, tz, window, time_range, category and status, and POST /google/trends/trending/detail for one term. /google/trends/locations, /google/trends/categories and /google/trends/enums list the accepted filter values, and /google/suggest returns Google autosuggest completions.
GET /google/trends/locations for geo codes (Explore also accepts WORLDWIDE), /google/trends/categories for category ids, and /google/trends/enums for date ranges, search types, statuses and sort modes. Pass these as the request object's fields rather than guessing strings.
POST /google/trends/explore with the request object: terms (one or several for comparison), geo, time range and category. The response bundles interest over time, interest by region, related queries and related topics. Use the single-widget routes when you only need one of them; rising-queries and top-queries return empty arrays when Google has no rows.
GET /google/trends/trending?geo=US&hl=en&window=<hours>&category=<id> for the current trending rows, then POST /google/trends/trending/detail with a term for its interest over time, regional interest and related queries. Store rows per run; trending is a stream, not a table.
GET /google/suggest?q=<prefix>&country=us&lang=en returns Google autosuggest completions, which is the cheapest way to enumerate the phrasings people actually type before you explore them.
/google/trends/categoriesapiKey1 credit/requestReturns the top-level Google Trends categories as id and name pairs, such as 0 for All and 20 for Sports. These are the ids accepted by the Trending Now category filter.
Takes no parameters.
Sampled 14 Oct 2026: 26 items. Filled in every item: id, name. In the sample: name: “All” and 25 other values.
/google/trends/enumsapiKey0 credits/requestReturns supported Google Trends enum values for explore/trending filters, including locations, date ranges, search types, categories, statuses, and sort modes.
Takes no parameters.
Sampled 14 Oct 2026: 7 fields returned with a value. In the sample: explore_time_ranges: 9 entries; trending_time_ranges: 4 entries; search_types: 5 entries; locations: 251 entries; trending_categories: 26 entries; trend_statuses: 3 entries; trending_sort_bys: 4 entries.
/google/trends/exploreapiKey3 credits/requestReturns Google Trends keyword analytics: interest over time, interest by region, related queries, and related topics when available.
Required: request.
Sampled 14 Oct 2026: 53 items. Filled in every item: time, formatted_time, formatted_axis_time, values. In the sample: time: 1,760,227,200 to 1,791,676,800, median 1,775,952,000; formatted_time: “Oct 12 – 18, 2025” and 52 other values; values: median 1 entry; formatted_axis_time: “Oct 12, 2025” and 52 other values.
/google/trends/explore/interest-by-regionapiKey2 credits/requestReturns only the interest-by-region widget from the Google Trends Explore widget flow. Supports multiple comparison terms and returns an empty interest_by_region array when Google returns no rows.
Required: request.
Sampled 14 Oct 2026: 51 items. Filled in every item: geo_code, geo_name, values. In the sample: geo_name: “California” and 50 other values; values: median 1 entry.
/google/trends/explore/interest-over-timeapiKey2 credits/requestReturns Google Trends interest over time for 1 to 5 `keywords`. Optional inputs are `geo` (default worldwide), `time_range` (default `today 12-m`), `hl`, `tz`, `category` and `type` (`web`, `image`, `news`, `youtube` or `shopping`). Each time point carries a value per keyword, with a `has_data` flag.
Required: request.
Sampled 14 Oct 2026: 53 items. Filled in every item: time, formatted_time, formatted_axis_time, values. In the sample: time: 1,760,227,200 to 1,791,676,800, median 1,775,952,000; formatted_time: “Oct 12 – 18, 2025” and 52 other values; values: median 2 entries; formatted_axis_time: “Oct 12, 2025” and 52 other values.
/google/trends/explore/related-topicsapiKey2 credits/requestReturns only the related topics widget from the Google Trends Explore widget flow. Returns an empty related_topics array when Google returns no topic rows for the requested term/filter combination.
Required: request.
Sampled 14 Oct 2026: 7 fields returned with a value, 1 empty (related_topics). In the sample: tz: 0; geo: “US”; keywords: 1 entry; time_range: “today 12-m”; hl: “en-US”; category: 0; type: “web”.
/google/trends/explore/rising-queriesapiKey2 credits/requestReturns the Rising related queries widget for one or more Google Trends explore terms. Returns an empty queries array when Google returns no rows for the requested term/filter combination.
Required: request.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: tz: 0; geo: “HK”; keywords: 1 entry; time_range: “today 12-m”; hl: “en-US”; category: 0; type: “web”; query_type: “rising”.
/google/trends/explore/top-queriesapiKey2 credits/requestReturns the Top related queries widget for one or more Google Trends explore terms. Returns an empty queries array when Google returns no rows for the requested term/filter combination.
Required: request.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: tz: 0; geo: “HK”; keywords: 1 entry; time_range: “today 12-m”; hl: “en-US”; category: 0; type: “web”; query_type: “top”.
/google/trends/locationsapiKey1 credit/requestReturns the list of location codes that Google Trends supports, such as `US`, `HK` and `GB`, in `locations`. The Explore endpoints also accept `WORLDWIDE`, which appears in the list. It takes no parameters.
Takes no parameters.
/google/trends/trendingapiKey2 credits/requestReturns Google Trends Trending Now for a country or territory (`geo`, default `US`): each trend's query, rank, search traffic, status, start and update time, related terms and news articles, with explore and share links. Filter by time window, category and status, and choose the sort order.
Optional: geo (250 allowed values, including AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, KH, CM, CA), hl, tz, window (4 allowed values: 4h, 24h, 48h, 7d), time_range (4 allowed values: 4h, 24h, 48h, 7d), category (26 allowed values: 0, 3, 47, 44, 22, 12, 5, 7, 71, 8, 45, 65, 11, 13, 958, 19, 16, 299, 14, 66, 29, 533, 174, 18, 20, 67), status (3 allowed values: all, active, ended), sort_by (4 allowed values: relevance, title, recency, search_volume), limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: rank, title, query, traffic, status. In the sample: rank: 1 to 20, median 10; title: “rj mitte” and 19 other values; query: “rj mitte” and 19 other values; traffic: “rj mitte cause of death” and 19 other values.
/google/trends/trending/detailapiKey3 credits/requestReturns the Explore detail widgets for a single trending term, including interest over time, regional interest, top/rising related queries, and related topics when Google returns them.
Required: request.
Sampled 14 Oct 2026: 53 items. Filled in every item: time, formatted_time, formatted_axis_time, values. In the sample: time: 1,760,227,200 to 1,791,676,800, median 1,775,952,000; formatted_time: “Oct 12 – 18, 2025” and 52 other values; values: median 1 entry; formatted_axis_time: “Oct 12, 2025” and 52 other values.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Google Trends categories | GET /google/trends/categories | 100% | 0.14 s |
| Google Trends enum metadata | GET /google/trends/enums | 100% | 0.16 s |
| Google Trends explore data | POST /google/trends/explore | 100% | 1.97 s |
| Google Trends interest by region | POST /google/trends/explore/interest-by-region | 100% | 0.83 s |
| Google Trends interest over time | POST /google/trends/explore/interest-over-time | 100% | 1.42 s |
| Google Trends related topics | POST /google/trends/explore/related-topics | 100% | 0.78 s |
| Google Trends explore rising queries | POST /google/trends/explore/rising-queries | 100% | 1.72 s |
| Google Trends explore top queries | POST /google/trends/explore/top-queries | 100% | 1.58 s |
| Google Trends locations | GET /google/trends/locations | 100% | 0.19 s |
| Google Trends trending now data | GET /google/trends/trending?category=0&geo=HK&hl=en-US&limit=10&sort_by=relevance&status=all&time_range=24h | 100% | 0.85 s |
| Google Trends trending term detail | POST /google/trends/trending/detail | 100% | 1.89 s |