SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

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.

GEThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/opportunities

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

statusstring

Comma separated. Any of open, in_progress, done, won, lost, dismissed, stale. Defaults to open and in_progress.

kindstring

Keep only one kind.

familystring

Keep only one family. One of keyword, content, technical, links, backlinks, competitor, ai_readiness, answers.

pillarstring

Keep only one pillar. One of seo, geo, aeo: seo for search results, geo for AI answers, aeo for direct answers to questions.

winsstring

true for what is already working, all for everything. Default is work only.

limitinteger

Page size, 1 to 200 (default 50).

offsetinteger

Rows 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
}
}