Download OpenAPI specification:
API for accessing AI alignment research articles, managing reading lists, and getting personalized recommendations.
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.
| page | integer >= 1 Default: 1 Page number (1-indexed) |
| page_size | integer [ 1 .. 200 ] Default: 50 Number of articles per page |
| sort | string Example: sort=published_at_desc Comma-separated list of fields to sort by. Append |
| 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_category | string Enum: "Interpretability" "Safety Techniques" "Governance & Policy" "Deception & Misalignment" "AI Capabilities & Behavior" "Risks & Strategy" "Forecasting" "AI & Society" "Field Building" "Other" Example: filter_category=Interpretability Filter by LLM-assigned category. Current categories are listed in the schema enum; more may be added over time. |
| 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 |
{- "data": [
- {
- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity",
- "source": "arxiv"
}
], - "metadata": { }
}Retrieve full details of a specific article by its hash ID.
| article_id required | string Article hash ID |
{- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity: Extracting Interpretable Features from Claude 3 Sonnet",
- "text_start": "We apply sparse autoencoders to extract interpretable features...",
- "authors": "Jane Smith, John Doe",
- "source": "arxiv",
- "published_at": "2024-01-15T10:30:00Z",
- "summary": "This paper introduces a method for extracting interpretable features from large language models.",
- "key_points": [
- "Introduces a new interpretability method",
- "Demonstrates scaling to large models"
], - "category": "Interpretability",
}Find articles similar to the given article using vector similarity search. Always returns up to 10 similar articles.
| article_id required | string Article hash ID |
{- "data": [
- {
- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity",
- "source": "arxiv"
}
], - "metadata": { }
}Search for articles semantically similar to the given text.
Search text and optional parameters
| text required | string <= 102400 characters Text to find semantically similar articles for |
| limit | integer [ 1 .. 100 ] Default: 10 Maximum number of articles to return |
{- "text": "Interpretability methods for large language models",
- "limit": 10
}{- "data": [
- {
- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity",
- "source": "arxiv"
}
], - "metadata": { }
}List articles the authenticated user has not yet reviewed (rated or marked as read).
| page | integer >= 1 Default: 1 Page number (1-indexed) |
| page_size | integer [ 1 .. 200 ] Default: 50 Number of articles per page |
{- "data": [
- {
- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity",
- "source": "arxiv"
}
], - "metadata": { }
}List articles the authenticated user has given a thumbs up.
| page | integer >= 1 Default: 1 Page number (1-indexed) |
| page_size | integer [ 1 .. 200 ] Default: 50 Number of articles per page |
{- "data": [
- {
- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity",
- "source": "arxiv"
}
], - "metadata": { }
}List articles the authenticated user has given a thumbs down.
| page | integer >= 1 Default: 1 Page number (1-indexed) |
| page_size | integer [ 1 .. 200 ] Default: 50 Number of articles per page |
{- "data": [
- {
- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity",
- "source": "arxiv"
}
], - "metadata": { }
}Mark an article as read or unread for the authenticated user.
| article_id required | string Article hash ID |
| read required | string Enum: "true" "false" Whether to mark as read (true) or unread (false) |
{- "error": "invalid page parameter: must be >= 1"
}Set or clear the thumbs up rating for an article.
| article_id required | string Article hash ID |
| thumbs_up required | string Enum: "true" "false" Whether to set (true) or clear (false) thumbs up |
{- "error": "invalid page parameter: must be >= 1"
}Set or clear the thumbs down rating for an article.
| article_id required | string Article hash ID |
| thumbs_down required | string Enum: "true" "false" Whether to set (true) or clear (false) thumbs down |
{- "error": "invalid page parameter: must be >= 1"
}Get personalized article recommendations based on the user's rating history. Always returns up to 100 recommended articles.
{- "data": [
- {
- "hash_id": "8f14e45fceea167a5a36dedd4bea2543",
- "title": "Scaling Monosemanticity",
- "source": "arxiv"
}
], - "metadata": { }
}List all API tokens for the authenticated user. Only available with Auth0 authentication (not API tokens).
{- "data": [
- {
- "id": "550e8400-e29b-41d4-a716-446655440000",
- "prefix": "user_api",
- "name": "My CLI token",
- "created_at": "2024-06-01T12:00:00Z",
- "revoked": false
}
]
}Create a new API token for the authenticated user. Only available with Auth0 authentication (not API tokens). Maximum 10 active tokens per user.
Optional token configuration (name)
| name | string Optional name for the token |
{- "name": "My CLI token"
}{- "id": "550e8400-e29b-41d4-a716-446655440000",
- "token": "user_api|a1b2c3d4e5f6...",
- "prefix": "user_api"
}Revoke an API token by its ID. Only available with Auth0 authentication (not API tokens).
| token_id required | string <uuid> Token UUID to revoke |
{- "error": "invalid page parameter: must be >= 1"
}Get an RSS feed of alignment research articles. Supports the same filtering parameters as the articles list endpoint.
| page | integer >= 1 Default: 1 Page number (1-indexed) |
| page_size | integer [ 1 .. 200 ] Default: 50 Number of articles per page |
| sort | string Example: sort=published_at_desc Comma-separated list of fields to sort by. Append |
| 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_category | string Enum: "Interpretability" "Safety Techniques" "Governance & Policy" "Deception & Misalignment" "AI Capabilities & Behavior" "Risks & Strategy" "Forecasting" "AI & Society" "Field Building" "Other" Example: filter_category=Interpretability Filter by LLM-assigned category. Current categories are listed in the schema enum; more may be added over time. |
| 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 |
{- "error": "invalid page parameter: must be >= 1"
}