SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Read a report in full: run, site, findings and recommendations

Read this before writing narratives or recommendations. Every finding carries evidence_json with the numbers; findings with narrative null still need an explanation.

GEThttps://app.softsolz.uk/api/v1/services/seo/runs/{run_id}

Recent Requests

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

Path Params

run_idstringrequired

Headers

Authorizationstringrequired

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

Response

Response Body

runobjectA monthly report.
siteobjectA tracked website.
findingsarray of objectsFindings ordered by impact, highest first.
recommendationsarray of objectsRecommendations ordered by priority rank.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/seo/runs/{run_id} \
--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": {
"run": {
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"site_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"period_start": "2026-08-01",
"period_end": "2026-08-31",
"compare_period_start": "2026-07-01",
"compare_period_end": "2026-07-31",
"status": "queued",
"detector_version": "1.1.0",
"finding_count": 14,
"recommendation_count": 5,
"action_count": 4,
"credits_used": 0,
"data_quality_json": {
"enough_data": true,
"narration": "skipped_for_api"
},
"summary_markdown": "# Acme Bakery - 2026-08",
"error_message": null,
"task_id": null,
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
},
"site": {
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"name": "Acme Bakery",
"domain": "acmebakery.co.uk",
"gsc_property_url": "sc-domain:acmebakery.co.uk",
"gsc_connection_id": null,
"gsc_connection_status": "active",
"gsc_connection_active": true,
"links_schedule": "off",
"links_last_run_at": null,
"bing_connection_id": null,
"bing_site_url": null,
"timezone": "Europe/London",
"status": "active",
"refresh_frequency": "daily",
"last_refresh_at": null,
"settings_json": {
"brand_terms": [
"acme bakery"
]
},
"visibility": "tenant",
"created_by": 12,
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
},
"findings": [
{
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"run_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"detector": "striking_distance",
"severity": "info",
"entity_type": "query",
"impact_score": 42.5,
"metric_delta": -35,
"page_path": "/blog/sourdough-guide",
"page_url": null,
"query_text": "sourdough starter",
"evidence_json": {
"current": {
"clicks": 80,
"position": 11.2
},
"prior": {
"clicks": 120,
"position": 8.9
}
},
"narrative": "Clicks fell by a third because the page slipped from page one to page two.",
"narrative_confidence": 0.8,
"narrative_source": "api",
"narrative_author": "Claude",
"created_at": "2026-09-01T09:00:00.000Z"
}
],
"recommendations": [
{
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"run_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"play": "external_suggestion",
"title": "Refresh the sourdough guide and add a starter recipe",
"detail_markdown": null,
"priority_rank": 3,
"priority_score": 180,
"estimated_effort": "low",
"opportunity_clicks": 180,
"status": "proposed",
"dismissed_reason": null,
"task_id": null,
"finding_ids": [
"3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23"
],
"source": "api",
"author_label": "Claude",
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
}
]
}
}