Skip to content
Menu
SilktideDevelopers

Get how a Silktide 5 score changed over time

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

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

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

Unlike the Silktide 4 trend, a scoreId that is missing or not one of the values is refused, and the error lists the values. Scores here are never below 0.

Request
curl "https://api.eu.silktide.com/v1/results/module-score-trend?scoreId=accessibility&websiteId=2&period=last-90-days" \
  -H "Authorization: silktide token=$SILKTIDE_API_KEY"
Response: Accessibility over the last 90 days
{
  "result": {
    "scores": [
      {
        "time": 1790216529,
        "score": 94.7
      },
      {
        "time": 1790567588,
        "score": 94.9
      },
      {
        "time": 1793646780,
        "score": 94.3
      }
    ]
  },
  "selector": "/v1/results/module-score-trend",
  "duration": 0.006
}

Request

Query parameters

  • scoreIdstringrequired

    The score, by the id Get Silktide 5 scores uses, such as accessibility.

    One ofaccessibilitycompliancecontentuser-experiencewcag-20-awcag-20-aawcag-20-aaawcag-21-awcag-21-aawcag-21-aaawcag-22-awcag-22-aawcag-22-aaa

  • 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.

      Show 2 fields
      • timeintegerrequired

        When the score was measured.

      • scorenumberrequired0 to 100

        The score then, to one decimal place.

  • 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.
200InvalidRequestscoreId is missing or is not one of its values. Its status is 400, and properties.scoreIds lists the values. The body is an error despite the status.
200InvalidArgumentperiod is not one of its values. The body is an error despite the status.
200EditionNotAvailableThe account does not have Silktide 5. Its status is 403, and instead names /v1/results/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 5 only
Cost
Free
Available since
v1.1.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.