REST API
Retrieve all tags from your Simplist project with article counts and metadata.
GET
{{baseUrl}}/v1/tagsAuth required
| Property | Type | Description | Default |
|---|---|---|---|
sort | 'name' | 'createdAt' | 'articleCount' | Field to sort by | name |
order | 'asc' | 'desc' | Sort direction | asc |
limit | number | Maximum number of tags to return | - |
Returns an array of TagListItem objects with metadata about total count.
| Property | Type | Description | Default |
|---|---|---|---|
id* | string | Unique tag identifier | - |
name* | string | Tag name | - |
icon | string | null | Tag icon name (e.g., 'code', 'book') | - |
color | string | null | Hex color code (e.g., '#3B82F6') | - |
articleCount* | number | Number of articles with this tag | - |
createdAt* | string | ISO 8601 creation timestamp | - |
updatedAt* | string | ISO 8601 last update timestamp | - |
curl -X GET "https://api.simplist.blog/v1/tags" \
-H "X-API-Key: YOUR_API_KEY"
# With sorting and limit
curl -X GET "https://api.simplist.blog/v1/tags?sort=articleCount&order=desc&limit=5" \
-H "X-API-Key: YOUR_API_KEY"{
"data": [
{
"id": "tag_abc123",
"name": "JavaScript",
"icon": "code",
"color": "#F7DF1E",
"articleCount": 12,
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2025-12-09T08:15:00Z"
},
{
"id": "tag_def456",
"name": "Tutorial",
"icon": "book",
"color": "#3B82F6",
"articleCount": 8,
"createdAt": "2024-02-20T14:00:00Z",
"updatedAt": "2025-11-15T12:00:00Z"
},
{
"id": "tag_ghi789",
"name": "TypeScript",
"icon": "code",
"color": "#3178C6",
"articleCount": 5,
"createdAt": "2024-03-10T16:45:00Z",
"updatedAt": "2025-10-22T14:30:00Z"
}
],
"meta": {
"total": 3
}
}If you're using TypeScript/JavaScript, you can use the SDK instead: client.tags.list()
- GET/v1/tags/:name - Get a specific tag by name
- GET/v1/articles- Filter articles by tags
- Tags SDK Reference - SDK documentation for tags
- Articles API - Using tags to filter articles