Content

List blog posts

Returns published blog posts, newest first.

No API key required.

get/v1/blog

Request

  • Base URL: https://api.gunspec.io
  • URL: https://api.gunspec.io/v1/blog
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

pageinteger

Page number, from 1 to 10,000

per_pageinteger

Items per page (max 100)

categorystring

Filter by post category

Response

List blog posts

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": [
    {
      "id": "post_01hbar",
      "slug": "complete-guide-firearm-calibers-for-developers",
      "title": "What is a firearms specification API",
      "summary": "What the catalog holds, and how to call it.",
      "heroImage": "guides/what-is-a-firearms-api.webp",
      "heroAlt": "Studio render of the AK-47, left side",
      "category": "guides",
      "status": "published",
      "postedAt": "2026-08-01T00:00:00.000Z",
      "createdAt": "2026-08-01 09:12:44",
      "updatedAt": "2026-08-02 10:01:07",
      "author": {
        "name": "Sacha Roussakis-Notter",
        "handle": "sacha-roussakis-notter",
        "avatarStyle": "bottts",
        "avatarSeed": "9f2c4a1b7e30d5c6"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "limit": 20,
    "total": 42,
    "totalPages": 3
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.