List the pages where people met dead clicks

GET/v1/results/analytics/frustration-pages

Lists the pages where people got stuck. It is the Frustration table in Analytics, and takes the Analytics arguments and the table arguments. search matches the page's address.

The only frustration Silktide detects is the dead click: a click on something that did not respond, such as a heading that looks like a link or an image people expect to open. A page's frustrationScore is its dead clicks per visitor, on average: 0 means none, and 1 is very high.

topElementSelector, topElementText and topElementClicks name what people dead-clicked most on the page, so you can find it and decide whether it should be a link or should stop looking like one.

Rows are sorted by affectedVisitors, most first. The topElement… fields cannot be sorted by: a sort naming one of them answers with an error. Send previousPeriod=1 to compare each page with the period before.

Request

curl "https://api.eu.silktide.com/v1/results/analytics/frustration-pages?view=all&period=last-30-days&rowsPerPage=2" \
  -H "Authorization: silktide token=$SILKTIDE_API_KEY"

Response: The pages where most visitors met a dead click

{
  "result": {
    "page": 1,
    "minPage": 1,
    "maxPage": 7,
    "numRows": 13,
    "rowsPerPage": 2,
    "rows": [
      {
        "url": "https://fakewinebarrel.com/",
        "visitors": 411,
        "affectedVisitors": 41,
        "totalFrustration": 58,
        "frustrationScore": 0.1411,
        "clicks": 445,
        "topElementSelector": "body>div>footer>div>div>div:nth-child(1)>div>h3",
        "topElementText": "Contact us",
        "topElementClicks": 20
      },
      {
        "url": "https://fakewinebarrel.com/wines/",
        "visitors": 183,
        "affectedVisitors": 17,
        "totalFrustration": 24,
        "frustrationScore": 0.1311,
        "clicks": 206,
        "topElementSelector": "main>div.grid>div:nth-child(2)>img",
        "topElementText": "",
        "topElementClicks": 9
      }
    ]
  },
  "selector": "/v1/results/analytics/frustration-pages",
  "duration": 0.09
}

Request

Query parameters

viewstringmatches ^(all|[1-9]\d*)$
The analytics view to read: its id, the number after /analytics/ in its address in Silktide, or all for all of the account's analytics. Send this or websiteId.
websiteIdintegerat least 1
Instead of view, a website whose analytics to read. The website must have Analytics set up.
sectionIdinteger
With websiteId, a section of the website. Defaults to 0, the whole website.
periodstring
The date range. Defaults to all. The spaced forms (-7 days, month to date) are older names that keep working. custom needs from and to.
One ofalltodaylast-7-dayslast-30-dayslast-90-daysmonth-to-datelast-monthyear-to-datelast-12-monthscustom-7 days-30 days-90 days-1 monthmonth to dateyear to date-12 months
fromstring
With period=custom, the first day, such as 2026-10-01.
tostring
With period=custom, the last day.
timezonestring
The IANA time zone days are read in, such as America/New_York. Defaults to UTC.
filtersmap of strings
Only visits matching every filter, keyed by what is filtered: filters[url]=contains:/blog. Each value is {operator}:{value}, with operator is, not, contains, starts, gt or lt. Keys include url, hostName, entryUrl, exitUrl, event, outgoingUrl, referrer, source, medium, campaign, content, term, countryCode, regionCode, language, deviceType (desktop, tablet or mobile), operatingSystem and browser.
columnsstring
The columns to return, comma-separated, such as url,pageViews. Left out, the table's default columns. Send a string even in a JSON body: an array is ignored.
sortstring
The column to sort by, then :a for ascending or :d for descending, such as pageViews:d. Left out, the table's own order.
searchstring
Only rows matching this text. What it searches depends on the table, most often the URL or title.
pageintegerat least 1
The page of rows to return, from 1. Defaults to 1.
rowsPerPageintegerat least 1
How many rows a page holds. Defaults to 100.
previousPeriodstring
1 to add the figures of the period before, the same length and ending where this one starts, as previous… fields. Left out or 0, none. Needs a period with a start: with all, nothing is added.
One of01

Response

200JSON.

resultobjectrequired
The answer.
Show 6 fieldsHide fields
- pageintegerrequiredat least 1
  The page returned. Not always the page asked for, when that was out of range.
- minPageintegerrequiredat least 1
  The first page. Always 1.
- maxPageintegerrequired
  The last page at this rowsPerPage. With no rows, 0 or 1 depending on the table.
- numRowsintegerrequired
  How many rows there are across every page.
- rowsPerPageintegerrequiredat least 1
  How many rows a page holds.
