List the landing pages visits began on

GET/v1/results/analytics/entry-pages

Lists landing pages: the first tracked page of each visit, and how many visits began on each. It is the Landing pages table in Analytics, and takes the Analytics arguments and the table arguments.

pageViews here counts visits that began on the page, not every view of it; Get pages counts those. The scroll figures and duration are the page's own, across all its views.

On this query, filters[url] matches the landing page, so filters[url]=contains:/blog/ lists the blog posts visits began on.

Rows are sorted by pageViews, busiest first, and can be sorted only by url or pageViews. bounceRate is added only when columns names it. When you send columns, also send a sort naming one of them, unless pageViews is among them: without it, this query answers with an error.

Request

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

Response: The pages most visits began on

{
  "result": {
    "page": 1,
    "minPage": 1,
    "maxPage": 7,
    "numRows": 13,
    "rowsPerPage": 2,
    "rows": [
      {
        "url": "https://fakewinebarrel.com/",
        "pageViews": 374,
        "averageScroll": 86.83,
        "reach25": 100,
        "reach50": 100,
        "reach75": 92.8,
        "reach100": 3.7,
        "duration": 22.46,
        "pageTitle": "The Wine Barrel | Fine wines, delivered",
        "pageName": "Fine wines, delivered"
      },
      {
        "url": "https://fakewinebarrel.com/blog/pairing-wine-with-cheese/",
        "pageViews": 142,
        "averageScroll": 71.4,
        "reach25": 96.2,
        "reach50": 81.5,
        "reach75": 58.1,
        "reach100": 22.4,
        "duration": 64.1,
        "pageTitle": "Pairing wine with cheese | The Wine Barrel",
        "pageName": "Pairing wine with cheese"
      }
    ]
  },
  "selector": "/v1/results/analytics/entry-pages",
  "duration": 0.08
}

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 landing page's address. Filter other queries to visits that began on it with filters[entryUrl].
  - pageViewsintegerrequired
    Visits that began on the page.
  - averageScrollnumber0 to 100
    How far down the page its views scrolled on average, as a percentage of its height. Across all the page's views, not only the visits that began on it. Absent when no scrolling was recorded for it.
  - reach25number0 to 100
    The percentage of the page's views that scrolled at least 25% of the way down, to one decimal place. Absent when no scrolling was recorded for it.
  - reach50number0 to 100
    The percentage of the page's views that scrolled at least 50% of the way down, to one decimal place. Absent when no scrolling was recorded for it.
  - reach75number0 to 100
    The percentage of the page's views that scrolled at least 75% of the way down, to one decimal place. Absent when no scrolling was recorded for it.
  - reach100number0 to 100
    The percentage of the page's views that scrolled at least 100% of the way down, to one decimal place. Absent when no scrolling was recorded for it.
  - durationnumber
    Average time spent on the page per view, in seconds. Absent when no time was recorded for it.
  - pageTitlestring
    The page's <title>, as the Silktide Script recorded it. Empty when it recorded none. Absent where page names are not available.
  - pageNamestring
    The page's name, as Silktide shows it: the account's label for it where one is set, otherwise its main heading, its title without the website's name, or its path. Absent where page names are not available.
  - bounceRateinteger0 to 100
    The share of the page's visits that viewed only one page and left, as a whole percentage. Only when columns names it.
  - previousPageViewsinteger
    Visits that began on the page 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` or `pageViews` only. The body is an error despite the status.
200	-	`columns` leaves out `pageViews` and no `sort` names one of the columns asked for. 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/entry-pages?view=all&period=last-30-days&rowsPerPage=2" \
  -H "Authorization: silktide token=$SILKTIDE_API_KEY"

Response: The pages most visits began on

{
  "result": {
    "page": 1,
    "minPage": 1,
    "maxPage": 7,
    "numRows": 13,
    "rowsPerPage": 2,
    "rows": [
      {
        "url": "https://fakewinebarrel.com/",
        "pageViews": 374,
        "averageScroll": 86.83,
        "reach25": 100,
        "reach50": 100,
        "reach75": 92.8,
        "reach100": 3.7,
        "duration": 22.46,
        "pageTitle": "The Wine Barrel | Fine wines, delivered",
        "pageName": "Fine wines, delivered"
      },
      {
        "url": "https://fakewinebarrel.com/blog/pairing-wine-with-cheese/",
        "pageViews": 142,
        "averageScroll": 71.4,
        "reach25": 96.2,
        "reach50": 81.5,
        "reach75": 58.1,
        "reach100": 22.4,
        "duration": 64.1,
        "pageTitle": "Pairing wine with cheese | The Wine Barrel",
        "pageName": "Pairing wine with cheese"
      }
    ]
  },
  "selector": "/v1/results/analytics/entry-pages",
  "duration": 0.08
}

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.