Google Trends API

Queue Related Queries jobs and read normalized Top/Rising results.

Quick start

Submit a complete Trends grain, receive 202 Accepted, then poll the durable job without handling browser or token internals.

curl -X POST "$SPIDER_API_BASE/v1/google-trends/related-queries"   -H "Authorization: Bearer $SPIDER_API_KEY"   -H "Content-Type: application/json"   -d '{
    "keyword": "airdrop",
    "geo": "CN",
    "timeframe": "today 12-m",
    "category": 0,
    "property": "",
    "hl": "en-US",
    "tz": 420
  }'

curl -X GET "$SPIDER_API_BASE/v1/google-trends/jobs/gtjob_01j"   -H "Authorization: Bearer $SPIDER_API_KEY"

Authentication

Use a bearer token.

Create and manage product API keys in Product Console settings. The docs page itself is public.

Response shape

Durable job

Queued, running, completed, or failed state with attempts and timestamps.

Related queries

Completed jobs return normalized top and rising query arrays.

Internal boundary

DICloak groups, browser profiles, CDP URLs, Cookies, reCAPTCHA tokens, and widget tokens are never exposed.

Reference

Endpoint reference

OpenAPI-backed details for Trends job creation, polling, results, and errors.

OpenAPI endpoint details

Interactive schemas, request bodies, response objects, and public error contracts load here.