List the topics this site ranks for
Searches grouped into topics by the words people used and the page Google sent them to, so one topic is one piece of content to plan. Rebuilt whenever a monthly report runs, after a history import, and on request with POST /sites/{site_id}/topics/rebuild. A topic with demand and a weak position is the thing to write about. Use GET /sites/{site_id}/topics/{topic_id} for the searches and pages inside one.
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/topicsRecent Requests
Kept only in this browserPath Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Query Params
limitintegerHow many to return, 1 to 500 (default 100).
Response
Response Body
revisionintegerWhich build of the topic map this is.period_startstring | nullThe month the figures come from.totalintegerHow many topics this build holds, before the limit.topicsarray of objectsTopics, most demand first.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/topics \ --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": { "revision": 3, "period_start": "2026-08-01", "total": 105, "topics": [ { "id": 41, "slug": "bookkeeping-services", "label": "bookkeeping services", "member_count": 79, "primary_intent": "commercial", "is_branded": false, "head_query_id": 812, "head_query_text": "bookkeeping services near me", "clicks": 42, "impressions": 5400, "position": 12.4, "query_count": 61, "page_count": 7, "top_page": { "page_id": 1335, "url": "https://example.com/services", "path": "/services", "click_share": 0.62 }, "primary_intent_is_guess": false } ] }, "meta": { "limit": 50, "offset": 0, "total": 1, "has_more": false }}