Crawlora
Open navigation
Sign inTry Playground Console
Docs menu

Google API endpoint

Google Trends explore data

Returns normalized Google Trends keyword analytics from internal Trends widget requests: interest over time, interest by region, related queries, and related topics when available.

POSTapiKey3 credits/requestGoogletrends.ExploreRequesttrends.exploreResponseDoc/google/trends/explore

Overview

Returns normalized Google Trends keyword analytics from internal Trends widget requests: interest over time, interest by region, related queries, and related topics when available.

View Google Search platform pageOpen in PlaygroundCopy language examples

Request schema

NameInTypeRequiredEnumExampleDescription
requestbodyobjectYesExplore request
x-api-keyheaderstringYesAPI key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost
3 credits/request
Charged response
Successful 2xx responses
PlanPriceIncluded creditsDaily capRate limitOverage
Free$0/mo2,000500 daily credits5/minNo overage
Starter$9/mo20,0005,000 daily credits15/min$0.75/1,000 overage credits when enabled
Growth$29/mo100,00025,000 daily credits45/min$0.45/1,000 overage credits when enabled
Pro$79/mo400,000No daily cap120/min$0.30/1,000 overage credits
Business$199/mo1,200,000No daily cap300/min$0.20/1,000 overage credits
Enterprise$499/mo5,000,000No daily cap1,000/min$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

  • Proxy strategy: managed automatically where needed
  • Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
  • Browser cluster: supported dynamic workloads can be routed through distributed browser instances
  • Retry behavior: automatic retry/fallback may be used depending on endpoint type
  • Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
  • Billing: credits are charged only for successful 2xx responses
  • Observability: responses include request context where available

Browser cluster behavior

Some targets require real browser execution because the data is loaded through JavaScript, dynamic rendering, or interaction-like browser behavior.

For supported endpoints, Crawlora can route requests through a managed browser cluster. This allows Crawlora to execute JavaScript, load dynamic content, apply browser-level request behavior, and normalize the rendered result into JSON.

You do not need to operate your own Playwright, Puppeteer, Chrome, proxy, queue, or retry infrastructure.

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

StatusCommon failure case
400Invalid input or missing required parameter
429Plan or endpoint rate limit exceeded
500Internal execution error
502Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Failure responses

StatusDescriptionSchema
400Invalid input#/definitions/app.Response
429Rate limit exceeded#/definitions/app.Response
500Internal server error#/definitions/app.Response
502Google Trends upstream request failed#/definitions/app.Response

Request body example

{
  "category": 0,
  "geo": "US",
  "hl": "en-US",
  "keywords": [
    "chatgpt",
    "openai"
  ],
  "property": "",
  "time_range": "today 12-m",
  "type": "web",
  "tz": 0
}

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "keywords": [
      "chatgpt"
    ],
    "geo": "US",
    "time_range": "today 12-m",
    "type": "web",
    "interest_over_time": [
      {
        "time": "1777075200",
        "formatted_time": "Apr 2026",
        "values": [
          {
            "keyword": "chatgpt",
            "value": 87,
            "formatted_value": "87",
            "has_data": true
          }
        ]
      }
    ],
    "top_queries": [
      {
        "keyword": "chatgpt",
        "items": [
          {
            "query": "chatgpt login",
            "value": 100,
            "formatted_value": "100"
          }
        ]
      }
    ],
    "rising_queries": [
      {
        "keyword": "chatgpt",
        "items": [
          {
            "query": "chatgpt alternatives",
            "formatted_value": "Breakout"
          }
        ]
      }
    ]
  }
}

Request schema

#/definitions/trends.ExploreRequest

FieldTypeRequiredEnumBoundsExampleDescription
categoryintegerNo0
geostringNoWORLDWIDE, 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, CV, BQ, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, CI, HR, CU, CW, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, XK, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, KP, MK, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, KR, SS, ES, LK, BL, SH, KN, LC, MF, PM, VC, SD, SR, SJ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UM, VI, UG, UA, AE, GB, US, UY, UZ, VU, VA, VE, VN, WF, EH, YE, ZM, ZWUS
hlstringNoen-US
keywordsarrayNochatgpt,openai
propertystringNo
time_rangestringNonow 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 1-y, today 5-y, alltoday 12-m
typestringNoweb, image, news, youtube, shoppingweb
tzintegerNo0

