API docs by Redocly

Alignment Research Feed API (1.0.0)

Download OpenAPI specification:

URL: https://alignmentfeed.org

API for accessing AI alignment research articles, managing reading lists, and getting personalized recommendations.

Articles

Article listing, search, and details

List articles

List and search alignment research articles with filtering, sorting, and pagination. Results are paginated and can be filtered by source, date range, and text search.

Authorizations:
NoneBearerAuth
query Parameters
page
integer >= 1
Default: 1

Page number (1-indexed)

page_size
integer [ 1 .. 200 ]
Default: 100

Number of articles per page

sort
string
Example: sort=published_at_desc

Comma-separated list of fields to sort by. Append _desc for descending order. Valid fields: published_at, authors, source, title. Example: published_at_desc,source

filter_sources_allowlist
string
Example: filter_sources_allowlist=arxiv,lesswrong

Comma-separated list of source names to include

filter_sources_blocklist
string
Example: filter_sources_blocklist=youtube

Comma-separated list of source names to exclude

filter_title_fulltext
string

Full-text search in article titles

filter_authors_fulltext
string

Full-text search in article authors

filter_published_after
string <date-time>
Example: filter_published_after=2024-01-01T00:00:00Z

Include only articles published after this date

filter_published_before
string <date-time>
Example: filter_published_before=2024-12-31T23:59:59Z

Include only articles published before this date

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "metadata": { }
}

Get article by ID

Retrieve full details of a specific article by its hash ID.

Authorizations:
NoneBearerAuth
path Parameters
article_id
required
string

Article hash ID

Responses

Response samples

Content type
application/json
{
  • "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
  • "title": "Scaling Monosemanticity: Extracting Interpretable Features from Claude 3 Sonnet",
  • "link": "https://arxiv.org/abs/2401.12345",
  • "text_start": "We apply sparse autoencoders to extract interpretable features...",
  • "authors": "Jane Smith, John Doe",
  • "source": "arxiv",
  • "published_at": "2024-01-15T10:30:00Z",
  • "have_read": true,
  • "thumbs_up": true,
  • "thumbs_down": true
}

Get similar articles

Find articles similar to the given article using vector similarity search. Returns up to 10 similar articles.

Authorizations:
NoneBearerAuth
path Parameters
article_id
required
string

Article hash ID

query Parameters
limit
integer [ 1 .. 100 ]
Default: 10

Maximum number of similar articles to return

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "metadata": { }
}

User Interactions

Reading status and ratings (requires authentication)

List unreviewed articles

List articles the authenticated user has not yet reviewed (rated or marked as read).

Authorizations:
BearerAuth
query Parameters
page
integer >= 1
Default: 1

Page number (1-indexed)

page_size
integer [ 1 .. 200 ]
Default: 50

Number of articles per page

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "metadata": { }
}

List liked articles

List articles the authenticated user has given a thumbs up.

Authorizations:
BearerAuth
query Parameters
page
integer >= 1
Default: 1

Page number (1-indexed)

page_size
integer [ 1 .. 200 ]
Default: 50

Number of articles per page

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "metadata": { }
}

List disliked articles

List articles the authenticated user has given a thumbs down.

Authorizations:
BearerAuth
query Parameters
page
integer >= 1
Default: 1

Page number (1-indexed)

page_size
integer [ 1 .. 200 ]
Default: 50

Number of articles per page

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "metadata": { }
}

Mark article as read/unread

Mark an article as read or unread for the authenticated user.

Authorizations:
BearerAuth
path Parameters
article_id
required
string

Article hash ID

read
required
string
Enum: "true" "false"

Whether to mark as read (true) or unread (false)

Responses

Response samples

Content type
application/json
{
  • "error": "invalid page parameter: must be >= 1"
}

Set thumbs up rating

Set or clear the thumbs up rating for an article.

Authorizations:
BearerAuth
path Parameters
article_id
required
string

Article hash ID

thumbs_up
required
string
Enum: "true" "false"

Whether to set (true) or clear (false) thumbs up

Responses

Response samples

Content type
application/json
{
  • "error": "invalid page parameter: must be >= 1"
}

Set thumbs down rating

Set or clear the thumbs down rating for an article.

Authorizations:
BearerAuth
path Parameters
article_id
required
string

Article hash ID

thumbs_down
required
string
Enum: "true" "false"

Whether to set (true) or clear (false) thumbs down

Responses

Response samples

Content type
application/json
{
  • "error": "invalid page parameter: must be >= 1"
}

Recommendations

Personalized article recommendations

Get personalized recommendations

Get personalized article recommendations based on the user's rating history. Returns up to 100 recommended articles.

Authorizations:
BearerAuth
query Parameters
limit
integer [ 1 .. 100 ]
Default: 100

Maximum number of recommendations to return

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "metadata": { }
}

API Tokens

Manage API tokens (requires Auth0 authentication)

List API tokens

List all API tokens for the authenticated user. Only available with Auth0 authentication (not API tokens).

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Create API token

Create a new API token for the authenticated user. Only available with Auth0 authentication (not API tokens). Maximum 10 active tokens per user.

Authorizations:
BearerAuth
Request Body schema: application/json
optional
name
string

Optional name for the token

Responses

Request samples

Content type
application/json
{
  • "name": "My CLI token"
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "token": "user_api|a1b2c3d4e5f6...",
  • "prefix": "user_api"
}

Revoke API token

Revoke an API token by its ID. Only available with Auth0 authentication (not API tokens).

Authorizations:
BearerAuth
path Parameters
token_id
required
string <uuid>

Token UUID to revoke

Responses

Response samples

Content type
application/json
{
  • "error": "invalid page parameter: must be >= 1"
}

RSS

RSS feed

RSS feed

Get an RSS feed of alignment research articles. Supports the same filtering parameters as the articles list endpoint.

Authorizations:
None
query Parameters
page
integer >= 1
Default: 1

Page number (1-indexed)

page_size
integer [ 1 .. 200 ]
Default: 100

Number of articles per page

sort
string
Example: sort=published_at_desc

Comma-separated list of fields to sort by. Append _desc for descending order. Valid fields: published_at, authors, source, title.

filter_sources_allowlist
string

Comma-separated list of source names to include

filter_sources_blocklist
string

Comma-separated list of source names to exclude

filter_title_fulltext
string

Full-text search in article titles

filter_authors_fulltext
string

Full-text search in article authors

filter_published_after
string <date-time>

Include only articles published after this date

filter_published_before
string <date-time>

Include only articles published before this date

Responses

Response samples

Content type
application/json
{
  • "error": "invalid page parameter: must be >= 1"
}