Read one topic with its searches and the pages that rank for it
queries lists every search in the topic with its own intent and position. pages lists your pages that appeared for it, most impressions first. When two pages both hold a large share here, they are competing for the same topic.
GET
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/topics/{topic_id}Recent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredtopic_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Response
Response Body
topicobjectA group of searches that mean the same thing, worked out from the words people used and the pages Google sent them to. One topic is one piece of content to plan.period_startstring | nullThe month the figures come from.queriesarray of objectsSearches in this topic, most impressions first.pagesarray of objectsYour pages that appeared for it.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/topics/{topic_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": { "topic": { "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 }, "period_start": "2026-08-01", "queries": [ { "query_id": 812, "query_text": "bookkeeping services near me", "intent": "commercial", "is_question": false, "is_branded": false, "similarity": 0.72, "is_head": false, "clicks": 4, "impressions": 320, "position": 11.2, "intent_rule": "R4" } ], "pages": [ { "page_id": 1335, "url": "https://example.com/services", "path": "/services", "clicks": 12, "impressions": 800, "position": 9.4 } ] }}