Response schema

#/definitions/trends.exploreResponseDoc

FieldTypeRequiredEnumBoundsExampleDescription
codeintegerNo200
datatrends.ExploreResponseNo
data.categoryintegerNo0
data.geostringNoUS
data.hlstringNoen-US
data.interest_by_regionarrayNo
data.interest_by_region[].geo_codestringNoUS-CA
data.interest_by_region[].geo_namestringNoCalifornia
data.interest_by_region[].valuesarrayNo
data.interest_by_region[].values[].formatted_valuestringNo87
data.interest_by_region[].values[].has_databooleanNotrue
data.interest_by_region[].values[].keywordstringNochatgpt
data.interest_by_region[].values[].valueintegerNo87
data.interest_over_timearrayNo
data.interest_over_time[].formatted_axis_timestringNoApr 2026
data.interest_over_time[].formatted_timestringNoApr 2026
data.interest_over_time[].timestringNo1777075200
data.interest_over_time[].valuesarrayNo
data.interest_over_time[].values[].formatted_valuestringNo87
data.interest_over_time[].values[].has_databooleanNotrue
data.interest_over_time[].values[].keywordstringNochatgpt
data.interest_over_time[].values[].valueintegerNo87
data.keywordsarrayNo
data.propertystringNo
data.related_queriesarrayNo
data.related_queries[].itemsarrayNo
data.related_queries[].items[].formatted_valuestringNo100
data.related_queries[].items[].linkstringNo/trends/explore?q=chatgpt
data.related_queries[].items[].querystringNochatgpt login
data.related_queries[].items[].topic_midstringNo/g/11khcfz0y2
data.related_queries[].items[].topic_titlestringNoChatGPT
data.related_queries[].items[].topic_typestringNoTopic
data.related_queries[].items[].valueintegerNo100
data.related_queries[].keywordstringNochatgpt
data.related_topicsarrayNo
data.related_topics[].itemsarrayNo
data.related_topics[].items[].formatted_valuestringNo100
data.related_topics[].items[].linkstringNo/trends/explore?q=chatgpt
data.related_topics[].items[].querystringNochatgpt login
data.related_topics[].items[].topic_midstringNo/g/11khcfz0y2
data.related_topics[].items[].topic_titlestringNoChatGPT
data.related_topics[].items[].topic_typestringNoTopic
data.related_topics[].items[].valueintegerNo100
data.related_topics[].keywordstringNochatgpt
data.rising_queriesarrayNo
data.rising_queries[].itemsarrayNo
data.rising_queries[].items[].formatted_valuestringNo100
data.rising_queries[].items[].linkstringNo/trends/explore?q=chatgpt
data.rising_queries[].items[].querystringNochatgpt login
data.rising_queries[].items[].topic_midstringNo/g/11khcfz0y2
data.rising_queries[].items[].topic_titlestringNoChatGPT
data.rising_queries[].items[].topic_typestringNoTopic
data.rising_queries[].items[].valueintegerNo100
data.rising_queries[].keywordstringNochatgpt
data.time_rangestringNotoday 12-m
data.top_queriesarrayNo
data.top_queries[].itemsarrayNo
data.top_queries[].items[].formatted_valuestringNo100
data.top_queries[].items[].linkstringNo/trends/explore?q=chatgpt
data.top_queries[].items[].querystringNochatgpt login
data.top_queries[].items[].topic_midstringNo/g/11khcfz0y2
data.top_queries[].items[].topic_titlestringNoChatGPT
data.top_queries[].items[].topic_typestringNoTopic
data.top_queries[].items[].valueintegerNo100
data.top_queries[].keywordstringNochatgpt
data.typestringNoweb
data.tzintegerNo0
msgstringNoOK

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

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}'

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

Related

More Google endpointsGoogle Search platformPricingPlayground
Open in PlaygroundBack to group