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.
GET
https://app.softsolz.uk/api/v1/services/seo/runs/{run_id}Recent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
run_idstringrequiredHeaders
AuthorizationstringrequiredBearer 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" } ] }}