SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Blogs

Performance of one post for a date range

Totals and change, a daily series, sources, countries and Google searches that bring readers to the post. Google search fields appear only when the key also holds service.seo.view and acts for a member (a connected app); otherwise google is { connected: false, reason }.

GEThttps://app.softsolz.uk/api/v1/services/blogs/posts/{id}/performance

Recent Requests

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

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Query Params

fromstring

First day, YYYY-MM-DD (UTC). Send together with to; an invalid date returns 400.

tostring

Last day, YYYY-MM-DD (UTC), inclusive. Must be on or after from.

daysinteger

Length of the range ending today, 1 to 400, when from and to are not given. Default 30. Other values return 400.

comparestring

previous (default) compares with the period before, year with the same weekdays 52 weeks earlier (the same dates a year earlier for ranges over 364 days), none turns comparison off. Other values return 400.

Response

Response Body

postobject | nullThe post: post_id, slug, title, status, published_at, url and urls.
rangeobject | nullThe reported period: from, to (inclusive) and days.
previous_rangeobject | nullThe comparison period, or null when compare=none.
comparestring | nullComparison mode used.
totalsobject | nullTotals for the period.
previous_totalsobject | nullTotals for the comparison period.
changeobject | nullChange ratios for views, reads, read time and read-through.
seriesarray of objectsOne entry per day.
tracked_viewsnumber | nullViews with a recorded source.
sourcesarray of objectsChannels, sources and campaigns for this post.
countriesarray of objectsCountries with views, reads and average read time.
googleobject | nullGoogle clicks, impressions, CTR, position, top searches and countries.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/blogs/posts/{id}/performance \
--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": {
"post": {},
"range": {
"from": "2026-09-08",
"to": "2026-10-07",
"days": 30
},
"previous_range": {},
"compare": "previous",
"totals": {
"views": 1240,
"tracked_views": 980,
"reads": 410,
"avg_read_seconds": 96,
"avg_scroll": 64,
"read_through": 0.42
},
"previous_totals": {},
"change": {},
"series": [
{}
],
"tracked_views": 260,
"sources": [
{}
],
"countries": [
{}
],
"google": {}
}
}