Google Trends API

The Google Trends API extracts data from Google Trends as structured JSON: interest over time, interest by region, related queries, related topics, and real-time trending searches. Instead of dealing with Google's internal APIs and session management, you get clean, parsed JSON ready to use in your applications.

Endpoints

Authentication

All requests require your Scrape.do API token via the token query parameter:

curl "https://api.scrape.do/plugin/google/trends?token=YOUR_TOKEN&q=bitcoin&geo=US"

Using with the Async API

Both endpoints are available as async plugins for bulk processing. The /plugin/google/trends endpoint maps to the google/trends plugin key:

curl -X POST "https://q.scrape.do/api/v1/jobs" \
  --header "X-Token: YOUR_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "Plugin": {
      "Key": "google/trends",
      "Params": [
        { "q": "bitcoin", "geo": "US" },
        { "q": "ethereum", "geo": "US", "data_type": "RELATED_QUERIES" }
      ]
    }
  }'

Error Handling

All endpoints return errors in a consistent JSON format:

{
  "error": "error_code",
  "message": "Human readable error message"
}