SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

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 (average position 4 to 30), zero_click (seen but never clicked), rising (at least 20 impressions and 1.5 times the monthly average of the three months before), falling (half or less of an earlier monthly average of at least 20), question, and new. A month where the site has data but the search was not shown counts as zero in that average. Filter with band. counts gives the size of every band before filtering, and total the size of the band asked for, so total larger than the keywords returned means the list was cut at limit. 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

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

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

Query Params

bandstring

Keep only one band. One of rising, falling, striking_distance, zero_click, question, new.

limitinteger

How many to return, 1 to 500 (default 100).

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

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keyword-discovery \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"period_start": "2026-08-01",
"band": "striking_distance",
"total": 42,
"counts": {
"rising": 6,
"falling": 10,
"striking_distance": 3,
"zero_click": 5,
"question": 14,
"new": 40
},
"keywords": [
{
"query_id": 812,
"query_text": "payroll software pricing",
"intent": "transactional",
"intent_rule": "R3",
"is_question": false,
"is_local": false,
"is_branded": false,
"first_seen_on": "2026-05-02",
"impressions": 540,
"clicks": 0,
"ctr": 0,
"position": 14.2,
"impressions_prior_mean": 210,
"trend_ratio": 2.57,
"opportunity_clicks": 18.4,
"bands": [
"striking_distance"
]
}
]
},
"meta": {
"limit": 50,
"offset": 0,
"total": 1,
"has_more": false
}
}