Skip to main content
GET
List Insights

Authorizations

Authorization
string
header
required

A bearer token obtained through one of the two flows below.

Headers

Accept-Language
enum<string>

The language to answer in: specificationLabels, translatedDescription, facet and label names, the content pages, and every other translated word in the answer. Read on every request, whatever the endpoint. One we do not have falls back to English rather than failing.

Available options:
en,
nl,
de,
es,
fr,
it,
pt,
fi,
pl

Query Parameters

include
enum<string>

author, tags, or both.

Available options:
author,
tags
filter[q]
string

Typed text, for an autocomplete — the other half of the website's search bar, which offers pages and Insights together. Same index and same relevance threshold as /v1/filter-pages, newest first among what matched. blocks is null, as in any list. Three is what the website shows.

While searching, sort and the other filters are not applied. If the index cannot be reached the answer is 503 search_unavailable, never an empty page.

filter[slug]
string
filter[tag]
string

Everything filed under one word, by the tag's slug.

filter[type]
string

default for something written, video or podcast for something to play. More than one, comma separated: podcast,video is the website's "watch and listen" row.

filter[author]
string

Everything one person wrote, by the author's slug.

true (or 1) for only the ones we are putting in front of people at the moment, false (or 0) for the rest.

sort
enum<string>

publishedAt, updatedAt or name, either way round. The default is -publishedAt. Ignored, not refused, while filter[q] is searching: a search is newest first among what matched.

Available options:
publishedAt,
-publishedAt,
updatedAt,
-updatedAt,
name,
-name
page[number]
integer
default:1
Required range: x >= 1
page[size]
integer
default:25
Required range: 1 <= x <= 50

Response

A page of articles.

data
object[]
required
included
object[]

Present when the answer is a page.

meta
object

page when the answer is a page: from, to, perPage and hasMore for a cursor (from and to are cursors, not numbers), or currentPage, from, lastPage, perPage, to and total for numbered pages. Some lists add their own beside it, such as statusCounts, unread or facets.