API Reference
Blog API
Public blog listing and reading, plus admin endpoints for creating, updating, and deleting blog posts.
The Blog API serves public blog content and provides admin endpoints for content management.
List Posts
GET /api/v1/blog — Public
Get Post
GET /api/v1/blog/:slug — Public
All Posts (Admin)
GET /api/v1/blog/admin/all — Admin
Create Post (Admin)
POST /api/v1/blog — Admin
Update Post (Admin)
PATCH /api/v1/blog/:id — Admin
Delete Post (Admin)
DELETE /api/v1/blog/:id — Admin
List Blog Posts
Retrieve published blog posts with pagination.
GET /api/v1/blog — Auth: None (public)
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number |
limit | integer | 10 | Items per page |
curl "https://api.qriotag.global/api/v1/blog?page=1&limit=10"Response
{
"success": true,
"data": [
{
"id": "post_001",
"title": "5 Things You Should Tag Before Your Next Trip",
"slug": "5-things-to-tag-before-trip",
"excerpt": "Traveling soon? Here are the items most commonly lost during travel...",
"author": "QrioTag Team",
"publishedAt": "2025-05-15T09:00:00.000Z",
"coverImage": "https://cdn.qriotag.com/blog/travel-tags.jpg"
}
],
"meta": {
"total": 12,
"page": 1,
"totalPages": 2
}
}Get Blog Post
Retrieve a single published blog post by slug.
GET /api/v1/blog/:slug — Auth: None (public)
curl https://api.qriotag.global/api/v1/blog/5-things-to-tag-before-tripResponse
{
"success": true,
"data": {
"id": "post_001",
"title": "5 Things You Should Tag Before Your Next Trip",
"slug": "5-things-to-tag-before-trip",
"content": "## Introduction\n\nTraveling soon? Here are the items...",
"author": "QrioTag Team",
"publishedAt": "2025-05-15T09:00:00.000Z",
"coverImage": "https://cdn.qriotag.com/blog/travel-tags.jpg",
"tags": ["travel", "tips"]
}
}Admin Endpoints
Was this page helpful?