Trends

Google Trends — interest over time

Search-interest timeline for up to 5 comma-separated keywords, compared against each other like the Trends UI. Values are Google’s normalized 0–100 indexes, not absolute volumes.

Credits: 1 (refunded on failure).

get/api/v1/trends/interest

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/trends/interest
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

qstring required

Keyword(s) — up to 5, comma-separated.

geostring

ISO country ("US"), subregion ("US-CA"), or empty for worldwide.

timestring

Timeframe in Trends syntax: "now 1-H", "now 7-d", "today 1-m", "today 3-m", "today 12-m", "today 5-y", "all", or "YYYY-MM-DD YYYY-MM-DD".

catinteger

Trends category id (0 = all).

gprop'images' | 'news' | 'youtube' | 'froogle'

Property: omit for web search, or "images", "news", "youtube", "froogle".

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

No recorded changes to this operation across all 1 revision of this API.