Keywords & Trends

Keyword Interest by Region

Nexscope Trends relative keyword interest across United States regions. Regional scores are relative indices, not country percentages or absolute search counts. Preserve provider region IDs.

post/api/skill-api/v1/skills/seo-keyword-interest-regions/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/seo-keyword-interest-regions/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

keywordsstring[] required
market'US'
dateFromstring date required

2004-01-01 or later; inclusive interval at most 366 days.

dateTostring date required

No later than first acceptance UTC day; replay retains the frozen dates.

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Changes

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