54-Week Historical Search Interest Over Time Curve API

GET/v1/trends/interest10 Credits / 54-week curve (0 if empty)($0.001 / curve ($0.55–$1.00 / 1K curves))· Updated 2026-11-14

Retrieve the 52–54 week normalized (0–100) search interest time-series curve for one or up to 5 comma-separated keywords, complete with peak week, current index, average score, momentum delta %, and breakout classification.

Parameters

keywordstringrequired
Target keyword or comma-separated list of up to 5 keywords to compare (e.g., 'artificial intelligence' or 'langchain,llamaindex'). Alias: q.
Example: artificial intelligence
countrystring
Two-letter ISO country code for regional trend telemetry (e.g., US, GB, DE, JP).
Example: US
langstring
ISO 639-1 language code (default en).
Example: en

Example Request (cURL / Python / JavaScript)

curl "https://api.searchdataapi.com/v1/trends/interest?keyword=artificial+intelligence" \
  -H "x-api-key: sr_live_your_api_key"

import requests

res = requests.get(
    "https://api.searchdataapi.com/v1/trends/interest?keyword=artificial+intelligence",
    headers={"x-api-key": "sr_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.searchdataapi.com/v1/trends/interest?keyword=artificial+intelligence", {
  headers: { "x-api-key": "sr_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://searchdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "keyword": "artificial intelligence",
    "keywords": [
      "artificial intelligence"
    ],
    "country": "US",
    "lang": "en",
    "weeks_count": 52,
    "summary": {
      "current_interest": 21,
      "peak_interest": 100,
      "peak_week": "2026-02-08",
      "average_interest": 53,
      "yoy_change_pct": -22,
      "trend_direction": "declining",
      "velocity_badge": "-22%"
    },
    "timeline": [
      {
        "date_from": "2026-08-16",
        "date_to": "2026-08-22",
        "timestamp": 1786838400,
        "value": 27
      },
      {
        "date_from": "2026-08-23",
        "date_to": "2026-08-29",
        "timestamp": 1787443200,
        "value": 23
      },
      {
        "date_from": "2026-08-30",
        "date_to": "2026-09-05",
        "timestamp": 1788048000,
        "value": 28
      },
      {
        "date_from": "2026-09-06",
        "date_to": "2026-09-12",
        "timestamp": 1788652800,
        "value": 32
      },
      {
        "date_from": "2026-09-13",
        "date_to": "2026-09-19",
        "timestamp": 1789257600,
        "value": 47
      },
      {
        "date_from": "2026-09-20",
        "date_to": "2026-09-26",
        "timestamp": 1789862400,
        "value": 32
      },
      {
        "date_from": "2026-09-27",
        "date_to": "2026-10-03",
        "timestamp": 1790467200,
        "value": 31
      },
      {
        "date_from": "2026-10-04",
        "date_to": "2026-10-10",
        "timestamp": 1791072000,
        "value": 27
      },
      {
        "date_from": "2026-10-11",
        "date_to": "2026-10-17",
        "timestamp": 1791676800,
        "value": 27
      },
      {
        "date_from": "2026-10-18",
        "date_to": "2026-10-24",
        "timestamp": 1792281600,
        "value": 30
      },
      {
        "date_from": "2026-10-25",
        "date_to": "2026-10-31",
        "timestamp": 1792886400,
        "value": 32
      },
      {
        "date_from": "2026-11-01",
        "date_to": "2026-11-07",
        "timestamp": 1793491200,
        "value": 21
      }
    ]
  },
  "meta": {
    "request_id": "a7818c66-f8b3-4977-b168-aaeca403fa1b",
    "endpoint": "/v1/trends/interest",
    "count": 52,
    "credits_charged": 10,
    "cached": false,
    "took_ms": 4164
  }
}

Response Fields

54-week historical search interest timeline (0–100) and momentum summary.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://searchdataapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`keyword`	string	Primary keyword.
`keywords`	array of string
`country`	string	ISO country code.
`weeks_count`	integer	Number of weekly data points (typically 52–54).
`summary`	object
`current_index`	integer	Most recent week 0–100 score.
`average_index`	number	54-week mean interest score.
`peak_index`	integer	Peak score (100).
`peak_date`	string	Date of peak interest.
`momentum_pct`	number	Recent 4-week vs prior 12-week velocity %.
`trend_status`	string	breakout, rising, steady, or cooling.
`timeline`	array of TrendTimelinePoint
`date_from`	string	Start date of weekly bucket (YYYY-MM-DD).
`date_to`	string	End date of weekly bucket (YYYY-MM-DD).
`timestamp`	integer	Unix epoch seconds.
`value`	integer	Normalized 0–100 search interest index.
`meta`	ResponseMeta
`request_id`	string	Unique UUIDv4 trace identifier.
`endpoint`	string	Normalized /v1/* endpoint path.
`count`	integer	Number of primary items returned.
`credits_charged`	integer	Credits deducted (0 on empty or error).
`cached`	boolean	Whether served from L1/L2 edge cache.
`took_ms`	integer	End-to-end gateway latency in milliseconds.

Status Codes

200: 54-week historical search interest timeline (0–100) and momentum summary.