Google Trends Scraper

Receiving Google Trends Results

Poll this endpoint to retrieve the result of a submitted Google Trends scraping task.

Endpoint

GET /api/parsing/v1/result/google-trends/{requestId}

Keep polling until status is no longer "parsing".

Path Parameters

Name	Type	Required	Description
requestId	string (uuid)	yes	Task ID returned from the submit endpoint

Example Request

curl https://app.scrapering.com/api/parsing/v1/result/google-trends/YOUR_REQUEST_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

Responses

In progress — task is still being processed:

{
  "status": "parsing"
}

Ready — task completed successfully. Only the datasets listed in the request type array are present:

{
  "data": {
    "input": {
      "q": "iphone",
      "hl": "en-US",
      "tz": 0,
      "cat": 0,
      "geo": "US",
      "date": "today 1-m",
      "type": ["periods", "geo", "queries", "autocomplete"],
      "gprop": "",
      "resolution": null,
      "original_url": "https://trends.google.com/explore?q=iphone&date=today%201-m&hl=en-US&geo=US"
    },
    "autocomplete": [
      { "mid": "/m/027lnzs", "type": "Mobile phone", "title": "iPhone" },
      { "mid": "/g/11jd9g0sn8", "type": "Mobile phone", "title": "IPhone 12" },
      { "mid": "/g/11fmzcj1r3", "type": "Mobile phone", "title": "iPhone 11" }
    ],
    "interestOverTime": [
      { "time": "2026-08-28T00:00:00.000Z", "value": 41 },
      { "time": "2026-08-29T00:00:00.000Z", "value": 44 },
      { "time": "2026-09-09T00:00:00.000Z", "value": 100 }
    ],
    "interestByGeo": [
      { "value": 100, "geoCode": "US-KS", "geoName": "Kansas" },
      { "value": 57, "geoCode": "US-CA", "geoName": "California" },
      { "value": 56, "geoCode": "US-NY", "geoName": "New York" }
    ],
    "relatedQueries": {
      "top": [
        { "query": "iphone 18", "value": 100 },
        { "query": "iphone 18 pro", "value": 51 },
        { "query": "iphone 17", "value": 49 }
      ],
      "rising": [
        { "query": "iphone 18 duo", "value": 51800 },
        { "query": "iphone duo", "value": 22700 },
        { "query": "iphone 18 pro case", "value": "+1,750%" }
      ]
    }
  },
  "success": true
}

Response Fields

Field	Type	Description
success	boolean	Whether the scraping succeeded
data	object	Result payload — contains one key per requested `type`
data.input	object	Normalized request parameters the scrape was run with
data.input.original_url	string	Google Trends Explore URL equivalent to this request

data.interestOverTime — present when type includes periods:

Field	Type	Description
time	string	ISO 8601 timestamp of the data point
value	number	Relative search interest, `0`–`100` (`100` = peak of the range)

data.interestByGeo — present when type includes geo:

Field	Type	Description
geoName	string	Region name (e.g. `Kansas`)
geoCode	string	Region code (e.g. `US-KS`)
value	number	Relative search interest, `0`–`100`, normalized across the returned regions

data.relatedQueries — present when type includes queries:

Field	Type	Description
top	array	Most popular related queries in the range
top[].query	string	Related search query
top[].value	number	Relative popularity, `0`–`100`
rising	array	Queries with the fastest growth in the range
rising[].query	string	Related search query
rising[].value	number \| string	Growth figure — a number for a percentage increase, or a preformatted string such as `"+1,750%"`

data.relatedTopics — present when type includes topics. Same top / rising shape as relatedQueries, with topic entity metadata (title and type) in place of the query string.

data.autocomplete — present when type includes autocomplete:

Field	Type	Description
mid	string	Google Knowledge Graph entity ID (e.g. `/m/027lnzs`)
title	string	Entity title (e.g. `iPhone`)
type	string	Entity category (e.g. `Mobile phone`)

Trends values are relative, not absolute search volumes. 100 always marks the peak within the returned range, so values from two separate requests are not directly comparable.

Next steps

Webhook — receive the result via callback instead of polling
Creating a task — back to the submit endpoint reference