SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

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.

GEThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/topics/{topic_id}

Recent Requests

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

Path Params

site_idstringrequired
topic_idstringrequired

Headers

Authorizationstringrequired

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