SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

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.

GEThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keywords/{keyword_id}/advice

Recent Requests

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

Path Params

site_idstringrequired
keyword_idstringrequired

Headers

Authorizationstringrequired

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