Get related articles
Articles
Get related articles
Retrieve articles related to the specified article based on tag overlap and category matching. Returns article preview data without content.
Sorting Logic: Related articles are sorted with sophisticated relevance scoring:
- Same Category + Tag Overlap: Articles with matching category, sorted by tag overlap (descending), then publish date (descending)
- Different Category + Tag Overlap: Articles with different category but tag overlap, sorted by tag overlap (descending), then publish date (descending)
Only articles with at least one overlapping tag are returned.
Authenticated Access:
- Admin API keys: Can get related articles for any article from any account
- Account API keys: Can only get related articles for articles from the account that owns the key
Public Access (from valid domains):
- No authentication required when accessing from verified domains (*.localhost, *.suprsonic.blog, *.suprsonic.app, or verified custom domains)
- Can only get related articles for published articles from the domain-associated account
- Only returns other published articles as related content
GET
Get related articles
Usage Notes
- Related articles are determined by tag overlap with the source article
- Only published articles with a publish date in the past are returned
- Articles are sorted first by tag overlap count (descending), then by publish date (descending)
- The source article is excluded from the results
- If no related articles are found, an empty array is returned
- This endpoint only returns article preview data (no content field) for performance reasons
Authorizations
Admin API key for managing accounts and creating content
Path Parameters
The unique identifier (UUID or slug) of the article
Query Parameters
Number of related articles to return
Required range:
1 <= x <= 20