Read the suggestions on file for a keyword plus the evidence to write new ones from
advice is null until someone writes suggestions. evidence always carries the current position, previous position, impressions, clicks, CTR and the pages ranking for the keyword. Write suggestions from these numbers, then PUT them back.
GET
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keywords/{keyword_id}/adviceRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredkeyword_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Response
Response Body
adviceobjectSuggestions on file, or null.evidenceobjectSearch Console facts for the keyword.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keywords/{keyword_id}/advice \ --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": { "advice": { "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "tracked_query_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "period_start": "2026-08-01", "evidence_json": {}, "suggestions_json": [ { "title": "Add a step-by-step starter recipe", "detail": "The page ranks 11th for a query with 1,900 monthly impressions...", "effort": "low" } ], "model_id": "external", "credits_used": 0, "source": "api", "author_label": "Claude", "created_at": "2026-09-01T09:00:00.000Z" }, "evidence": { "query_text": "sourdough starter", "position": 11.2, "impressions": 1900 } }}