- rowslist of objectsrequired
  The rows on this page.
  Show 12 fieldsHide fields
  - urlstringrequireduri
    The page's address. Filter other queries to it with filters[url].
  - visitorsintegerrequired
    Unique visitors who viewed the page.
  - affectedVisitorsintegerrequired
    Visitors affected: unique visitors who made at least one dead click on it.
  - totalFrustrationintegerrequired
    Dead clicks on the page: clicks on something that did not respond.
  - frustrationScorenumberrequiredcan be null
    Dead clicks per visitor of the page, on average: 0 is none, and 1 is very high. Null when the page had no visitors.
  - clicksintegerrequired
    Every click on the page, dead or not.
  - topElementSelectorstringrequired
    The CSS selector of what people dead-clicked most on the page. Empty when nothing was dead-clicked.
  - topElementTextstringrequired
    The text of that element, as the page showed it. Empty when it had none, or nothing was dead-clicked.
  - topElementClicksintegerrequired
    Dead clicks on that element. 0 when nothing was dead-clicked.
  - previousTotalFrustrationinteger
    Dead clicks in the period before. Only with previousPeriod=1 and a period other than all. 0 when it had none then.
  - previousAffectedVisitorsinteger
    Visitors affected in the period before. Only with previousPeriod=1 and a period other than all. 0 when it had none then.
  - previousVisitorsinteger
    Unique visitors in the period before. Only with previousPeriod=1 and a period other than all. 0 when it had none then.
selectorstringrequired
The query that answered, as its path: /v1/results/scores.
durationnumberrequired
Seconds Silktide took to answer.

Errors

Status	Type	When
404	`ModelNotFound`	No view or website with that id exists in the account, or the API key's user cannot see it.
403	`AccessDenied`	The API key's user cannot read that analytics view.
200	`ModelNotFound`	The website has no Analytics set up. The body is an error despite the status.
200	`InvalidRequest`	Neither `view` nor `websiteId` was sent. The error's own `status` is `400` and `properties.field` is `view`. The body is an error despite the status.
200	`InvalidArgument`	A filter names a key or operator Analytics does not know. The body is an error despite the status.
200	`InvalidArgument`	`period` is not one of its values, or is `custom` without both `from` and `to`. The body is an error despite the status.
200	-	`sort` names a column the table cannot sort by. Sort by `url`, `visitors`, `affectedVisitors`, `totalFrustration`, `frustrationScore` or `clicks` only. The body is an error despite the status.
401	`NotLoggedIn`	No API key was sent, or it is not a key for this region.(any operation)
429	`TooManyRequests`	Too many requests to this path in five seconds. Retry after the number of seconds in the `Retry-After` header, which `properties.retryAfter` repeats.(any operation)
503	-	Silktide is busy. Retry after the number of seconds in the `Retry-After` header.(any operation)

Every error has the same body. See Errors.

Access

Permission: View analytics view (View all analytics for `view=all`)
Plan feature: None
Edition: Silktide 4 and Silktide 5
Cost: Free
Available since: v1.0.0

Try it

Sends a real request to your account from this browser. Your key stays in this tab and goes only to the Silktide API.

Request

curl "https://api.eu.silktide.com/v1/results/analytics/frustration-pages?view=all&period=last-30-days&rowsPerPage=2" \
  -H "Authorization: silktide token=$SILKTIDE_API_KEY"

Response: The pages where most visitors met a dead click

{
  "result": {
    "page": 1,
    "minPage": 1,
    "maxPage": 7,
    "numRows": 13,
    "rowsPerPage": 2,
    "rows": [
      {
        "url": "https://fakewinebarrel.com/",
        "visitors": 411,
        "affectedVisitors": 41,
        "totalFrustration": 58,
        "frustrationScore": 0.1411,
        "clicks": 445,
        "topElementSelector": "body>div>footer>div>div>div:nth-child(1)>div>h3",
        "topElementText": "Contact us",
        "topElementClicks": 20
      },
      {
        "url": "https://fakewinebarrel.com/wines/",
        "visitors": 183,
        "affectedVisitors": 17,
        "totalFrustration": 24,
        "frustrationScore": 0.1311,
        "clicks": 206,
        "topElementSelector": "main>div.grid>div:nth-child(2)>img",
        "topElementText": "",
        "topElementClicks": 9
      }
    ]
  },
  "selector": "/v1/results/analytics/frustration-pages",
  "duration": 0.09
}

Try it

Sends a real request to your account from this browser. Your key stays in this tab and goes only to the Silktide API.