REST API
Retrieve a specific tag by its name with article count and metadata.
GET
{{baseUrl}}/v1/tags/:nameAuth required
| Property | Type | Description | Default |
|---|---|---|---|
name* | string | The tag name (URL-encoded if contains special characters) | - |
Returns a single TagListItem object.
| 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/JavaScript" \
-H "X-API-Key: YOUR_API_KEY"For tags with spaces or special characters, URL-encode the name:
# Tag name: "Machine Learning"
curl -X GET "https://api.simplist.blog/v1/tags/Machine%20Learning" \
-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"
}
}{
"error": "Not Found",
"message": "Tag not found",
"statusCode": 404
}If you're using TypeScript/JavaScript, you can use the SDK instead: client.tags.get()
- GET/v1/tags - List all tags
- GET/v1/articles - Filter articles by this tag
- Tags SDK Reference - SDK documentation for tags
- Articles API - Using tags to filter articles