List tracked keywords with their month-by-month positions
Each row carries points (history), latest, previous, change and best. previous is the last month before latest in which the search was seen, which can be several months earlier. max is the per-site cap.
GET
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keywordsRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Query Params
monthsintegerMonths of history, default 12.
Response
Response Body
monthsarray of stringsMonths covered, oldest first.months_with_dataarray of stringsThe months in months that have any imported search data for this site. A keyword not seen in any of them was not shown by Google; when this list is empty, no complete month has been imported yet.rowsarray of objectsOne row per tracked keyword.maxintegerHow many keywords one site may track.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/keywords \ --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": { "months": [ "2026-08-01" ], "months_with_data": [ "2026-08-01" ], "rows": [ { "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "query_text": "sourdough starter", "created_at": "2026-09-01T09:00:00.000Z", "points": [ { "period_start": "2026-08-01", "position": 7.3, "impressions": 1900, "clicks": 64 } ], "latest": { "period_start": "2026-08-01", "position": 7.3, "impressions": 1900, "clicks": 64 }, "previous": { "period_start": "2026-08-01", "position": 7.3, "impressions": 1900, "clicks": 64 }, "change": 2, "best": 5.1, "months_seen": 9, "site_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "notes": "Main money keyword.", "source_label": "Ahrefs via Claude", "their_monthly_searches": 2400, "their_difficulty": 35, "target_url": null, "added_via": "connected_app", "added_by_label": "Claude", "updated_at": "2026-09-01T09:00:00.000Z" } ], "max": 50 }}