Find the searches worth acting on, with the band that says why.

Every search this site already appears for in the latest complete month, each tagged with bands: striking_distance (position 4 to 30), zero_click (seen but never clicked), rising (demand up against the mean of the three months before), falling, question, and new. Filter with band. counts gives the size of every band before filtering. Read this before planning content, then group what you find with GET /sites/{site_id}/topics. Spends no SoftSolz AI credits.

GEThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keyword-discovery

Recent Requests

TimeStatusUser Agent

Make a request to see history.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Response

Response Body

period_startstring | nullThe complete month these numbers come from.

bandstring | nullThe band asked for, or null.

totalintegerMatching searches before the limit.

countsobjectHow many searches sit in each band.

keywordsarray of objectsMatching searches, best opportunity first.

Request

import { SoftSolz } from '@softsolz/sdk';

const client = new SoftSolz({ apiKey: process.env.SOFTSOLZ_API_KEY });

const result = await client.seo.discoverKeywords('<site_id>', {});
console.log(result);

Credentials

Authorization

Sent as a Bearer token. Stored only in your browser.

Response · 200

{
  "data": {
    "period_start": "string",
    "band": "string",
    "total": 0,
    "counts": {},
    "keywords": []
  }
}