Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$0.8 / 1k trends Pull today’s trending searches from Google Trends — keywords with traffic estimates, related news, and pictures, for 40+ countries

​
Endpoint

POST /api/v1/agents/google/trends-daily/run

​
Parameters

​
geo
string
default:"US"
Dropdown · Country to pull trends from.View all 42 options →
​
daysBack
integer
default:1
Number · How many past days of trends to fetch. Google’s Trending Now feed surfaces ~10 fresh trends per day per country, so daysBack=7 gives you ~70 historical trends, daysBack=30 gives ~300.
​
maxResults
integer
default:50
Number · Total trending searches to return (capped by daysBack × ~10/day per country). Use 0 for all available.
​
date
date
Date picker · Optional — anchor date for the trends window. Leave blank to use today.

​
Response columns

FieldDisplay nameType
displayQueryDisplay Querytext
dateDatetext
countryCountrytext
approxTrafficApprox Traffictext
trafficValueTraffic Valuenumber
scoreScorenumber
topNewsTitleTop News Titletext
topNewsUrlTop News URLurl
topNewsSourceTop News Sourcetext
picturePictureurl
newsArticleTitleNews Article Titletext
newsArticleUrlNews Article URLurl
newsArticleSourceNews Article Sourcetext
newsArticlePictureNews Article Pictureurl
timestampTimestamptext

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/google/trends-daily/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "geo": "US",
    "language": "en-US",
    "daysBack": 1,
    "maxResults": 10
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "displayQuery": "smci stock",
      "date": "2026-05-04T14:20:00.000Z",
      "country": "US",
      "approxTraffic": "500+",
      "trafficValue": 500,
      "score": 25,
      "topNewsTitle": "Super Micro (SMCI) Q1 Earnings Report Preview: What To Look For",
      "topNewsUrl": "https://finance.yahoo.com/markets/stocks/articles/super-micro-smci-q1-earnings-062855794.html",
      "topNewsSource": "Yahoo Finance",
      "picture": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSV5l3kK2arZPnF3eB4qcieUvNsf0Ja8ycDY22yz1tN0Ago1fpzPOsUfaTvlbk",
      "newsArticleTitle": null,
      "newsArticleUrl": null,
      "newsArticleSource": null,
      "newsArticlePicture": null,
      "timestamp": "2026-05-04T14:20:00.000Z"
    }
  ]
}