Skip to content
Menu
SilktideDevelopers

Get how a Silktide 4 score changed over time

GET/v1/results/score-trend
View as Markdown

Returns every measurement of one Silktide 4 score in the period, oldest first, for a website or one of its sections. Take score ids from Get a website's Silktide 4 scores.

This is for accounts that have Silktide 4. An account that has only Silktide 5 gets an EditionNotAvailable error; it reads Get how a Silktide 5 score changed instead. Scores explains which to use.

An unknown scoreId is not an error: the answer is an empty list.

Unlike Get Silktide 4 scores, this can return a score below 0, Silktide's marker for a score it could not work out at that time. Treat any negative score, like null, as no score.

A missing scoreId is an error, but it comes back with status 200 and an error body. Check for error before reading result.

Request
curl "https://api.eu.silktide.com/v1/results/score-trend?scoreId=overall&websiteId=3&period=last-30-days" \
  -H "Authorization: silktide token=$SILKTIDE_API_KEY"
Response: The overall score over the last 30 days
{
  "result": {
    "scores": [
      {
        "time": 1790216531,
        "score": 28.1
      },
      {
        "time": 1790821331,
        "score": 31.4
      }
    ]
  },
  "selector": "/v1/results/score-trend",
  "duration": 0.005
}

Request

Query parameters

  • scoreIdstringrequired

    The score, by the id Get Silktide 4 scores uses, such as overall.

  • websiteIdintegerrequiredat least 1

    The website.

  • sectionIdinteger

    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.

Response

200JSON.

  • resultobjectrequired

    The answer.

    Show 1 fields
    • scoreslist of objectsrequired

      Every measurement in the period, oldest first. Empty when there are none, or the score id is unknown.

      Show 2 fields
      • timeintegerrequired

        When the score was measured.

      • scorenumberrequiredcan be nullat most 100

        The score then, to one decimal place. Null, or below 0, when it could not be scored.

  • selectorstringrequired

    The query that answered, as its path: /v1/results/scores.

  • durationnumberrequired

    Seconds Silktide took to answer.

Errors

StatusTypeWhen
404ModelNotFoundNo website or section with that id exists in the account, or the API key's user cannot see it.
200InvalidContextNo websiteId was sent. The body is an error despite the status.
200InvalidArgumentscoreId is missing, or period is not one of its values. The body is an error despite the status.
200EditionNotAvailableThe account does not have Silktide 4. Its status is 403, and instead names /v1/results/module-score-trend. The body is an error despite the status.
401NotLoggedInNo API key was sent, or it is not a key for this region.(any operation)
429TooManyRequestsToo 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
Any user of the account
Plan feature
None
Edition
Silktide 4 only
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.