The ranked list of what to do next for a website
The growth board. Every opportunity carries a score out of 100 and the score_components that produced it, so you can explain the ranking rather than assert it. Open work only by default; pass wins=true for what is already working, or status to see closed items. Start here, then read one with GET /sites/{site_id}/opportunities/{opportunity_id}. Spends no SoftSolz AI credits.
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/opportunitiesRecent 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
statusstringComma separated. Any of open, in_progress, done, won, lost, dismissed, stale. Defaults to open and in_progress.
kindstringKeep only one kind.
familystringKeep only one family. One of keyword, content, technical, links, backlinks, competitor, ai_readiness, answers.
pillarstringKeep only one pillar. One of seo, geo, aeo: seo for search results, geo for AI answers, aeo for direct answers to questions.
winsstringtrue for what is already working, all for everything. Default is work only.
limitintegerPage size, 1 to 200 (default 50).
offsetintegerRows to skip.
Response
Response Body
opportunitiesarray of objectsHighest score first.countsobjectby_family and by_pillar count open and in progress work only; by_status counts work in every status. open_opportunity_clicks totals every open item; open_clicks_to_win leaves out clicks lost to drops, which are in open_clicks_lost. wins counts open wins.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/opportunities \ --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": { "opportunities": [ { "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "site_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "kind": "fix_snippet", "kind_label": "Rewrite the title and description", "family": "content", "pillar": "seo", "action": "refresh", "is_win": false, "entity_type": "page", "question_id": null, "question": null, "subject_key": null, "task_id": null, "page_id": 1335, "query_id": 812, "topic_id": 41, "title": "Rewrite the title and description on /pricing", "score": 59.28, "score_components": { "gap": { "value": 1, "weight": 0.3 }, "demand": { "value": 0.62, "weight": 0.22 } }, "opportunity_clicks": 29, "est_value": null, "effort": "low", "confidence": 0.666, "status": "open", "first_seen_on": "2026-05-01", "last_seen_on": "2026-08-01", "occurrence_count": 4, "baseline_json": { "clicks": 4, "impressions": 900, "position": 14.2 }, "evidence_json": { "finding_count": 2 }, "recommendation_id": null, "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-09-01T09:00:00.000Z" } ], "counts": { "by_family": { "content": 17, "keyword": 3 }, "by_pillar": { "seo": { "open": 20, "clicks": 83 }, "geo": { "open": 4, "clicks": 0 }, "aeo": { "open": 6, "clicks": 12 } }, "by_status": { "open": 20, "in_progress": 2, "won": 4 }, "open_opportunity_clicks": 83, "open_clicks_to_win": 61, "open_clicks_lost": 22, "wins": 3 } }, "meta": { "limit": 50, "offset": 0, "total": 1, "has_more": false }}