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.
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keyword-discoveryRecent Requests
Kept only in this browserPath Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Query Params
bandstringKeep only one band. One of rising, falling, striking_distance, zero_click, question, new.
limitintegerHow 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 }}